alias

Utilisation

view: view_name {
  dimension: field_name {
    alias: [old_field_name, old_field_name, ...]
  }
}

Hiérarchie Afficher le fichier view Type de champ alias

Types de champs possibles Dimension, groupe de dimensions, mesure, filtre, paramètre Acceptation Liste de noms de champs entre crochets

Définition

Le paramètre alias permet de définir d'autres noms pour un champ, susceptibles de figurer dans l'URL d'une requête. Cela peut être utile lorsque les noms de champs d'un modèle changent, mais que vous avez des URL de requêtes préexistantes que vous souhaitez conserver.

L'exemple suivant montre comment remplacer un champ nommé count par le nouveau nom number_of_items, sans interrompre les requêtes existantes qui font référence à count.

measure: number_of_items {  # the new name
  alias: [count]            # the old name
  type: count
}

Vous pouvez également fournir plusieurs alias, au cas où vous renommeriez un champ plusieurs fois. Par exemple, si vous avez renommé le champ number_of_items de l'exemple précédent en number_of_order_items, vous pouvez utiliser le code suivant :

measure: number_of_order_items {   # the new name
  alias: [count, number_of_items]  # the old names
  type: count
}

Pour utiliser alias avec un groupe de dimensions, modifiez le nom du groupe de dimensions, et non chaque champ du groupe de dimensions. Par exemple, pour renommer le groupe de dimensions created_date en order_date :

dimension_group: order_date {  # the new name
  alias: [created_date]        # the old name
  type: time
  timeframes: [time, hour, date, week, month, year, hour_of_day, day_of_week, month_num, raw]
  sql: ${TABLE}.created_at ;;
}

Notez que alias n'est utilisé que pour que les URL continuent de fonctionner. Il ne doit pas être utilisé pour référencer des champs dans LookML. Exemple :

measure: number_of_items {
  alias: [count]
  type: count
}
measure: percent_items_sold {
  sql: ${sold_items} / ${number_of_items} ;; # will work because there
  type: number                               # is a measure named number_of_items
}
measure: percent_items_sold {
  sql: ${sold_items} / ${count} ;; # will NOT work because you
  type: number                     # should not use alias names in LookML
}

Bon à savoir

Si vous alias un champ avec un nom déjà utilisé par un autre champ, le validateur LookML renvoie une erreur.