コラボレーション仕様¶
高レベルのコラボレーションを定義します。仕様では、どの分析実行者が招待されるか、各分析実行者について、どのデータとテンプレートにアクセスして実行できるかを定義します。ここにリストされているテンプレートやデータサービスについては、コラボレーション仕様に配置する前に登録する必要があります。
所有者はINITIALIZEを呼び出してこの仕様を送信します。
スキーマ:
api_version使用するコラボレーション API のバージョン。
2.0.0である必要があります。spec_type仕様タイプ識別子。
collaborationである必要があります。name: collaboration_nameこのコラボレーションのユーザーにわかりやすい名前。作成者のアカウントで一意であり、:doc:`Snowflake識別子ルール </sql-reference/identifiers-syntax>`（最大75文字）に従うようにする必要があります。
- ``version``（オプション）
このコラボレーションのバージョン識別子（最大20文字）。Snowflake識別子ルール に従う必要があります。使用に適した形式は*YYYY_MM_DD_V#*です。例:
2025_10_22_V1。- :samp:`description: {collaboration_description}`（オプション）
コラボレーターが読むための、コラボレーションに関する人間が読める説明（最大1,000文字）。
owner: owner_alias``collaborator_identifier_aliases``で定義されているコラボレーション所有者のエイリアス。
collaborator_identifier_aliasesコラボレーターのエイリアスの データ共有アカウント識別子 へのマッピング。コラボレーションに参加できるのは、ここにリストされているユーザーのみです。データ共有アカウントの識別子を直接使用するのではなく、ここで定義されたエイリアスを使用してすべてのコラボレーターを参照します。このコラボレーションで一意であり、:doc:`Snowflake識別子ルール</sql-reference/identifiers-syntax>`（最大25文字）に従うようにする必要があります。
analysis_runnersこのコラボレーションで分析を実行できる人について説明します。各分析実行者に対して、一意のエイリアスによってキーが設定されます。少なくとも1つのアカウントがこのコラボレーションで分析を実行できるようにする必要があります。
<analysis_runner_alias>このコラボレーションで分析を実行できるアカウントのエイリアス。エイリアスは
collaborator_identifier_aliasesリストで定義されています。data_providersこの分析実行者がアクセスできるデータのデータプロバイダー。各プロバイダーに対して、
collaborator_identifier_aliasesで定義されているエイリアスによってキーが設定されます。data_offerings分析実行者がアクセスできるこのデータプロバイダーのデータサービスのリスト、またはデータサービスを後で追加できるようにするためにプレースホルダーとして使用する空の配列``[]``。各データサービスは、IDによって参照され、データプロバイダーがREGISTER_DATA_OFFERINGを呼び出すときに生成されます。
- ``templates``（オプション）
この分析実行者が使用できるテンプレート。各テンプレートはその ID によって参照されます。初期仕様ではこれを省略することができます。また、コラボレーションが作成された後も、この分析実行者とテンプレートを共有することができます。
- ``activation_destinations``（オプション）
分析結果のアクティベーション設定を定義します。
- ``snowflake_collaborators``（オプション）
アクティブ化された分析結果を受信できるコラボレーターのリスト。この仕様の
collaborator_identifier_aliasesリストにあるエイリアスを使用します。ここにリストされているすべてのコラボレーターは、アクティベーションの実装 に記載されている権限を付与されている必要があります。