분석 사양¶

사용할 템플릿, 템플릿에 전달할 테이블, 템플릿에서 사용하는 변수 값 등 분석 실행자가 분석을 실행하는 데 필요한 모든 정보를 지정합니다. 데이터 쿼리에 자유 형식 SQL을 사용하지 않는 경우 분석을 실행하려는 모든 분석 실행자는 이 사양을 사용하여 템플릿 및 입력 데이터를 정의합니다.

스키마:

api_version: 2.0.0              # Required: Must be "2.0.0"
spec_type: analysis             # Required: Must be "analysis"
template: <template_id>         # Required: ID of the template to use
name: <analysis_name>           # Optional: Unique name (max 75 chars)
version: <version_string>       # Optional: Version identifier (max 20 chars)
description: <analysis_description>  # Optional: Description (max 1,000 chars)

template_configuration:         # Optional: Values used when running the template
  view_mappings:                # Optional: Mappings for shared data
    source_tables:              # Optional: Tables from data offerings. Populates the source_table array variable.
      - <source_table_name>     # One or more source table names from the TEMPLATE_VIEW_NAME column...
    <argument_name>: <view_name>  # Custom argument to template view name mapping
  local_view_mappings:          # Optional: Mappings for local data
    my_tables:                  # Optional: Tables from local data offerings. Populates the my_table array variable.
      - <my_table_name>         # One or more local table names...
    <argument_name>: <view_name>  # Custom argument to local template view name mapping
  arguments:                    # Optional: Template arguments as key-value pairs
    <argument_name>: <argument_value>  # One or more argument key-value pairs...
  activation:                   # Required for activation templates
    snowflake_collaborator: <alias>  # Collaborator alias for activation destination
    segment_name: <segment_name>     # Unique segment name for this activation

api_version

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

spec_type

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

template: template_id

이 분석에 사용할 템플릿의 ID입니다. 이 템플릿은 템플릿 이름이 아니라 템플릿이 등록될 때 얻은 템플릿 ID여야 합니다.

``name``(선택 사항)

이 분석의 고유하고 사용자 친화적인 이름입니다. :doc:`Snowflake 식별자 규칙</sql-reference/identifiers-syntax>`(최대 75자)을 따라야 하며, Snowflake 데이터 클린룸 계정 내에서 고유해야 합니다.

``version``(선택 사항)

이 분석 사양의 버전 식별자입니다(최대 20자). Snowflake 식별자 규칙 </sql-reference/identifiers-syntax>`을 따라야 하며, 계정 내의 분석 이름에 대해 고유해야 합니다. *YYYY_MM_DD_V#* 형식을 사용하는 것이 좋습니다. 예를 들어 ``2025_10_22_V1` 과 같습니다.

``description``(선택 사항)

이 분석이 수행하는 작업에 대한 간략한 설명입니다(최대 1,000자).

``template_configuration``(선택 사항)

지정된 템플릿을 실행할 때 사용되는 값입니다.

``view_mappings``(선택 사항)

공유 데이터 오퍼링에 대한 인자 이름 및 템플릿 뷰 이름 간의 매핑입니다.

``source_tables``(선택 사항): source_table 템플릿 변수를 채울 뷰 이름의 목록입니다. 데이터 오퍼링 사양에 지정된 테이블 별칭을 사용합니다. VIEW_DATA_OFFERINGS를 호출하여 사용 가능한 테이블 목록을 가져올 수 있습니다. TEMPLATE_VIEW_NAME 열의 뷰 이름을 사용합니다. 각 항목의 형식은 :samp:`{collaborator_alias}.{data_offering_ID}.{dataset_alias}`입니다.
argument_name: view_name: 인자 이름 및 템플릿 뷰 이름 간의 사용자 지정 매핑입니다(각각 최대 255자)

``local_view_mappings``(선택 사항)

비공개 데이터 세트에 대한 인자 이름 및 로컬 템플릿 뷰 이름 간의 매핑입니다.

``my_tables``(선택 사항): my_table 템플릿 변수를 채울 테이블 이름의 목록입니다. 이는 LINK_LOCAL_DATA_OFFERING을 호출하여 연결한 비공개 데이터 세트에만 사용할 수 있습니다. 각 항목의 형식은 :samp:`{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자). 활성화 결과를 식별하고 추적하는 데 사용됩니다. :doc:`Snowflake 식별자 규칙 </sql-reference/identifiers-syntax>`을 따라야 합니다.