Snowflake Data Clean Rooms Collaboration API¶

예¶

다음은 협업을 생성하고 조인할 수 있는 역할 및 협업에서 리소스를 보고 분석을 실행할 수 있는 역할(단, 협업에 조인하거나 수정할 수는 없음)의 두 Collaboration API 역할을 생성하는 예제입니다.

-- 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> )

인자¶

:samp:`{registry_name}`*(선택 사항)*

이 템플릿을 등록할 :doc:`사용자 지정 레지스트리 </user-guide/cleanrooms/v2/registries>`의 이름입니다. 지정하지 않는 경우 기본 계정 레지스트리에 템플릿을 등록합니다.

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>' ] )

인자¶

:samp:`{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')

• 다음 권한 중 하나:

  • 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 name}’, ‘{role name}’)`도 있어야 합니다.

구문¶

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

인자¶

collaboration_name

템플릿을 제거할 협업의 이름입니다.

template_id

협업에서 제거할 템플릿의 ID입니다.

remove_for

이 협업에서 더 이상 이 템플릿을 확인하거나 사용할 수 없어야 하는 분석 실행자의 하나 이상의 별칭 배열입니다.

반환¶

문자열 성공 메시지. 공동 작업자에 대한 템플릿이 제거되었는지 확인하려면 협업 사양을 확인합니다.

예¶

-- 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')

• 다음 권한 중 하나:

  • 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 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> )

인자¶

:samp:`{registry_name}`*(선택 사항)*

이 데이터 오퍼링을 등록할 :doc:`사용자 지정 레지스트리 </user-guide/cleanrooms/v2/registries>`의 이름입니다. 지정하지 않는 경우 기본 계정 레지스트리에 데이터 오퍼링을 등록합니다.

data_offering_spec

데이터 오퍼링을 설명하는 YAML 형식의 :ref:`데이터 오퍼링 정의 <label-dcr_collaboration_data_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')

• 다음 권한 중 하나:

  • 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 name}’, ‘{role name}’)`도 있어야 합니다.

구문¶

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

인자¶

collaboration_name

협업의 이름입니다.

data_offering_id

등록 시 생성되어 링크를 해제할 데이터 세트의 ID입니다.

remove_for

액세스를 제거할 하나 이상의 분석 실행자의 문자열 별칭으로 구성된 배열입니다. 여기에 나열된 모든 공동 작업자는 현재 이 데이터 오퍼링에 액세스할 수 있는 분석 실행자여야 합니다.

반환¶

문자열 성공 메시지.

예¶

-- 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>' ] )

인자¶

:samp:`{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: 이 협업의 모든 :ref:`자유 형식 열 정책 <label-dcr_freeform_sql_policies_field>`을 정책 유형별로 키로 지정한 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: 요청을 승인했지만 한 명 이상의 다른 공동 작업자가 요청을 승인해야 합니다.

  • 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>`입니다.

:samp:`{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 이외의 역할을 사용하는 경우, 역할에 EXECUTE TASK 계정 수준 권한도 부여되어야 합니다.

추가 필수 역할 권한에 대해서는 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 역할을 사용하지 않는 경우 MANAGE FIREWALL CONFIGURATION 권한이 부여된 역할을 사용하여 이 프로시저를 호출해야 합니다.

구문¶

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

소유자의 :ref:`데이터 공유 계정 식별자 <label-account_name_data_sharing>`입니다. 이는 ``COLLABORATION.VIEW_COLLABORATIONS``에 대한 응답에서 확인할 수 있습니다.

반환¶

협업 ID, 소유자 및 협업 사양을 포함하여 협업에 대한 정보 테이블입니다.

계정이 협업 소유자와 :ref:`다른 클라우드 호스팅 리전 <label-dcr_collab_enabling_laf>`에 있는 경우 ``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``를 호출한 협업으로 설정됩니다.

반환¶

문자열 성공 메시지. 참조 사용 권한 누락에 대한 오류가 발생하는 경우 :ref:`문제 해결 가이드 <label-dcr_database_missing_reference_usage_error>`를 참조하세요.

예¶

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

  • EXECUTE TASK(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 역할이 필요합니다.