Snowflake Data Clean Rooms Collaboration API¶

例¶

2つのCollaboration API ロールを作成する例を次に示します。1つはコラボレーションを作成して参加できるロール、もう1つはコラボレーションでリソースを表示して分析を実行できる（ただし、コラボレーションの参加や変更はできない）ロールです。

-- Create a role that can create and join collaborations.
USE ROLE ACCOUNTADMIN;
CREATE ROLE COLLABORATION_CREATOR_ROLE;
GRANT USAGE ON WAREHOUSE APP_WH TO COLLABORATION_CREATOR_ROLE;
GRANT APPLY ROW ACCESS POLICY ON ACCOUNT TO ROLE COLLABORATION_CREATOR_ROLE;
GRANT CREATE APPLICATION ON ACCOUNT TO ROLE COLLABORATION_CREATOR_ROLE;
GRANT CREATE DATABASE ON ACCOUNT TO ROLE COLLABORATION_CREATOR_ROLE;
GRANT CREATE LISTING ON ACCOUNT TO ROLE COLLABORATION_CREATOR_ROLE;
GRANT CREATE SHARE ON ACCOUNT TO ROLE COLLABORATION_CREATOR_ROLE;
GRANT IMPORT SHARE ON ACCOUNT TO ROLE COLLABORATION_CREATOR_ROLE;
GRANT MANAGE SHARE TARGET ON ACCOUNT TO ROLE COLLABORATION_CREATOR_ROLE;
CALL SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.ADMIN.GRANT_PRIVILEGE_ON_ACCOUNT_TO_ROLE('CREATE COLLABORATION', 'COLLABORATION_CREATOR_ROLE');
GRANT ROLE COLLABORATION_CREATOR_ROLE TO USER george_washington;

-- Create a role that can run analyses on a specific collaboration.
USE ROLE COLLABORATION_CREATOR_ROLE;
CREATE ROLE ANALYST_ROLE;

CALL SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.ADMIN.GRANT_PRIVILEGE_ON_OBJECT_TO_ROLE(
  'RUN',
  'COLLABORATION',
  $collaboration_name,
  'ANALYST_ROLE'
);

-- Also grant READ, which gives permission to read the resources available to use in a collaboration.
CALL SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.ADMIN.GRANT_PRIVILEGE_ON_OBJECT_TO_ROLE(
  'READ',
  'COLLABORATION',
  $collaboration_name,
  'ANALYST_ROLE'
);

GRANT ROLE ANALYST_ROLE to USER alexander_hamilton;

構文¶

REGISTER_TEMPLATE( ['<registry_name>' ,] <template_spec> )

引数¶

registry_name （オプション）

このテンプレートを登録する カスタムレジストリ の名前。指定しない場合、テンプレートはデフォルトのアカウントレジストリに登録されます。

template_spec

YAML 形式の :ref:`テンプレート定義 <label-dcr_collaboration_template_yaml>`（文字列）。

戻り値¶

コラボレーション仕様で使用するテンプレート ID。

例¶

デフォルトのレジストリにテンプレートを登録します。

CALL SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.REGISTRY.REGISTER_TEMPLATE(
  $$
  api_version: 2.0.0
  spec_type: template
  name: my_test_template
  version: 2026_01_12_V1
  type: sql_analysis
  description: A test template
  template:
    SELECT * FROM IDENTIFIER({{ source_table[0] }}) LIMIT 10;
$$);

カスタムレジストリにテンプレートを登録します。

CALL SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.REGISTRY.REGISTER_TEMPLATE(
  'my_custom_registry',
  $$
  api_version: 2.0.0
  spec_type: template
  name: my_test_template
  version: 2026_01_12_V1
  type: sql_analysis
  description: A test template
  template:
    SELECT * FROM IDENTIFIER({{ source_table[0] }}) LIMIT 10;
$$);

アクセス要件¶

SAMOOHA_APP_ROLEロールを使用していない場合は、以下のプロシージャを呼び出して権限を付与されたロールを使用する必要があります。

デフォルトのレジストリにオブジェクトを登録するには：

• GRANT_PRIVILEGE_ON_ACCOUNT_TO_ROLE('REGISTER TEMPLATE', 'role name')

カスタムレジストリにアイテムを登録するには：

• 自分で作成したカスタムレジストリに対する読み取りおよび書き込みの権限があります。

• 他のユーザーが作成したカスタムレジストリにアクセスするには、:samp:`GRANT_PRIVILEGE_ON_OBJECT_TO_ROLE('REGISTER', 'REGISTRY', 'MY_REGISTRY', '{role name}')`が必要です。

構文¶

VIEW_REGISTERED_TEMPLATES( [ '<registry_name>' ] )

引数¶

registry_name （オプション）

テンプレートをリストする:doc:`カスタムレジストリ</user-guide/cleanrooms/v2/registries>`の名前。指定しない場合、デフォルトのアカウントレジストリからテンプレートを一覧表示します。

戻り値¶

このアカウントで登録したすべてのテンプレートの詳細をリストしたテーブル。

例¶

CALL SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.REGISTRY.VIEW_REGISTERED_TEMPLATES();

アクセス要件¶

SAMOOHA_APP_ROLEロールを使用していない場合、以下のプロシージャのいずれかを呼び出して権限を付与されたロールを使用する必要があります。

デフォルトのレジストリのアイテムを表示するには：

• GRANT_PRIVILEGE_ON_ACCOUNT_TO_ROLE('VIEW REGISTERED TEMPLATES', 'role name')

• GRANT_PRIVILEGE_ON_ACCOUNT_TO_ROLE('CREATE COLLABORATION', 'role name')

• GRANT_PRIVILEGE_ON_ACCOUNT_TO_ROLE('JOIN COLLABORATION', 'role name')

カスタムレジストリのアイテムを表示するには：

• 自分で作成したカスタムレジストリに対する読み取りおよび書き込みの権限があります。

• 他のユーザーが作成したカスタムレジストリにアクセスするには、:samp:`GRANT_PRIVILEGE_ON_OBJECT_TO_ROLE('READ', 'REGISTRY', 'MY_REGISTRY', '{role name}')`が必要です。

構文¶

ADD_TEMPLATE_REQUEST( <collaboration_name>, <template_id>, <share_with> )

引数¶

collaboration_name

テンプレートを追加するコラボレーションの名前。

template_id

コラボレーションに追加するテンプレートの ID。この値を取得するには、テンプレートを登録します。

share_with

このテンプレートを共有する分析実行者の*エイリアス*の配列。このテンプレートに関連付けられている他のコラボレーターに加えて、ここにリストされているコラボレーターが追加されます。ここにリストされているすべてのコラボレーターは分析実行者である必要があります。そうでない場合、このプロシージャは失敗し、このテンプレートは誰とも共有されません。

戻り値¶

文字列の成功メッセージ。

例¶

-- Ask to add the template only for Collaborator3 in this collaboration.
CALL SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.COLLABORATION.ADD_TEMPLATE_REQUEST(
  $collaboration_name,
  $template_alias,
  ['Collaborator3']
);

アクセス要件¶

SAMOOHA_APP_ROLEロールを使用していない場合は、以下のプロシージャを呼び出して権限を付与されたロールを使用する必要があります。

• GRANT_PRIVILEGE_ON_OBJECT_TO_ROLE('UPDATE', 'COLLABORATION', 'collaboration name', 'role name')

• 次のいずれかの権限です。

  • :samp:`GRANT_PRIVILEGE_ON_ACCOUNT_TO_ROLE('CREATE COLLABORATION', '{role name}')`に加えて、ロールに手動で付与する必要があるすべての追加のアカウントレベルの権限。

  • :samp:`GRANT_PRIVILEGE_ON_ACCOUNT_TO_ROLE('JOIN COLLABORATION', '{role name}')`に加えて、ロールに手動で付与する必要があるすべての追加のアカウントレベルの権限。

• テンプレートがカスタムレジストリにある場合は、:samp:`GRANT_PRIVILEGE_ON_OBJECT_TO_ROLE( 'READ', '{registry name}', '{role name}')`も必要です。

構文¶

REMOVE_TEMPLATE( <collaboration_name>, <template_id>, <remove_for> )

引数¶

collaboration_name

テンプレートを削除するコラボレーションの名前。

template_id

コラボレーションから削除するテンプレートの ID。

remove_for

このコラボレーションで、このテンプレートを表示または使用できなくなった分析実行者の1つ以上の*エイリアス*の配列。

戻り値¶

文字列の成功メッセージ。コラボレーターのテンプレートが削除されたかどうかを確認するには、コラボレーション仕様を表示します。

例¶

-- Prevent collaborator_1234 from using the specified template
CALL SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.COLLABORATION.REMOVE_TEMPLATE(
  $collaboration_name,
  $template_id,
  ['collaborator_1234']
);

アクセス要件¶

SAMOOHA_APP_ROLEロールを使用していない場合は、以下のプロシージャを呼び出して権限を付与されたロールを使用する必要があります。

• GRANT_PRIVILEGE_ON_OBJECT_TO_ROLE('UPDATE', 'COLLABORATION', 'collaboration name', 'role name')

• 次のいずれかの権限です。

  • :samp:`GRANT_PRIVILEGE_ON_ACCOUNT_TO_ROLE('CREATE COLLABORATION', '{role name}')`に加えて、ロールに手動で付与する必要があるすべての追加のアカウントレベルの権限。

  • :samp:`GRANT_PRIVILEGE_ON_ACCOUNT_TO_ROLE('JOIN COLLABORATION', '{role name}')`に加えて、ロールに手動で付与する必要があるすべての追加のアカウントレベルの権限。

• テンプレートがカスタムレジストリにある場合、またはカスタムレジストリのコード仕様を参照している場合は、:samp:`GRANT_PRIVILEGE_ON_OBJECT_TO_ROLE( 'READ', '{registry name}', '{role name}')`も必要です。

構文¶

VIEW_TEMPLATES( <collaboration_name> )

引数¶

collaboration_name

コラボレーションの名前。テンプレートをリストする前に、このコラボレーションを確認または参加する必要があります。

戻り値¶

自分で登録したテンプレートなど、このコラボレーションで実行できるテンプレートに関する情報を一覧表示したテーブル。情報にはテンプレート ID（テンプレートの実行に使用）、テンプレート本文、パラメーター、作成者、実行可能者が含まれます。

例¶

CALL SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.COLLABORATION.VIEW_TEMPLATES(
  $collaboration_name
);

アクセス要件¶

SAMOOHA_APP_ROLE ロールを使用していない場合、以下のプロシージャのいずれかを呼び出して権限を付与されたロールを使用する必要があります。

• GRANT_PRIVILEGE_ON_OBJECT_TO_ROLE('VIEW TEMPLATES', 'COLLABORATION', 'collaboration name', 'role name')

• GRANT_PRIVILEGE_ON_OBJECT_TO_ROLE('READ', 'COLLABORATION', 'collaboration name', 'role name')

• GRANT_PRIVILEGE_ON_ACCOUNT_TO_ROLE('CREATE COLLABORATION', 'role name')

• GRANT_PRIVILEGE_ON_ACCOUNT_TO_ROLE('JOIN COLLABORATION', 'role name')

構文¶

ENABLE_TEMPLATE_AUTO_APPROVAL( <collaboration_name> )

引数¶

collaboration_name

コラボレーションの名前。

戻り値¶

文字列の成功メッセージ。

例¶

CALL SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.COLLABORATION.ENABLE_TEMPLATE_AUTO_APPROVAL(
  $collaboration_name
);

アクセス要件¶

SAMOOHA_APP_ROLE ロールを使用していない場合、以下のプロシージャのいずれかを呼び出して権限を付与されたロールを使用する必要があります。

• GRANT_PRIVILEGE_ON_OBJECT_TO_ROLE('MANAGE TEMPLATE AUTO APPROVAL', 'COLLABORATION', 'collaboration name', 'role name')

• GRANT_PRIVILEGE_ON_OBJECT_TO_ROLE('UPDATE', 'COLLABORATION', 'collaboration name', 'role name')

• GRANT_PRIVILEGE_ON_ACCOUNT_TO_ROLE('CREATE COLLABORATION', 'role name')

• GRANT_PRIVILEGE_ON_ACCOUNT_TO_ROLE('JOIN COLLABORATION', 'role name')

構文¶

DISABLE_TEMPLATE_AUTO_APPROVAL( <collaboration_name> )

引数¶

collaboration_name

コラボレーションの名前。

戻り値¶

文字列の成功メッセージ。

例¶

CALL SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.COLLABORATION.DISABLE_TEMPLATE_AUTO_APPROVAL(
  $collaboration_name
);

アクセス要件¶

SAMOOHA_APP_ROLE ロールを使用していない場合、以下のプロシージャのいずれかを呼び出して権限を付与されたロールを使用する必要があります。

• GRANT_PRIVILEGE_ON_OBJECT_TO_ROLE('MANAGE TEMPLATE AUTO APPROVAL', 'COLLABORATION', 'collaboration name', 'role name')

• GRANT_PRIVILEGE_ON_OBJECT_TO_ROLE('UPDATE', 'COLLABORATION', 'collaboration name', 'role name')

• GRANT_PRIVILEGE_ON_ACCOUNT_TO_ROLE('CREATE COLLABORATION', 'role name')

• GRANT_PRIVILEGE_ON_ACCOUNT_TO_ROLE('JOIN COLLABORATION', 'role name')

構文¶

REGISTER_DATA_OFFERING( ['<registry_name>' ,] <data_offering_spec> )

引数¶

registry_name （オプション）

このデータ提供を登録する カスタムレジストリ の名前。指定しない場合、データ提供はデフォルトのアカウントレジストリに登録されます。

data_offering_spec

このデータ提供を説明する YAML 形式の データ提供定義。

戻り値¶

コラボレーションの data_offerings.id フィールドに使用されるデータ提供 ID。

例¶

デフォルトのレジストリにデータ提供を登録します。

CALL SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.REGISTRY.REGISTER_DATA_OFFERING(
    $$
    api_version: 2.0.0
    spec_type: data_offering
    version: v1
    name: customers
    datasets:
     - alias: customers_1
       data_object_fqn: SAMOOHA_SAMPLE_DATABASE.DEMO.CUSTOMERS
       allowed_analyses: template_only
       schema_and_template_policies:
         hashed_email:
           category: join_custom
         status:
           category: passthrough
    $$
  );

カスタムレジストリにデータ提供を登録します。

CALL SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.REGISTRY.REGISTER_DATA_OFFERING(
    'my_custom_registry',
    $$
    api_version: 2.0.0
    spec_type: data_offering
    version: v1
    name: customers
    datasets:
     - alias: customers_1
       data_object_fqn: SAMOOHA_SAMPLE_DATABASE.DEMO.CUSTOMERS
       allowed_analyses: template_only
       schema_and_template_policies:
         hashed_email:
           category: join_custom
         status:
           category: passthrough
    $$
  );

アクセス要件¶

SAMOOHA_APP_ROLEロールを使用していない場合は、以下のプロシージャを呼び出して権限を付与されたロールを使用する必要があります。

デフォルトのレジストリにデータ提供を登録するには：

• GRANT_PRIVILEGE_ON_ACCOUNT_TO_ROLE('REGISTER DATA OFFERING', 'role name')

カスタムレジストリにアイテムを登録するには：

• 自分で作成したカスタムレジストリに対する読み取りおよび書き込みの権限があります。

• 他のユーザーが作成したカスタムレジストリにアクセスするには、:samp:`GRANT_PRIVILEGE_ON_OBJECT_TO_ROLE('REGISTER', 'REGISTRY', 'MY_REGISTRY', '{role name}')`が必要です。

構文¶

LINK_DATA_OFFERING( <collaboration_name>, <data_offering_id>, <share_with> )

引数¶

collaboration_name

コラボレーションの名前。

data_offering_id

登録時に生成された、共有するデータセットの ID。リンクできるようにするには、``VIEW_DATA_OFFERINGS``または``VIEW_REGISTERED_DATA_OFFERINGS``を呼び出すときにデータ提供が表示されている必要があります。

share_with

このデータセットを共有する分析実行者の文字列エイリアスの配列。ここにリストされているコラボレーターは、このデータ提供に関連づけられている他のコラボレーターに追加されます。ここにリストされているすべてのコラボレーターはあなたがデータプロバイダーとなっている分析実行者である必要があります。そうでないと、このプロシージャは失敗し、データは誰とも共有されません。

戻り値¶

文字列の成功メッセージ。

例¶

この例では、指定したコラボレーションで指定されたデータ提供を使用できるよう、コラボレーター alice に許可します。

CALL SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.COLLABORATION.LINK_DATA_OFFERING(
  $collaboration_name,
  $my_data_id,
  ['alice']
);

アクセス要件¶

SAMOOHA_APP_ROLEロールを使用していない場合は、以下のプロシージャを呼び出して権限を付与されたロールを使用する必要があります。

• GRANT_PRIVILEGE_ON_OBJECT_TO_ROLE('UPDATE', 'COLLABORATION', 'collaboration name', 'role name')

• 次のいずれかの権限です。

  • :samp:`GRANT_PRIVILEGE_ON_ACCOUNT_TO_ROLE('CREATE COLLABORATION', '{role name}')`に加えて、ロールに手動で付与する必要があるすべての追加のアカウントレベルの権限。

  • :samp:`GRANT_PRIVILEGE_ON_ACCOUNT_TO_ROLE('JOIN COLLABORATION', '{role name}')`に加えて、ロールに手動で付与する必要があるすべての追加のアカウントレベルの権限。

• データ提供がカスタムレジストリにある場合は、:samp:`GRANT_PRIVILEGE_ON_OBJECT_TO_ROLE( 'READ', '{registry name}', '{role name}')`も必要です。

構文¶

UNLINK_DATA_OFFERING( <collaboration_name>, <data_offering_id>, <remove_for> )

引数¶

collaboration_name

コラボレーションの名前。

data_offering_id

登録時に生成された、リンクを解除するデータセットの ID。

remove_for

アクセスを削除する1人以上の分析実行者の文字列エイリアスの配列。ここにリストされているすべてのコラボレーターは、現在このデータ提供にアクセスできる分析実行者である必要があります。

戻り値¶

文字列の成功メッセージ。

例¶

-- Remove data offering access for specific analysis runners in this collaboration.
CALL SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.COLLABORATION.UNLINK_DATA_OFFERING(
  $collaboration_name,
  $data_offering_id,
  ['AnalysisRunner_1', 'AnalysisRunner_2']
);

アクセス要件¶

SAMOOHA_APP_ROLE ロールを使用していない場合、以下のプロシージャのいずれかを呼び出して権限を付与されたロールを使用する必要があります。

• GRANT_PRIVILEGE_ON_OBJECT_TO_ROLE('UPDATE', 'COLLABORATION', 'collaboration name', 'role name')

• GRANT_PRIVILEGE_ON_ACCOUNT_TO_ROLE('CREATE COLLABORATION', 'role name')

• GRANT_PRIVILEGE_ON_ACCOUNT_TO_ROLE('JOIN COLLABORATION', 'role name')

構文¶

LINK_LOCAL_DATA_OFFERING( <collaboration_name>, <data_offering_id> )

引数¶

collaboration_name

コラボレーションの名前。

data_offering_id

登録時に生成された、データセットの ID。VIEW_REGISTERED_DATA_OFFERINGS および ``VIEW_DATA_OFFERINGS``（自分にのみ）でも表示できます。

戻り値¶

文字列の成功メッセージ。

例¶

この例では、現在のアカウントのみが使用できるよう登録済みデータ提供をリンクし、他のコラボレーターには公開しません。

CALL SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.COLLABORATION.LINK_LOCAL_DATA_OFFERING(
  $collaboration_name,
  $my_private_data_offering_id
);

アクセス要件¶

SAMOOHA_APP_ROLE ロールを使用していない場合、以下のプロシージャのいずれかを呼び出して権限を付与されたロールを使用する必要があります。

• GRANT_PRIVILEGE_ON_OBJECT_TO_ROLE('UPDATE', 'COLLABORATION', 'collaboration name', 'role name')

• GRANT_PRIVILEGE_ON_ACCOUNT_TO_ROLE('CREATE COLLABORATION', 'role name')

• GRANT_PRIVILEGE_ON_ACCOUNT_TO_ROLE('JOIN COLLABORATION', 'role name')

構文¶

UNLINK_LOCAL_DATA_OFFERING( <collaboration_name>, <data_offering_id> )

引数¶

collaboration_name

コラボレーションの名前。

data_offering_id

登録時に生成された、リンクを解除するデータセットの ID。VIEW_REGISTERED_DATA_OFFERINGS および ``VIEW_DATA_OFFERINGS``（自分にのみ）でも表示できます。

戻り値¶

文字列の成功メッセージ。

例¶

-- Unlink a local data offering from a collaboration.
CALL SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.COLLABORATION.UNLINK_LOCAL_DATA_OFFERING(
  $collaboration_name,
  $my_private_data_offering_id
);

アクセス要件¶

SAMOOHA_APP_ROLE ロールを使用していない場合、以下のプロシージャのいずれかを呼び出して権限を付与されたロールを使用する必要があります。

• GRANT_PRIVILEGE_ON_OBJECT_TO_ROLE('UPDATE', 'COLLABORATION', 'collaboration name', 'role name')

• GRANT_PRIVILEGE_ON_ACCOUNT_TO_ROLE('CREATE COLLABORATION', 'role name')

• GRANT_PRIVILEGE_ON_ACCOUNT_TO_ROLE('JOIN COLLABORATION', 'role name')

構文¶

VIEW_REGISTERED_DATA_OFFERINGS( [ '<registry_name>' ] )

引数¶

registry_name （オプション）

データ提供をリストする:doc:`カスタムレジストリ</user-guide/cleanrooms/v2/registries>`の名前。指定しない場合、デフォルトのアカウントレジストリからデータ提供を一覧表示します。

戻り値¶

このアカウントを使用して登録したすべてのデータ提供を一覧表示したテーブル。

例¶

CALL SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.REGISTRY.VIEW_REGISTERED_DATA_OFFERINGS();

アクセス要件¶

SAMOOHA_APP_ROLEロールを使用していない場合、以下のプロシージャのいずれかを呼び出して権限を付与されたロールを使用する必要があります。

デフォルトのレジストリのアイテムを表示するには：

• GRANT_PRIVILEGE_ON_ACCOUNT_TO_ROLE('VIEW REGISTERED DATA OFFERINGS', 'role name')

• GRANT_PRIVILEGE_ON_ACCOUNT_TO_ROLE('CREATE COLLABORATION', 'role name')

• GRANT_PRIVILEGE_ON_ACCOUNT_TO_ROLE('JOIN COLLABORATION', 'role name')

カスタムレジストリのアイテムを表示するには：

• 自分で作成したカスタムレジストリに対する読み取りおよび書き込みの権限があります。

• 他のユーザーが作成したカスタムレジストリにアクセスするには、:samp:`GRANT_PRIVILEGE_ON_OBJECT_TO_ROLE('READ', 'REGISTRY', 'MY_REGISTRY', '{role name}')`が必要です。

構文¶

VIEW_DATA_OFFERINGS( <collaboration_name> )

引数¶

collaboration_name

探索するコラボレーションの名前。

戻り値¶

指定されたコラボレーションにおけるすべてのデータ提供に関する情報。テーブルには、次の列が含まれています。

• FREEFORM_SQL_COLUMN_POLICIES:このコラボレーション内にあるすべての 自由形式の列ポリシー の、ポリシータイプをキーとした JSON 表現。

• FREEFORM_SQL_VIEW_NAME:自由形式の SQL クエリで使用される完全修飾テーブル名（データセットが自由形式の SQL クエリをサポートしている場合）。データセットが自由形式の SQL クエリを提供しない場合、このセルは空です。

• SHARE_WITH:分析でデータを使用できる人。この値が LOCAL の場合は、データをホストする人物以外、どのコラボレーターとも共有されないローカルデータセットです。

• TEMPLATE_VIEW_NAME:COLLABORATION.RUN を呼び出す際にテンプレートで使用される完全修飾テーブル名。

例¶

CALL SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.COLLABORATION.VIEW_DATA_OFFERINGS(
  $collaboration_name
);

アクセス要件¶

SAMOOHA_APP_ROLE ロールを使用していない場合、以下のプロシージャのいずれかを呼び出して権限を付与されたロールを使用する必要があります。

• GRANT_PRIVILEGE_ON_OBJECT_TO_ROLE('VIEW DATA OFFERINGS', 'COLLABORATION', 'collaboration name', 'role name')

• GRANT_PRIVILEGE_ON_OBJECT_TO_ROLE('READ', 'COLLABORATION', 'collaboration name', 'role name')

• GRANT_PRIVILEGE_ON_ACCOUNT_TO_ROLE('CREATE COLLABORATION', 'role name')

• GRANT_PRIVILEGE_ON_ACCOUNT_TO_ROLE('JOIN COLLABORATION', 'role name')

構文¶

VIEW_UPDATE_REQUESTS( <collaboration_name> )

引数¶

collaboration_name

コラボレーションの名前。

戻り値¶

このコラボレーションで送信された更新リクエストのテーブル。以下の情報が含まれます。

• ID：リクエストの ID。リクエストの承認または拒否に使用します。

• TYPE:リクエストのタイプ。次の値がサポートされています。

  • 「テンプレート追加」

• STATUS:リクエストの現在のステータス。次のステータスが報告されます。

  • REJECTED:コラボレーションの参加者がこのリクエストを拒否しました。

  • PENDING:リクエストは承認または拒否待ちです。

  • AWAITING_PARTNER_APPROVAL:あなたはリクエストを承認しましたが、まだ1人以上の他のコラボレーターがそのリクエストを承認する必要があります。

  • APPROVED:すべての必要な承認者がリクエストを承認し、変更がコラボレーションに適用されました。

• APPROVAL_LOG:リクエストのすべての承認と拒否のログ。リクエストが拒否された場合、拒否理由もここに記載されます。

• DETAILS:テンプレートの名前、説明、共有者（「テンプレート追加」リクエストの場合）など、リクエストタイプに固有の詳細。

• SPEC:更新されるリソースの詳細。たとえば、「テンプレート追加」リクエストの場合は、テンプレート仕様。

• UPDATED_ON:このリクエスト（たとえば、承認や拒否）に対して最後のアクションが行われたときのタイムスタンプ。

例¶

CALL SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.COLLABORATION.VIEW_UPDATE_REQUESTS(
  $collaboration_name
);

アクセス要件¶

SAMOOHA_APP_ROLE ロールを使用していない場合、以下のプロシージャのいずれかを呼び出して権限を付与されたロールを使用する必要があります。

• GRANT_PRIVILEGE_ON_OBJECT_TO_ROLE('UPDATE', 'COLLABORATION', 'collaboration name', 'role name')

• GRANT_PRIVILEGE_ON_OBJECT_TO_ROLE('READ', 'COLLABORATION', 'collaboration name', 'role name')

• GRANT_PRIVILEGE_ON_ACCOUNT_TO_ROLE('CREATE COLLABORATION', 'role name')

• GRANT_PRIVILEGE_ON_ACCOUNT_TO_ROLE('JOIN COLLABORATION', 'role name')

構文¶

APPROVE_UPDATE_REQUEST( <collaboration_name>, <request_id> )

引数¶

collaboration_name

コラボレーションの名前。

request_id

リクエストの ID。

戻り値¶

文字列の成功メッセージ。

例¶

CALL SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.COLLABORATION.APPROVE_UPDATE_REQUEST(
  $collaboration_name,
  $request_id
);

アクセス要件¶

SAMOOHA_APP_ROLE ロールを使用していない場合、以下のプロシージャのいずれかを呼び出して権限を付与されたロールを使用する必要があります。

• GRANT_PRIVILEGE_ON_OBJECT_TO_ROLE('MANAGE UPDATE REQUEST', 'COLLABORATION', 'collaboration name', 'role name')

• GRANT_PRIVILEGE_ON_OBJECT_TO_ROLE('UPDATE', 'COLLABORATION', 'collaboration name', 'role name')

• GRANT_PRIVILEGE_ON_ACCOUNT_TO_ROLE('CREATE COLLABORATION', 'role name')

• GRANT_PRIVILEGE_ON_ACCOUNT_TO_ROLE('JOIN COLLABORATION', 'role name')

構文¶

REJECT_UPDATE_REQUEST( <collaboration_name>, <request_id>, <reason> )

引数¶

collaboration_name

コラボレーションの名前。

request_id

リクエストの ID。

reason

リクエストが拒否された理由の人間が読める説明。この引数は必須ですが、空の文字列を送信することができます。

戻り値¶

文字列の成功メッセージ。

例¶

CALL SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.COLLABORATION.REJECT_UPDATE_REQUEST(
  $collaboration_name,
  'request_1324f934457',
  'Needs more cowbell'
);

アクセス要件¶

SAMOOHA_APP_ROLE ロールを使用していない場合、以下のプロシージャのいずれかを呼び出して権限を付与されたロールを使用する必要があります。

• GRANT_PRIVILEGE_ON_OBJECT_TO_ROLE('MANAGE UPDATE REQUEST', 'COLLABORATION', 'collaboration name', 'role name')

• GRANT_PRIVILEGE_ON_OBJECT_TO_ROLE('UPDATE', 'COLLABORATION', 'collaboration name', 'role name')

• GRANT_PRIVILEGE_ON_ACCOUNT_TO_ROLE('CREATE COLLABORATION', 'role name')

• GRANT_PRIVILEGE_ON_ACCOUNT_TO_ROLE('JOIN COLLABORATION', 'role name')

構文¶

INITIALIZE( <collaboration_spec> [, '<auto_join_warehouse>'] )

引数¶

collaboration_spec

YAML 形式の :ref:`コラボレーション定義 <label-dcr_collaboration_invitation_yaml>`（文字列）。

auto_join_warehouse （オプション）

有効なSnowflake識別子としてウェアハウス名を指定する文字列。指定した場合、このウェアハウスを使用してコラボレーションの作成と参加が行われます。指定しない場合は、現在のウェアハウスを使用してコラボレーションが作成されます。その後、JOINを呼び出してコラボレーションに参加する必要があります。XSウェアハウスをお勧めします。

戻り値¶

以下の列を持つテーブル。

• COLLABORATION_NAME:コラボレーションの名前。コラボレーションを指定する必要があるプロシージャで使用します。

• MESSAGE:初期化リクエストに関する情報。

例¶

次の例では、Aliceが所有者で、Bobから提供されたデータを使って分析を実行できるコラボレーションを作成します。

CALL SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.COLLABORATION.INITIALIZE(
  $$
  api_version: 2.0.0
  spec_type: collaboration
  name: basic_collaboration
  owner: alice
  collaborator_identifier_aliases:
    alice: corp_id.account_id
    bob: corp2_id.account2_id
  analysis_runners:
    alice:
      data_providers:
        bob:
          data_offerings:
          - id: bob_data_v1
      templates:
      - id: alice_test_template_2026_01_12_V1
  $$,
  'APP_WH'
);

アクセス要件¶

SAMOOHA_APP_ROLE ロールを使用していない場合は、次のプロシージャを呼び出して権限を付与されたロールを使用する必要があります。

• GRANT_PRIVILEGE_ON_ACCOUNT_TO_ROLE('CREATE COLLABORATION', 'role name')

  ``auto-join-warehouse``パラメーターを指定し、SAMOOHA_APP_ROLE以外のロールを使用する場合、そのロールにはEXECUTETASKアカウントレベルの権限も付与されている必要があります。

追加の必要なロール権限については、GRANT_PRIVILEGE_ON_ACCOUNT_TO_ROLE を参照してください。

構文¶

TEARDOWN( <collaboration_name> )

引数¶

collaboration_name

削除するコラボレーションの名前。

戻り値¶

文字列の成功メッセージ。

例¶

-- Start the process.
CALL SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.COLLABORATION.TEARDOWN($collaboration_name);

-- Call until it returns LOCAL_DROP_PENDING.
CALL SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.COLLABORATION.GET_STATUS($collaboration_name);

-- Final call.
CALL SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.COLLABORATION.TEARDOWN($collaboration_name);

アクセス要件¶

SAMOOHA_APP_ROLE ロールを使用していない場合、以下のプロシージャのいずれかを呼び出して権限を付与されたロールを使用する必要があります。

• GRANT_PRIVILEGE_ON_ACCOUNT_TO_ROLE('CREATE COLLABORATION', 'role name')

• GRANT_PRIVILEGE_ON_ACCOUNT_TO_ROLE('JOIN COLLABORATION', 'role name')

追加の必要なロール権限については、GRANT_PRIVILEGE_ON_ACCOUNT_TO_ROLE を参照してください。

構文¶

GET_STATUS( <collaboration_name> )

引数¶

collaboration_name

ステータスを確認するコラボレーションの名前。コラボレーションのリストを表示するには、COLLABORATION.VIEW_COLLABORATIONS を呼び出します。GET_STATUS を呼び出すには、コラボレーションに招待されているか、参加している必要があります。

戻り値¶

指定されたコラボレーションの全コラボレーターの最新の参加試行の詳細を示すテーブル。テーブルには、次の列が含まれています。

• UPDATED_ON:システムからステータスが報告されたときのタイムスタンプ。

• COLLABORATOR_ACCOUNT:このコラボレーターのデータ共有アカウント ID。

• COLLABORATOR_NAME:コラボレーション仕様で宣言されている、コラボレーターのエイリアス。

• COLLABORATOR_ROLES:このコラボレーターの実際のロールと潜在的なロール。値は、owner、data_provider、analysis_runner などです。

• STATUS:更新時のステータス。以下の値がサポートされており、指定されたコラボレーションにおける名前付きコラボレーターのステータスが表示されます。

  • CREATING:コラボレーションの作成が開始されました。

  • CREATE_FAILED:コラボレーションの作成に失敗しました。

  • CREATED:コラボレーションが作成され、操作する準備ができました。

  • INSTALLING:アプリケーションパッケージをインストールし、レビューのためにコラボレーションの詳細を準備します。

  • IN_REVIEW：コラボレーションはレビュー中です。

  • INSTALLATION_FAILED:インストールに失敗しました。アプリケーションパッケージはインストールされておらず、レビューできません。

  • INVITED:参加者が招待されました。

  • REVIEWING:コラボレーションを現在確認中。

  • JOINING:参加プロセスが開始されました。

  • JOIN_FAILED:参加プロセスに失敗しました。

  • JOINED：コラボレーションに正常に参加しました。コラボレーションの使用を開始できます。

  • INVITE_STARTED:招待プロセスが開始されました。

  • INVITE_ACCEPTED:招待が受け入れられました。

  • LEAVING:終了プロセスが開始されました。

  • LEAVE_FAILED:終了処理が失敗しました。

  • LEFT:コラボレーションを正常に終了しました。

  • LOCAL_DROP_PENDING:コラボレーションを削除または終了するリクエストを正常に行いました。TEARDOWN または LEAVE を再び呼び出してプロセスを完了してください。

  • DROPPING:削除プロセスが開始されました。

  • DROPPED:正常に削除されました。

  • DROP_FAILED:削除プロセスが失敗しました。

例¶

CALL SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.COLLABORATION.GET_STATUS(
  $collaboration_name
);

アクセス要件¶

SAMOOHA_APP_ROLE ロールを使用していない場合、以下のプロシージャのいずれかを呼び出して権限を付与されたロールを使用する必要があります。

• GRANT_PRIVILEGE_ON_OBJECT_TO_ROLE('READ', 'COLLABORATION', 'collaboration name', 'role name')

• GRANT_PRIVILEGE_ON_ACCOUNT_TO_ROLE('CREATE COLLABORATION', 'role name')

• GRANT_PRIVILEGE_ON_ACCOUNT_TO_ROLE('JOIN COLLABORATION', 'role name')

構文¶

ENABLE_EXTERNAL_TABLE_ANALYSIS_FOR_COLLABORATION( <collaboration_name> )

引数¶

collaboration_name

コラボレーションの名前。

戻り値¶

文字列の成功メッセージ。

例¶

CALL SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.ADMIN.ENABLE_EXTERNAL_TABLE_ANALYSIS_FOR_COLLABORATION(
  $collaboration_name
);

アクセス要件¶

SAMOOHA_APP_ROLE ロールを使用していない場合は、MANAGEFIREWALLCONFIGURATION 権限が付与されたロールを使用してこのプロシージャを呼び出す必要があります。

構文¶

VIEW_COLLABORATIONS()

引数¶

なし

戻り値¶

アクセス可能なすべてのコラボレーションの詳細を一覧表示したテーブル。テーブルには、次の列が含まれています。

• SOURCE_NAME:コラボレーション仕様の name 値で指定されたコラボレーションの名前。

• COLLABORATION_NAME:インストールされたコラボレーションの名前。これは、``JOIN``（所有者）または ``REVIEW``（非所有者）の呼び出しによってコラボレーションがインストールされるまで NULL です。

• OWNER_ACCOUNT:コラボレーションを作成したアカウントのデータ共有 ID。

• UPDATED_ON:コラボレーションが最後に更新された時刻。

• COLLABORATION_SPEC:このコラボレーションの仕様（YAML 形式）。これは、コラボレーションの最新バージョンを示しており、コラボレーションが作成された後に追加または削除されたリソースも含まれます。ただし、新規または削除されたテンプレートやデータ提供など、まもなく追加される進行中の更新リクエストが存在する可能性があります。

例¶

すべてのコラボレーションを表示します。

CALL SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.COLLABORATION.VIEW_COLLABORATIONS();

名前で指定されたコラボレーションの仕様を表示します。

CALL SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.COLLABORATION.VIEW_COLLABORATIONS() ->>
SELECT "COLLABORATION_SPEC" FROM $1 WHERE "SOURCE_NAME" = $collaboration_name;

アクセス要件¶

SAMOOHA_APP_ROLE ロールを使用していない場合、以下のプロシージャのいずれかを呼び出して権限を付与されたロールを使用する必要があります。

• GRANT_PRIVILEGE_ON_OBJECT_TO_ROLE('READ', 'COLLABORATION', 'collaboration name', 'role name')

• GRANT_PRIVILEGE_ON_OBJECT_TO_ROLE('RUN', 'COLLABORATION', 'collaboration name', 'role name')

• GRANT_PRIVILEGE_ON_ACCOUNT_TO_ROLE('VIEW COLLABORATIONS', 'role name')

• GRANT_PRIVILEGE_ON_ACCOUNT_TO_ROLE('CREATE COLLABORATION', 'role name')

• GRANT_PRIVILEGE_ON_ACCOUNT_TO_ROLE('JOIN COLLABORATION', 'role name')

構文¶

REVIEW( <source_name>, <owner_account> )

引数¶

source_name

参加するよう招待されたコラボレーションの名前。コラボレーションのリストを表示するには、COLLABORATION.VIEW_COLLABORATIONS を呼び出します。

owner_account

所有者の データ共有アカウント識別子。これは、COLLABORATION.VIEW_COLLABORATIONS の応答にあります。

戻り値¶

コラボレーション ID、所有者、コラボレーション仕様を含む、コラボレーションに関する情報のテーブル。

アカウントが 異なるクラウドホスティング地域 にある場合、コラボレーション所有者の REVIEW は追加のセットアップ手順がまだ実行中であることを示すメッセージを返す場合があります。このメッセージが表示された場合は、コラボレーションに関する情報テーブルが返されるまで引き続き REVIEW を呼び出してください。

例¶

-- View the collaboration for your own usage.
CALL SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.COLLABORATION.REVIEW(
  $collaboration_name,
  'org1.account1234'
);

アクセス要件¶

SAMOOHA_APP_ROLE ロールを使用していない場合、以下のプロシージャのいずれかを呼び出して権限を付与されたロールを使用する必要があります。

• GRANT_PRIVILEGE_ON_ACCOUNT_TO_ROLE('CREATE COLLABORATION', 'role name')

• GRANT_PRIVILEGE_ON_ACCOUNT_TO_ROLE('JOIN COLLABORATION', 'role name')

追加の必要なロール権限については、GRANT_PRIVILEGE_ON_ACCOUNT_TO_ROLE を参照してください。

構文¶

JOIN( <collaboration_name> )

引数¶

collaboration_name

参加するコラボレーションの名前。コラボレーションのリストを表示するには、COLLABORATION.VIEW_COLLABORATIONS を呼び出します。同じ名前の複数のコラボレーションに参加するように招待されている場合、デフォルトでは最後に COLLABORATION.REVIEW を呼び出したコラボレーションが呼び出されます。

戻り値¶

文字列の成功メッセージ。「参照使用許可がありません」というエラーが表示された場合は、トラブルシューティングガイド を参照してください。

例¶

CALL SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.COLLABORATION.JOIN(
  $collaboration_name
);

アクセス要件¶

SAMOOHA_APP_ROLE ロールを使用していない場合、以下のプロシージャのいずれかを呼び出して権限を付与されたロールを使用する必要があります。

• GRANT_PRIVILEGE_ON_ACCOUNT_TO_ROLE('CREATE COLLABORATION', 'role name')

• GRANT_PRIVILEGE_ON_ACCOUNT_TO_ROLE('JOIN COLLABORATION', 'role name')

追加の必要なロール権限については、GRANT_PRIVILEGE_ON_ACCOUNT_TO_ROLE を参照してください。

構文¶

LEAVE( <collaboration_name> )

引数¶

collaboration_name

終了するコラボレーションの名前。

戻り値¶

文字列の成功メッセージ。

例¶

-- Start the process.
CALL SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.COLLABORATION.LEAVE($collaboration_name);

-- Call until it returns LOCAL_DROP_PENDING.
CALL SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.COLLABORATION.GET_STATUS($collaboration_name);

-- Final call.
CALL SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.COLLABORATION.LEAVE($collaboration_name);

アクセス要件¶

SAMOOHA_APP_ROLE ロールを使用していない場合、以下のプロシージャのいずれかを呼び出して権限を付与されたロールを使用する必要があります。

• GRANT_PRIVILEGE_ON_ACCOUNT_TO_ROLE('CREATE COLLABORATION', 'role name')

• GRANT_PRIVILEGE_ON_ACCOUNT_TO_ROLE('JOIN COLLABORATION', 'role name')

追加の必要なロール権限については、GRANT_PRIVILEGE_ON_ACCOUNT_TO_ROLE を参照してください。

YAML 引数構文¶

RUN( <collaboration_name>, <analysis_spec> )

明示的なパラメーター構文¶

RUN( <collaboration_name>, <template_id>, <template_view_names>, <local_template_view_names>, <arguments> )

戻り値¶

表形式の分析結果。

例¶

渡すパラメーターの例：

CALL SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.COLLABORATION.RUN(
  $collaboration_name,
  $template_name,
  ['Provider.data_offering_1_2026_01_12_v0.test_dataset'], -- Tables to pass to source_tables variable.
  [],
  {} -- Template takes no parameters.
);

アクセス要件¶

SAMOOHA_APP_ROLE ロールを使用していない場合、以下のプロシージャのいずれかを呼び出して権限を付与されたロールを使用する必要があります。

• GRANT_PRIVILEGE_ON_OBJECT_TO_ROLE('RUN', 'COLLABORATION', 'collaboration name', 'role name')

• GRANT_PRIVILEGE_ON_ACCOUNT_TO_ROLE('CREATE COLLABORATION', 'role name')

• GRANT_PRIVILEGE_ON_ACCOUNT_TO_ROLE('JOIN COLLABORATION', 'role name')

構文¶

VIEW_ACTIVATIONS( <collaboration_name> )

引数¶

collaboration_name

コラボレーションの名前。

戻り値¶

各アクティベーションの詳細を含むテーブル。テーブルには、次の列が含まれています。

• UPDATED_ON:ステータスが最後に更新された時刻。

• SEGMENT_NAME:このアクティベーションを識別するために分析実行者によって割り当てられた任意の文字列。詳細については、 クエリ結果のアクティベーション をご参照ください。

• ACTIVATION_ID：このアクティベーションリクエストの ID。詳細については、 プロバイダーとコンシューマーのアクティベーション結果を表示する をご参照ください。

• TEMPLATE_ID:このアクティベーションデータを作成するために使用されたテンプレート。

• SHARED_BY:分析を実行したコラボレーター。

• SHARED_WITH:分析データを受け取るコラボレーター。

• STATUS:アクティベーションのステータス。次の値がサポートされています。

  • PENDING:アクティベーションがリクエストされましたが、処理待ちです。

  • SHARED:アクティベーションデータは処理する準備ができています。PROCESS_ACTIVATION を呼び出して、結果をアカウントに送信してください。

  • FAILED:アクティベーション処理に失敗しました。DETAILS 列の情報を確認してください。

  • PROCESSED:アクティベーション結果がアクティベーションリクエストで指定されたアカウントに送信されました。

• DETAILS:失敗の詳細（アクティベーションが失敗した場合）。

例¶

CALL SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.COLLABORATION.VIEW_ACTIVATIONS(
  $collaboration_name
);

アクセス要件¶

SAMOOHA_APP_ROLE ロールを使用していない場合、以下のプロシージャのいずれかを呼び出して権限を付与されたロールを使用する必要があります。

• GRANT_PRIVILEGE_ON_OBJECT_TO_ROLE('VIEW ACTIVATIONS', 'COLLABORATION', 'collaboration name', 'role name')

• GRANT_PRIVILEGE_ON_OBJECT_TO_ROLE('RUN', 'COLLABORATION', 'collaboration name', 'role name')

• GRANT_PRIVILEGE_ON_ACCOUNT_TO_ROLE('CREATE COLLABORATION', 'role name')

• GRANT_PRIVILEGE_ON_ACCOUNT_TO_ROLE('JOIN COLLABORATION', 'role name')

構文¶

PROCESS_ACTIVATION( <collaboration_name>, <segment_name> )

引数¶

collaboration_name

コラボレーションの名前。

segment_name

結果テーブルでこのアクティベーションを識別するために割り当てられた任意の文字列。セグメント名は分析クエリで template_configuration.arguments.segment_name を使用して割り当てられます。詳細については、 クエリ結果のアクティベーション をご参照ください。

戻り値¶

ユーザーが結果を取得できるテーブル名と、結果のために指定されたセグメント名。結果の読み方について詳しくは、クエリ結果のアクティブ化 を参照してください。

例¶

CALL SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.COLLABORATION.PROCESS_ACTIVATION(
  $collaboration_name,
  'q1_2025_segment'
);

アクセス要件¶

SAMOOHA_APP_ROLE ロールを使用していない場合、以下のプロシージャのいずれかを呼び出して権限を付与されたロールを使用する必要があります。

• GRANT_PRIVILEGE_ON_OBJECT_TO_ROLE('PROCESS ACTIVATION', 'COLLABORATION', 'collaboration name', 'role name')

• GRANT_PRIVILEGE_ON_ACCOUNT_TO_ROLE('CREATE COLLABORATION', 'role name')

• GRANT_PRIVILEGE_ON_ACCOUNT_TO_ROLE('JOIN COLLABORATION', 'role name')

構文¶

CREATE_REGISTRY( '<registry_name>', <registry_type> )

引数¶

registry_name

作成するレジストリの名前。アカウント内のすべてのレジストリで一意の名前にする必要があります。

registry_type

このレジストリに含まれるリソースの型。サポートされている値: TEMPLATE、 DATA OFFERING。

戻り値¶

文字列の成功メッセージ。

例¶

CALL SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.REGISTRY.CREATE_REGISTRY(
  'my_custom_registry',
  'TEMPLATE'
);

アクセス要件¶

SAMOOHA_APP_ROLE ロールを使用していない場合は、次のプロシージャを呼び出して権限を付与されたロールを使用する必要があります。

• GRANT_PRIVILEGE_ON_ACCOUNT_TO_ROLE('CREATE REGISTRY', 'role name')

構文¶

DROP_REGISTRY( '<registry_name>' )

引数¶

registry_name

ドロップするレジストリの名前。

戻り値¶

文字列の成功メッセージ。

例¶

CALL SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.REGISTRY.DROP_REGISTRY(
  'my_custom_registry'
);

アクセス要件¶

SAMOOHA_APP_ROLE ロールを使用していない場合は、次のプロシージャを呼び出して権限を付与されたロールを使用する必要があります。

• GRANT_PRIVILEGE_ON_ACCOUNT_TO_ROLE('CREATE REGISTRY', 'role name')

構文¶

GRANT_PRIVILEGE_ON_OBJECT_TO_ROLE(
  <privilege>,
  <object_type>,
  <object_name>,
  <account_role_name> )

引数¶

privilege

このロールに付与する必要がある権限。どの権限がどのオブジェクトに対して利用可能かについては、以下のテーブルをご参照ください。

object_type

このロールに権限を付与するオブジェクトの型。サポートされている値:

• COLLABORATION

• REGISTRY

object_name

オブジェクトの仕様で指定された、オブジェクトの ID。

account_role_name

付与されるロール。

次の権限とオブジェクト型の組み合わせがサポートされています。

戻り値¶

文字列の成功メッセージ。

例¶

この例では、my_collaboration という名前のコラボレーションで分析を実行するためにアナリストが使用するロールを作成し、ユーザーに割り当てます。

USE ROLE role_that_created_this_collaboration;

CALL SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.ADMIN.GRANT_PRIVILEGE_ON_OBJECT_TO_ROLE(
  'RUN',
  'COLLABORATION',
  $collaboration_name,
  'collaborator_analyst_role'
);
GRANT ROLE collaborator_analyst_role to USER alexander_hamilton;

アクセス要件¶

オブジェクトで GRANT_PRIVILEGE_ON_OBJECT_TO_ROLE を呼び出すには、そのオブジェクトを作成したときと同じロールを使用する必要があります。

構文¶

GRANT_PRIVILEGE_ON_ACCOUNT_TO_ROLE( <privilege>, <account_role_name> )

引数¶

privilege

このロールに付与する権限。以下の文字列値がサポートされています。

• JOIN COLLABORATION:COLLABORATION.JOIN および以下のプロシージャを参加済みコラボレーションで実行するための権限を付与します。

  • ADMIN.GRANT_PRIVILEGE_ON_OBJECT_TO_ROLE

  • COLLABORATION.ADD_TEMPLATE_REQUEST

  • COLLABORATION.APPROVE_UPDATE_REQUEST

  • COLLABORATION.ENABLE_TEMPLATE_AUTO_APPROVAL

  • COLLABORATION.DISABLE_TEMPLATE_AUTO_APPROVAL

  • COLLABORATION.REMOVE_TEMPLATE

  • COLLABORATION.GET_STATUS

  • COLLABORATION.LEAVE

  • COLLABORATION.LINK_DATA_OFFERING

  • COLLABORATION.LINK_LOCAL_DATA_OFFERING

  • COLLABORATION.PROCESS_ACTIVATION

  • COLLABORATION.REJECT_UPDATE_REQUEST

  • COLLABORATION.REVIEW

  • COLLABORATION.RUN

  • COLLABORATION.TEARDOWN

  • COLLABORATION.UNLINK_DATA_OFFERING

  • COLLABORATION.UNLINK_LOCAL_DATA_OFFERING

  • COLLABORATION.VIEW_ACTIVATIONS

  • COLLABORATION.VIEW_COLLABORATIONS

  • COLLABORATION.VIEW_DATA_OFFERINGS

  • COLLABORATION.VIEW_TEMPLATES

  • COLLABORATION.VIEW_UPDATE_REQUESTS

  • REGISTRY.VIEW_REGISTERED_DATA_OFFERINGS

  • REGISTRY.VIEW_REGISTERED_TEMPLATES

  この権限では、次のアカウントレベル権限をロールに手動で付与する必要があります。

  • APPLY ROW ACCESS POLICY

  • CREATE APPLICATION

  • CREATE DATABASE

  • CREATE に LISTING

  • CREATE SHARE

  • IMPORT SHARE

  • MANAGE SHARE TARGET

• CREATE COLLABORATION:COLLABORATION.INITIALIZE、そして ``JOIN COLLABORATION``で許可されているすべてのプロシージャを、参加済みコラボレーションに対して実行するための権限を付与します。次のアカウントレベル権限を、ロールに手動で付与する必要があります。

  • APPLY ROW ACCESS POLICY

  • CREATE APPLICATION

  • CREATE DATABASE

  • CREATE に LISTING

  • CREATE SHARE

  • IMPORT SHARE

  • MANAGE SHARE TARGET

  • EXECUTETASK（INITIALIZEプロシージャで自動参加を使用する場合）

• VIEW COLLABORATIONS:COLLABORATION.VIEW_COLLABORATIONS を実行するための権限を付与します。次の権限をロールに手動で付与する必要があります。

  • IMPORT SHARE

• REGISTER DATA OFFERING:REGISTRY.REGISTER_DATA_OFFERING を実行するための権限を付与します。アクティベーションを実装するコラボレーションに分析実行者が参加するためには、この権限が必須です。

• VIEW REGISTERED DATA OFFERINGS:REGISTRY.VIEW_REGISTERED_DATA_OFFERINGS を実行するための権限を付与します。

• VIEW REGISTERED TEMPLATES:REGISTRY.VIEW_REGISTERED_TEMPLATES を実行するための権限を付与します。

• REGISTER TEMPLATE:REGISTRY.REGISTER_TEMPLATE を実行するための権限を付与します。

• CREATE REGISTRY:REGISTRY.CREATE_REGISTRY および REGISTRY.DROP_REGISTRY を実行するための権限、およびカスタムレジストリからの読み取り権限を付与します。

• MANAGE LISTING AUTO FULFILLMENT:コラボレーターが他のクラウドホスティングリージョンのコラボレーションに参加するための権限を付与します。詳細については、 クロスクラウド自動フルフィルメントの有効化 をご参照ください。

account_role_name

アカウントレベルのロールの名前。

戻り値¶

文字列の成功メッセージ。

例¶

USE ROLE ACCOUNTADMIN;
CALL SAMOOHA_BY_SNOWFLAKE_LOCAL_DB.ADMIN.GRANT_PRIVILEGE_ON_ACCOUNT_TO_ROLE(
  'REGISTER DATA OFFERING',
  'COLLABORATOR_ANALYST_ROLE'
);

アクセス要件¶

このプロシージャを実行するには、ACCOUNTADMIN ロールが必要です。