Afficher les paramètres

Une vue représente une table de données dans Looker, qu'elle soit native de votre base de données ou qu'elle ait été créée à l'aide de la fonctionnalité de table dérivée de Looker. Les vues sont généralement déclarées dans des fichiers de vue, avec une vue par fichier.

Chaque vue contient des définitions de champ, chacune correspondant généralement à une colonne de la table sous-jacente ou à un calcul dans Looker. Ces champs sont décrits dans la documentation de référence sur les champs, la documentation de référence sur les types de dimensions et la documentation de référence sur les types de mesures.

Il existe également un certain nombre de paramètres au niveau de la vue, qui sont décrits sur cette page.

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 nombreuses options spécifiques, la valeur par défaut est listée en premier.

## STRUCTURAL PARAMETERS

include:"filename_or_pattern"
## Possibly more include 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

view: view_name {
  extension: required
  extends: [view_name, view_name, ...]

  (dimension | dimension_group | measure | filter):field_name{
    # Desired field parameters (described on Field Parameters page)
  }
  # Possibly more field declarations

  set: set_name{
    fields:[field_or_set, field_or_set, ...]
  }
  # Possibly more set declarations

  drill_fields: [field_or_set, field_or_set, ...]

  # DISPLAY PARAMETERS

  label: "desired label"
  fields_hidden_by_default: yes | no

  # FILTER PARAMETERS

  suggestions: yes | no

  # QUERY PARAMETERS

  autogenerate_primary_keys: yes | no
  required_access_grants: [access_grant_name, access_grant_name, ...]
  sql_table_name: table_name ;;

  # DERIVED TABLE PARAMETERS

  derived_table: {
    cluster_keys: ["column_name", "column_name", ...]
    create_process: {
      sql_step:SQL query ;;
    }
    datagroup_trigger: datagroup_name
    distribution: "column_name"
    distribution_style: all | even
    explore_source: explore_name {
      # Desired subparameters (described on explore_source page)
    }
    increment_key: "column_name"
    increment_offset: N
    indexes: ["column_name", "column_name", ...]
    interval_trigger: "N (seconds | minutes | hours)"
    materialized_view: yes | no
    partition_keys: ["column_name", "column_name", ...]
    persist_for: "N (seconds | minutes | hours)"
    publish_as_db_view: yes | no
    sortkeys: ["column_name","column_name", ...]
    sql: SQL query ;;
    sql_create: {
      SQL query ;;
    }
    sql_trigger_value: SQL query ;;
    table_compression: GZIP | SNAPPY
    table_format: PARQUET | ORC | AVRO | JSON | TEXTFILE
  }
}

## REFINEMENT PARAMETERS
view: +view_name {
  final: yes
}

Définition des paramètres

Nom du paramètre	Description
Paramètres de structure
drill_fields (pour la vue)	Spécifie la liste par défaut des champs affichés lorsque l'utilisateur clique sur une mesure définie dans la vue.
extends (pour la vue)	Spécifie les vues qui seront étendues par cette vue.
extension (pour la vue)	Indique que la vue nécessite une extension et ne peut pas être exposée aux utilisateurs.
include	Ajoute des fichiers à une vue.
test	Crée un test de données pour vérifier la logique de votre modèle. Les paramètres de 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 des sous-paramètres explore_source et assert.
set	Définit un ensemble de dimensions et de mesures à utiliser dans d'autres paramètres.
view	Crée une vue.
Paramètres d'affichage
label (pour la vue)	Indique comment le nom de la vue s'affiche dans le sélecteur de champs.
fields_hidden_by_default	Ajouté dans la version 21.12 Lorsque la valeur est définie sur yes, tous les champs de la vue sont masqués par défaut. Utilisez le hidden: no paramètre sur un champ pour l'afficher.
Paramètres de filtre
suggestions (pour la vue)	Active ou désactive les suggestions pour toutes les dimensions d'une vue.
Paramètres de requête
autogenerate_primary_keys (pour la vue)	Active ou désactive la génération automatique de clés primaires.
required_access_grants (pour la vue)	Limite l'accès à la vue aux seuls utilisateurs dont les valeurs d'attribut utilisateur correspondent aux droits d'accès.
sql_table_name (pour la vue)	Change la table SQL de base d'une vue.
Paramètres de table dérivée
cluster_keys	Indique qu'une table PDT sera ordonnée en clusters en fonction d'un ou plusieurs champs dans BigQuery. Prise en charge ajoutée pour cluster_keys sur Snowflake.
create_process	Spécifie une séquence ordonnée d'étapes pour créer une table PDT dans un dialecte de base de données exigeant des commandes LDD personnalisées. Ce paramètre comporte le sous-paramètre sql_step.
datagroup_trigger	Désigne le groupe de données à utiliser pour les règles de régénération des tables PDT.
derived_table	Base une vue sur une table dérivée.
distribution	Définit la clé de distribution d'une table PDT intégrée dans Redshift ou Aster.
distribution_style	Définit le style de distribution d'une table PDT intégrée dans Redshift.
explore_source	Définit une table dérivée native basée sur une exploration.
increment_key	Ajouté dans la version 21.4 Transforme la table dérivée en table PDT incrémentielle. increment_key spécifie l'incrément de temps pour lequel de nouvelles données doivent être interrogées et ajoutées à la table PDT.
increment_offset	Ajouté dans la version 21.4 Utilisé conjointement avec le paramètre increment_key pour les tables PDT incrémentielles. increment_offset spécifie le nombre de périodes passées (selon la granularité de la clé d'incrémentation) qui sont régénérées pour représenter des données tardives.
interval_trigger	Ajouté dans la version 21.20 Le interval_trigger spécifie une planification de régénération pour une table dérivée persistante, au format "N (seconds | minutes | hours)"
materialized_view	Ajouté dans la version 21.10 L'instruction materialized_view: yes crée une vue matérialisée dans votre base de données pour une table dérivée.
indexes	Définit les index d'une table PDT intégrée dans une base de données classique (MySQL, Postgres, etc.) ou une clé de tri entrelacée Redshift.
partition_keys	Indique qu'une table PDT sera partitionnée en fonction d'un ou plusieurs champs dans Presto, ou d'un unique champ date/heure dans BigQuery.
persist_for (pour derived_table)	Définit le délai maximal avant lequel une table PDT doit être régénérée.
publish_as_db_view	L'instruction publish_as_db_view: yes crée une vue de base de données stable pour la table PDT afin de permettre l'interrogation de la table en dehors de Looker.
sortkeys	Définit les clés de tri d'une table PDT intégrée dans Redshift.
sql (pour derived_table)	Déclare la requête SQL d'une table dérivée.
sql_create	Définit une instruction SQL CREATE pour créer une table PDT dans un dialecte de base de données exigeant des commandes LDD personnalisées.
sql_trigger_value	Indique la condition déclenchant la régénération d'une table PDT.
table_compression	Spécifie la compression de table à utiliser pour une table PDT dans Amazon Athena.
table_format	Spécifie le format de table à utiliser pour une table PDT dans Amazon Athena.
Paramètres d'affinage
view: +view_name	Ajoute un signe plus (+) devant le nom d'une vue existante pour affiner la vue existante. Pour en savoir plus et découvrir des cas d'utilisation, consultez la page de documentation sur les affinages LookML.
final	Indique que l'affinage actuel est l'affinage final autorisé pour la vue. Pour en savoir plus et découvrir des cas d'utilisation, consultez la page de documentation sur les affinages LookML.
Paramètres à éviter
distkey	Supprimé dans la version 3.26 Remplacé par distribution
view_label	À éviter dans la version 4.4 Remplacé par label