공동 작업 사양¶

상위 수준 공동 작업을 정의합니다. 사양은 초대되는 분석 실행자 및 각 분석 실행자가 액세스하고 실행할 수 있는 데이터와 템플릿을 정의합니다. 여기에 나열된 모든 템플릿 또는 데이터 오퍼링은 공동 작업 사양에 포함되기 전에 등록해야 합니다.

소유자는 INITIALIZE를 호출하여 이 사양을 제출합니다.

스키마:

api_version: 2.0.0              # Required: Must be "2.0.0"
spec_type: collaboration        # Required: Must be "collaboration"
name: <collaboration_name>      # Required: Unique name (max 75 chars)
version: <version_string>       # Optional: Version identifier (max 20 chars)
description: <collaboration_description>  # Optional: Description (max 1,000 chars)
owner: <owner_alias>            # Required: Alias of owner

collaborator_identifier_aliases:  # Required: Map aliases to account identifiers
  <alias_1>: <account_identifier_1>  # One or more alias mappings...

analysis_runners:               # Required: Who can run analyses
  <analysis_runner_alias>:      # One or more analysis runner definitions...
    data_providers:             # Required: Data providers for this runner
      <provider_alias>:         # One or more provider definitions...
        data_offerings:         # Required: List of offerings (can be empty [])
          - id: <data_offering_id>  # Zero or more data offering IDs...
    templates:                  # Optional: Templates this runner can use
      - id: <template_id>       # One or more template IDs...
    activation_destinations:    # Optional: Where results can be sent
      snowflake_collaborators:  # Optional: Collaborators who can receive results
        - <collaborator_alias>  # One or more collaborator aliases...

api_version

사용되는 Collaboration API의 버전입니다. 2.0.0 여야 합니다.

spec_type

사양 유형 식별자입니다. collaboration 여야 합니다.

name: collaboration_name

이 공동 작업에 사용할 사용자 친화적인 이름입니다. 이는 생성자의 계정에서 고유해야 하며 :doc:`Snowflake 식별자 규칙 </sql-reference/identifiers-syntax>`(최대 75자)을 따라야 합니다.

``version``(선택 사항)

이 공동 작업의 버전 식별자입니다(최대 20자). Snowflake 식별자 규칙 </sql-reference/identifiers-syntax>`을 따라야 합니다. *YYYY_MM_DD_V#* 형식을 사용하는 것이 좋습니다. 예를 들어 ``2025_10_22_V1` 과 같습니다.

:samp:`description: {collaboration_description}`(선택 사항)

공동 작업자가 읽을 수 있는 공동 작업에 대한 설명입니다(최대 1,000자).

owner: owner_alias

collaborator_identifier_aliases 에 정의된 공동 작업 소유자의 별칭입니다.

collaborator_identifier_aliases

공동 작업자 별칭과 데이터 공유 계정 식별자 간의 매핑입니다. 여기에 나열된 사용자만 공동 작업에 참여할 수 있습니다. 모든 공동 작업자를 참조하려면 데이터 공유 계정 식별자를 직접 사용하는 대신 여기에 정의된 별칭을 사용합니다. 이는 이 공동 작업에서 고유해야 하며 Snowflake 식별자 규칙 (최대 25자)을 따라야 합니다.

analysis_runners

이 공동 작업에서 분석을 실행할 수 있는 사용자를 설명합니다. 각 분석 실행자는 고유한 별칭으로 키가 지정됩니다. 이 공동 작업에서 분석을 실행하려면 하나 이상의 계정을 허용해야 합니다.

<analysis_runner_alias>

이 공동 작업에서 분석을 실행할 수 있는 계정의 별칭입니다. 별칭은 collaborator_identifier_aliases 목록에 정의되어 있습니다.

data_providers

이 분석 실행자가 액세스할 수 있는 데이터의 데이터 공급자입니다. 각 공급자는 ``collaborator_identifier_aliases``에 정의된 별칭으로 키가 지정됩니다.

data_offerings: 분석 실행자가 액세스할 수 있는 이 데이터 공급자의 데이터 오퍼링 목록 또는 나중에 데이터 오퍼링을 추가할 수 있는 빈 배열 [] 자리 표시자입니다. 각 데이터 오퍼링은 데이터 공급자가 REGISTER_DATA_OFFERING을 호출할 때 생성되는 ID에 의해 참조됩니다.

``templates``(선택 사항)

이 분석 실행자가 사용할 수 있는 템플릿입니다. 각 템플릿은 해당 ID에 의해 참조됩니다. 초기 사양에서는 생략할 수 있으며, 공동 작업이 생성된 후에도 이 분석 실행자와 템플릿을 계속 공유할 수 있습니다.

``activation_destinations``(선택 사항)

분석 결과에 대한 활성화 설정을 정의합니다.

``snowflake_collaborators``(선택 사항): 활성화된 분석 결과를 수신할 수 있는 공동 작업자의 목록입니다. 이 사양의 collaborator_identifier_aliases 목록에서 별칭을 사용합니다. 여기에 나열된 모든 공동 작업자는 활성화 구현하기 에 설명된 권한이 있어야 합니다.

예¶

api_version: 2.0.0
spec_type: collaboration
name: my_sample_collaboration
owner: Owner
collaborator_identifier_aliases:
  Owner: ENG.OWNER
  AnalysisRunner_1: ENG.CONSUMER_1
  DataProvider_1: ENG.PROVIDER_1
  DataProvider_2: ENG.PROVIDER_2
  AnalysisRunner_2: ENG.PROVIDER_3
analysis_runners:
  AnalysisRunner_1:
    data_providers:
      DataProvider_1:
        data_offerings:
        - id: DCR_PREPROD_CI_PROVIDER_ANY_NAME_ZUDFTMULHQ_iuDfn_v0
      DataProvider_2:
        data_offerings: []
    templates:
    - id: test_sca_three_party_template_JOaVG_v0
  AnalysisRunner_2:
    data_providers:
      DataProvider_2:
        data_offerings: []
    templates:
    - id: test_sca_three_party_template_JOaVG_v0