分析仕様¶
使用するテンプレート、テンプレートに渡すテーブル、テンプレートで使用される変数値など、分析実行者が分析を実行するために必要なすべての情報を指定します。データをクエリするために自由形式の SQL を使用しない場合、分析を実行する分析実行者は、この仕様を使用してテンプレートと入力データを定義します。
スキーマ:
api_version使用するコラボレーション API のバージョン。
2.0.0である必要があります。spec_type仕様タイプ識別子。
analysisである必要があります。template: template_idこの分析に使用するテンプレートのID。これはテンプレート名ではなく、テンプレートの登録時に取得したテンプレートIDであことが必要です。
- ``name``（オプション）
この分析の一意でユーザーにわかりやすい名前。最大75文字で、Snowflakeデータクリーンルームアカウント内で一意である Snowflake識別子ルール に従う必要があります。
- ``version``（オプション）
この分析仕様のバージョン識別子（最大20文字）。Snowflake識別子ルール に従い、この分析名のアカウント内で一意であることが必要です。使用に適した形式は*YYYY_MM_DD_V#*です。例:
2025_10_22_V1。- ``description``（オプション）
この分析によって行われる内容についての概略的な説明（最大1,000文字）。
- ``template_configuration``（オプション）
指定したテンプレートを実行するときに使用される値。
- ``view_mappings``（オプション）
共有されているデータ提供機能の引数名からテンプレートビュー名へのマッピング。
- ``local_view_mappings``（オプション）
プライベートデータセットのローカルテンプレートビュー名への引数名のマッピング。
- ``my_tables``（オプション）
my_tableテンプレート変数を入力するテーブル名のリスト。これは LINK_LOCAL_DATA_OFFERING を呼び出すことでリンクしたプライベートデータセットでのみ利用できます。各エントリの形式は、collaborator_alias.data_offering_ID.dataset_aliasです。argument_name: view_name引数名からローカルテンプレートビュー名へのカスタムマッピング（それぞれ最大255文字）。
- ``arguments``（オプション）
キーと値のペアとしてのテンプレート引数。引数の値は、テンプレートの要件に応じて、文字列、数値、ブール値、配列、またはオブジェクトのいずれかです。
- ``activation``（アクティベーションテンプレートに必須）
アクティベーションテンプレートを実行する際に必須のアクティベーション固有の構成。
snowflake_collaboratorアクティベーション先のコラボレーターのエイリアス（最大25文字）。コラボレーション仕様の
collaborator_identifier_aliasesセクションで定義されているエイリアスと一致するとともに、コラボレーターがactivation_destinationsセクションにリストされている必要があります。segment_nameこのアクティベーションの一意のセグメント名（最大255文字）。アクティベーション結果の識別と追跡に使用されます。Snowflake識別子ルール に従う必要があります。