lookml-view

手順

1. ファイル構成

• 標準ビュー：views/[datasource_name]/[view_name].view.lkml
• 拡張ビュー：views/[datasource_name]/[view_name]_ext.view.lkml
• リファインメント：views/[datasource_name]/[view_name]_rfn.view.lkml
• NDT：views/[datasource_name]/[view_name]_ndt.view.lkml
• SDT：views/[datasource_name]/[view_name]_sdt.view.lkml

2. 基本標準

1. sql_table_name：標準ビューでは必須です。デフォルト値は不安定なため、明示的に指定してください。
2. 主キー：
   • ファイル内で最初に定義するディメンションである必要があります。
   • primary_key: yes を指定する必要があります。
3. リファインメント：元のファイルを変更せずに既存のビューをリファインするには、ビュー名の前に + を付けます（例：view: +users）。
4. 拡張：他のビューのロジックを再利用するには、extends を使用します。

3. ベストプラクティス

• 命名：ビュー名とファイル名には snake_case を使用します。
• 説明：目的の説明に役立つ場合は、ビュー自体に説明を追加します（例：「地域別に集計された日次アクティブユーザー数」）。
• 出力形式：ファイルの末尾に改行があることを確認します。

4. 関連スキル

• lookml-refinements：include、リファインメント（+）、およびハブ＆スポークパターンのロジック。

例

基本ビュー

view: users {
  sql_table_name: `project.dataset.users` ;;

  dimension: user_id {
    primary_key: yes
    type: number
    sql: ${TABLE}.id ;;
    group_label: "IDs"
    description: "Unique internal user ID."
  }

  dimension: email {
    type: string
    sql: ${TABLE}.email ;;
    description: "User's email address."
  }
}

拡張ビュー

include: "/views/base/users.view"

view: users_extended {
  extends: [users]

  dimension: lifetime_value {
    type: number
    sql: ${TABLE}.ltv ;;
    description: "Total lifetime value of the user."
  }
}

リファインメント（レイヤリング）

include: "/views/users.view"

view: +users {
  label: "All Users (Refined)"
  
  dimension: email {
    # Adding a description to an existing field
    description: "Primary contact email."
  }
}

関連スキル

• 派生テーブル：標準（SDT）およびネイティブ（NDT）の派生テーブルのパターン／マテリアライズ。