Afficher les paramètres

Une vue représente un tableau de données dans Looker, qu'il soit natif de votre base de données ou qu'il ait été créé à l'aide de la fonctionnalité 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 champs, qui correspondent 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.

Cette page décrit également un certain nombre de paramètres au niveau de la vue.

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

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 l'affichage)	Spécifie la liste par défaut des champs affichés lorsque l'utilisateur clique sur les mesures définies dans la vue.
extends (pour l'affichage)	Spécifie les vues qui seront étendues par cette vue.
extension (pour l'affichage)	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 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 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 l'affichage)	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 Lorsqu'il est défini sur yes, tous les champs de la vue sont masqués par défaut. Utilisez le paramètre hidden: no sur un champ pour l'afficher.
Paramètres de filtre
suggestions (pour l'affichage)	Active ou désactive les suggestions pour toutes les dimensions d'une vue.
Paramètres de requête
autogenerate_primary_keys (pour l'affichage)	Active ou désactive la génération automatique de clés primaires
required_access_grants (pour l'affichage)	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 l'affichage)	Change la table SQL de base d'une vue.
Paramètres des tables dérivées
cluster_keys	Indique qu'une table PDT sera ordonnée en clusters en fonction d'un ou plusieurs champs dans BigQuery. Ajout de la prise en charge de cluster_keys sur Snowflake
create_process	Spécifie une séquence ordonnée d'étapes pour créer une 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 PDT incrémentielle. increment_key indique l'incrément de temps pour lequel de nouvelles données doivent être interrogées et ajoutées à la 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 indique le nombre de périodes précédentes (selon la granularité de la clé d'incrémentation) qui sont régénérées pour tenir compte des données tardives.
interval_trigger	Ajouté dans la version 21.20 interval_trigger spécifie un calendrier de reconstruction 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 sur 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 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 y ajouter un affinement. Pour en savoir plus et découvrir des cas d'utilisation, consultez la page de documentation Affiner le LookML.
final	Indique que l'affinage actuel est le dernier autorisé pour la vue. Pour en savoir plus et découvrir des cas d'utilisation, consultez la page de documentation Affiner le LookML.
Paramètres à éviter
distkey	Supprimé 3.26 Remplacé par distribution
view_label	Éviter la section 4.4 Remplacé par label