Snowflake Semantic Views

ワンタイムセットアップ

• 新しいターミナルを開き、snow --help を実行して Snowflake CLI のインストールを確認します。
• Snowflake CLI がインストールされていない、またはユーザーがインストールできない場合は、https://docs.snowflake.com/en/developer-guide/snowflake-cli/installation/installation にアクセスするよう案内します。
• https://docs.snowflake.com/en/developer-guide/snowflake-cli/connecting/configure-connections#add-a-connection に従い、snow connection add で Snowflake 接続を設定します。
• すべての検証と実行ステップで設定済みの接続を使用します。

各セマンティックビューリクエストのワークフロー

1. ターゲットデータベース、スキーマ、ロール、ウェアハウス、および最終的なセマンティックビュー名を確認します。
2. モデルがスタースキーマ(正規化されたディメンションを持つファクト)に従っていることを確認します。
3. 公式構文を使用してセマンティックビューDDLをドラフトします:
   • https://docs.snowflake.com/en/sql-reference/sql/create-semantic-view
4. 各ディメンション、ファクト、メトリクスのシノニムとコメントを入力します:
   • 最初に Snowflake テーブル/ビュー/カラムコメントを読みます(推奨ソース):
     • https://docs.snowflake.com/en/sql-reference/sql/comment
   • コメントまたはシノニムが不足している場合は、ユーザーに対して、コメント作成が可能か、テキストを提供する意向があるか、または承認のための提案をドラフトすべきかを確認します。
5. DISTINCT と LIMIT(最大 1000 行)を使用した SELECT ステートメントで、ファクトテーブルとディメンションテーブル間の関係を発見し、カラムデータ型を特定し、カラムのより意味のあるコメントとシノニムを作成します。
6. 同じデータベースとスキーマを保持しながら、一時的な検証名(__tmp_validate を追加するなど)を作成します。
7. 最終化する前に、Snowflake CLI 経由で DDL を Snowflake に送信して常に検証します:
   • 設定済み接続でsnow sqlを使用してステートメントを実行します。
   • フラグがバージョンによって異なる場合は、snow sql --help を確認し、そこに表示されている接続オプションを使用します。
8. 検証が失敗した場合は、DDL を反復し、成功するまで検証ステップを再実行します。
9. 実際のセマンティックビュー名を使用して最終 DDL(作成または変更)を適用します。
10. 最終セマンティックビューに対してサンプルクエリを実行し、期待通りに動作することを確認します。ここで確認できるように、異なる SQL 構文を持っています: https://docs.snowflake.com/en/user-guide/views-semantic/querying#querying-a-semantic-view 例:

SELECT * FROM SEMANTIC_VIEW(
    my_semview_name
    DIMENSIONS customer.customer_market_segment
    METRICS orders.order_average_value
)
ORDER BY customer_market_segment;

11. 検証中に作成された一時的なセマンティックビューをクリーンアップします。

シノニムとコメント(必須)

• セマンティックビュー構文を使用してシノニムとコメントを記述します:

WITH SYNONYMS [ = ] ( 'synonym' [ , ... ] )
COMMENT = 'comment_about_dim_fact_or_metric'

• シノニムは情報提供のみと見なし、ディメンション、ファクト、メトリクスの参照に他の場所で使用しないでください。
• Snowflake コメントをシノニムとコメントの推奨される最初のソースとして使用します:
  • https://docs.snowflake.com/en/sql-reference/sql/comment
• Snowflake コメントが不足している場合は、ユーザーに対して、コメント作成が可能か、テキストを提供する意向があるか、または承認のための提案をドラフトすべきかを確認します。
• ユーザーの承認なしにシノニムやコメントを作成しないでください。

検証パターン(必須)

• 検証をスキップしないでください。最終版として提示する前に、常に Snowflake CLI で DDL を Snowflake に対して実行します。
• 実際のビューを上書きしないようにするために、検証では一時的な名前を使用することをお勧めします。

CLI 検証の例(テンプレート)

# プレースホルダーを実際の値に置き換えてください。
snow sql -q "<CREATE OR ALTER SEMANTIC VIEW ...>" --connection <connection_name>

お使いのバージョンで CLI が異なる接続フラグを使用している場合は、次を実行します:

snow sql --help

注釈

• インストールと接続設定はワンタイムステップとして扱いますが、最初の検証の前に完了していることを確認します。
• 最終的なセマンティックビュー定義は、名前を除いて検証済みの一時的な定義と同じに保ちます。
• シノニムやコメントは省略しないでください。構文では任意ですが、完全性のために必須と見なします。