Paramètres du modèle

Un fichier de modèle spécifie une connexion de base de données, définit l'ensemble des explorations qui utilisent cette connexion et définit les relations entre les explorations et les autres vues. Contrairement aux autres éléments LookML, un modèle n'est pas déclaré avec un paramètre "model" spécifique. Au lieu de cela, un développeur LookML définit un modèle en créant un fichier de projet LookML avec l'extension de fichier .model.lkml. Le nom du modèle est extrait du nom de fichier.

Le nom d'un modèle doit être unique dans tous les projets de votre instance. Si votre instance contient deux fichiers .model.lkml portant le même nom, vous risquez de rencontrer des erreurs, telles que des erreurs de configuration de modèle sur la page Projets LookML et des erreurs de rendu pour les erreurs de tableau de bord LookML, car les tableaux de bord LookML utilisent le nom du modèle dans leur format d'URL (<hostname>/dashboard/model_name::<dashboard_name>).

Vous pouvez utiliser le programme de validation LookML pour vérifier si des noms de modèles sont en double dans votre instance. Toutefois, même si le validateur LookML détecte des noms de modèles en double dans votre instance, vous pouvez toujours transférer votre code en production. Par conséquent, assurez-vous de corriger toute erreur de nom de modèle en double avant de déployer votre projet LookML en production.

Un fichier de modèle contient généralement des déclarations explore, ainsi qu'un certain nombre de paramètres au niveau du modèle.

Cette page contient des liens vers les paramètres LookML au niveau du modèle. Elles sont généralement écrites en haut du fichier de modèle et ne doivent pas être imbriquées dans d'autres paramètres.

Exemple d'utilisation

Pointez sur le nom d'un paramètre pour afficher une brève description. Cliquez sur un paramètre pour accéder à sa page de référence. Lorsqu'un paramètre peut être défini sur l'une des options spécifiques, la valeur par défaut est indiquée en premier.

## STRUCTURAL PARAMETERS
include:"filename_or_pattern"
## Possibly more include declarations

explore: explore_name {
  # Desired explore parameters (described on Explore Parameters page)
}
## Possibly more explore declarations

access_grant: access_grant_name{
  user_attribute: user_attribute_name
  allowed_values: ["value_1", "value_2", ...]
}
## Possibly more access_grant declarations

test: test_name{
  explore_source: explore_name {
    # Desired subparameters (described on test page)
  }
  assert: assert_statement {
    expression:Looker expression ;;
  }
  # Possibly more assert declarations
}
## Possibly more test declarations

## DISPLAY PARAMETERS
label: "desired label"

## FILTER PARAMETERS
case_sensitive: yes | no

## QUERY PARAMETERS
connection: "connection_name"
datagroup: datagroup_name{
  label: "desired label"
  description: "desired description"
  max_cache_age: "N (minutes | hours | days)"
  sql_trigger: SQL query ;;
}
## Possibly more datagroup declarations
fiscal_month_offset: N
persist_for: "N (seconds | minutes | hours)"
persist_with: datagroup_name
week_start_day: monday | tuesday | wednesday | thursday | friday | saturday | sunday

## VISUALIZATION AND FORMATTING PARAMETERS
map_layer: map_name{
  extents_json_url: "URL to JSON extents file"
  feature_key: "Name of TopoJSON object"
  file: "TopoJSON or GeoJSON filename" # or use the url subparameter
  format: topojson | vector_tile_region
  label: "desired label"
  max_zoom_level: number indicating max zoom
  min_zoom_level: number indicating min zoom
  projection: Preferred geographic projection
  property_key: "TopoJSON property"
  property_label_key: "Label for TopoJSON property"
  url: "URL that contains map file" # or use the file subparameter
}
## Possibly more map layer declarations

named_value_format: desired_name {
  value_format: "excel formatting string"
  strict_value_format: yes | no
 }
## Possibly more named value format declarations

Définition des paramètres

Nom du paramètre Description
Paramètres de structure
access_grant Crée un droit d'accès qui limite l'accès aux structures LookML aux seuls utilisateurs auxquels une valeur d'attribut utilisateur approuvée est attribuée. Ce paramètre comporte les sous-paramètres user_attribute et allowed_values.
explore Présente une vue dans le menu Exploration. Pour en savoir plus sur les explorations et leurs paramètres, consultez la page Référence des paramètres d'exploration.
include Ajoute des fichiers à un modèle
test Crée un test de données pour vérifier la logique de votre modèle. Les paramètres du projet incluent une option permettant d'exiger des tests de données. Lorsque cette option est activée pour un projet, les développeurs de ce dernier doivent effectuer des tests de données avant de déployer leurs modifications en production. Ce paramètre comporte les sous-paramètres explore_source et assert.
Paramètres d'affichage
label (pour le modèle) Modifie l'apparence d'un modèle dans le menu Exploration.
Paramètres de filtre
case_sensitive (pour le modèle) Indique si les filtres d'un modèle sont sensibles à la casse.
Paramètres de requête
connection Modifie la connexion de base de données d'un modèle.
datagroup Crée des règles de mise en cache des groupes de données pour un modèle. Ce paramètre comporte les sous-paramètres label, description, max_cache_age et sql_trigger.
fiscal_month_offset Indique le mois de début d'un exercice (si ce dernier est différent de l'année civile).
persist_for (pour le modèle) Modifie les paramètres de mise en cache d'un modèle.
persist_with (pour le modèle) Désigne le groupe de données à utiliser pour les règles de mise en cache d'un modèle.
week_start_day Indique le jour de la semaine par lequel les dimensions hebdomadaires doivent commencer.
Paramètres de visualisation et de mise en forme
map_layer (pour le modèle) Crée des cartes personnalisées à utiliser avec map_layer_name
named_value_format Crée un format de valeur personnalisé utilisable avec value_format_name. Ce paramètre comporte les sous-paramètres value_format et strict_value_format.
Paramètres à éviter
scoping Suppression de la version 3.52 Plus nécessaire
template Suppression de la section 3.30 Plus nécessaire