목록 매니페스트 참조

프로그래밍 방식으로 Snowflake 목록을 생성하려면 YAML(https://yaml.org/spec/)로 작성된 매니페스트가 필요합니다. 여기에 제공된 정보를 사용하여 매니페스트 형식과 개별 섹션에 대해 알아보십시오.

참고 항목:

CREATE LISTING, ALTER LISTING, DESCRIBE LISTING, SHOW LISTINGS, DROP LISTING

참고

필드는 다음 중 하나일 수 있습니다.

  • 선택 사항 - 마켓플레이스 목록이나 비공개 목록 모두에 대한 선택 사항입니다.

  • 필수 - 마켓플레이스 목록이나 비공개 목록에 모두 필요합니다.

  • 자격 - 마켓플레이스 목록과 비공개 목록에 대한 요구 사항이 다르고, 선택 사항과 필수 사항은 목록 유형에 따라 자격이 부여됩니다. 예를 들어, 비공개 목록의 경우 선택 사항 이지만 마켓플레이스 목록의 경우 필수 입니다.

목록 목록의 일반적인 형식은 다음과 같습니다.

#
# Listing prefix
#
title: <listing title>
subtitle: <Optional listing subtitle>
description: <listing description>
profile : <Optional name of the provider profile>

listing_terms:
  - # Required listing terms that the consumer must sign
auto_fulfillment:
  - # Required when the target accounts are outside the provider's region, otherwise optional.
data_dictionary:
  - # Optional data dictionary
business_needs:
  - # Optional <List>BusinessNeed elements, maximum 6.
usage_examples:
  - # Optional <List>UsageExample elements, maximum 10.
targets:
  - # Required <List> Consumer accounts to target with this private listing
Copy

다음 섹션에서는 각 목록 매니페스트 필드와 하위 필드를 자세히 설명하고 관련 예를 제공합니다.

목록 접두사

각 목록 목록은 다음 필드로 시작합니다.

  • title (문자열, 필수, 최대 길이 110): 목록 제목입니다.

  • subtitle (문자열, 비공개인 경우 선택 사항, 마켓플레이스 목록의 경우 필수, 최대 길이 110): 목록 부제목입니다.

  • description (문자열, 필수, 최대 길이 7500): 목록 설명입니다.

  • custom_contact (문자열, 선택 사항): 이메일입니다. 유효하고 올바르게 구성된 이메일 주소여야 합니다.

  • profile (문자열, 비공개 목록의 경우 선택 사항, 마켓플레이스 목록의 경우 필수): 승인된 공급자 프로필의 이름입니다.

자세한 내용은 공급자 기본 정보 섹션을 참조하십시오.

참고

profile 의 값은 show profiles in data exchange SNOWFLAKE_DATA_MARKETPLACE; 를 실행하여 찾을 수 있습니다.

목록 접두사의 예

title: Weather information
subtitle: Historical weather by postcode.
description: This listing includes historical weather data by post code.
profile: My provider profile
Copy

listing_terms

필수 listing_terms (필수) 필드에는 다음과 같은 이름 값 쌍이 포함됩니다.

  • listing_terms.type (enum, 필수): 다음 중 하나여야 합니다.

    • STANDARD - 마켓플레이스 제품에 대한 표준 계약을 참조합니다.

    • OFFLINE - 당사자가 오프라인에서 조건을 협상했음을 나타냅니다.

    • CUSTOM - 지정된 경우, listing_terms.link 값을 지정해야 합니다.

  • listing_terms.link (유형이 CUSTOM인 경우 필수): 공급자의 목록 약관에 대한 정규화된 링크이며, http 또는 https 로 시작해야 합니다.

자세한 내용은 기본 정보 의 테이블에서 서비스 약관 을 참조하십시오.

참고

컨슈머는 목록 약관을 프로그래밍 방식으로 수락할 수 있습니다. 자세한 내용은 Snowflake 지원팀 에 문의하십시오.

listing_terms 예제

. . .
listing_terms:
  type: "CUSTOM"
  link: "http://example.com/my/listing/terms"
. . .
Copy

targets

마켓플레이스 및 비공개 목록의 경우 targets 필드는 필수입니다.

최대 100개의 요소를 포함하는 목록이 포함되어 있습니다.

  • targets.accounts (targets.region 이 없는 경우 필수): 목록을 공유할 계정 목록입니다.

    각 대상 계정은 <OrgName>.<AccountName> 형식이어야 합니다. 여기서,

또는

  • targets.regions (targets.accounts 가 없는 경우 필수)

    목록을 공유할 리전 목록입니다.

    각 대상 리전은 “region_groups_type.snowflake_region” 형식이어야 합니다. 또한 “ALL”은 모든 리전을 포함할 수 있도록 지원됩니다.

    이러한 예는 “PUBLIC.AWS_US_EAST_1”입니다.

    리전 그룹 유형 및 Snowflake 리전의 전체 목록을 보려면 다음을 실행하십시오.

    SHOW REGIONS IN DATA EXCHANGE SNOWFLAKE_DATA_MARKETPLACE;
    Copy

자세한 내용은 컨슈머 계정(비공개 목록만 해당) 섹션을 참조하십시오.

targets 예

이 목록에 대한 대상 계정 세트를 정의합니다.

. . .
targets:
   accounts: ["Org1.Account1", "Org2.Account2"]
. . .
Copy

이 목록에 대한 대상 리전 세트를 정의합니다.

. . .
targets:
   regions: ["PUBLIC.AWS_US_EAST_1", "PUBLIC.AZURE_WESTUS2"]
. . .
Copy

auto_fulfillment

클라우드 간 자동 복제를 사용하면 목록과 연결된 데이터 제품이 다른 Snowflake 리전으로 자동으로 주문 처리될 수 있습니다. auto_fulfillment 필드는 자동 처리의 수행 방법을 정의합니다.

클라우드 간 자동 복제에 대한 자세한 내용은 클라우드 간 자동 복제 구성하기 섹션을 참조하십시오.

동일한 리전의 계정과 공유하는 경우에만 선택 사항이며, 그 외에는 필수입니다.

auto_fulfillment 필드는:

  • 데이터 제품이 애플리케이션 패키지인 경우 필수입니다.

  • 대상 계정이 공급자 리전 외부에 있는 비공개 목록의 경우 필수입니다.

  • 선택 사항이지만, 데이터 제품이 공유인 경우 마켓플레이스 목록에 권장됩니다.

다음 이름 값 쌍을 포함합니다.

  • auto_fulfillment.refresh_schedule

    • <num> MINUTE - 분 단위. 최소 10분, 최대 8일 또는 11520분.

      refresh_type 이 SUB_DATABASE_WITH_REFERENCE_USAGE 로 지정된 경우 이 설정을 포함하지 마십시오. 애플리케이션 패키지의 새로 고침 일정은 계정 수준에서 정의해야 하며 목록 수준에서는 지정할 수 없습니다.

      자세한 내용은 계정 수준 새로 고침 빈도 설정하기 을 참조하십시오.

    • USING CRON <expression> - 데이터 제품 자동 복제 새로 고침 일정을 정의합니다.

      USING CRON 및 REPLICATION SCHEDULE 의 구문은 동일합니다. CREATE REPLICATION GROUP 매개 변수 섹션을 참조하십시오.

  • auto_fulfillment.refresh_type (auto_fulfillment 사용 시 필수): 다음 중 하나여야 함 -

    • SUB_DATABASE - 데이터베이스 복제(오브젝트 수준) - 권장됨.

    • SUB_DATABASE_WITH_REFERENCE_USAGE - 애플리케이션 패키지

    • FULL_DATABASE - 데이터베이스 복제(전체 데이터베이스에 대해)

  • auto_fulfillment.refresh_schedule_override (선택 사항): 동일한 데이터베이스를 사용하는 모든 목록에 대해 정의된 업데이트 새로 고침 빈도를 재정의합니다. 이 값이 FALSE 인 경우, 동일한 데이터베이스를 공유하는 여러 목록의 새로 고침 빈도가 다르면 목록 업데이트가 실패합니다.

    • TRUE - 새로 고침 빈도 재정의를 활성화합니다.

    • FALSE - (기본값) 새로 고침 빈도 재정의를 비활성화합니다.

클라우드 간 자동 복제 구성하기 도 참조하십시오.

auto_fulfillment.refresh_schedule 예

다음 예에서는 목록과 관련된 데이터 제품을 10분마다 새로 고칩니다.

. . .
listing_terms: . . .
. . .
auto_fulfillment:
  refresh_schedule: 10 MINUTE
  refresh_type: SUB_DATABASE
. . .
Copy

다음 예에서는 특정 리전에서 특정 날짜와 시간에 목록과 관련된 데이터 제품을 새로 고칩니다.

. . .
listing_terms: . . .
. . .
auto_fulfillment:
  refresh_schedule: USING CRON  0 17 * * MON-FRI Europe/London
  refresh_type: SUB_DATABASE
. . .
Copy

다음 예에서는 동일한 데이터베이스를 공유하지만 새로 고침 빈도가 다른 목록에 대한 새로 고침 빈도 재정의를 활성화합니다.

. . .
listing_terms: . . .
. . .
auto_fulfillment:
  refresh_schedule: 10 MINUTE
  refresh_type: SUB_DATABASE
  refresh_schedule_override: TRUE
. . .
Copy

Snowflake Native App auto_fulfillment 예제

SUB_DATABASE_WITH_REFERENCE_USAGE 는 애플리케이션 패키지와만 사용할 수 있으며 auto_fulfillment.refresh_schedule 과 결합할 수 없습니다.

. . .
listing_terms: . . .
. . .
auto_fulfillment:
  refresh_type: SUB_DATABASE_WITH_REFERENCE_USAGE
. . .
Copy

오브젝트 수준 auto_fulfillment 예

. . .
listing_terms: . . .
. . .
auto_fulfillment:
  refresh_type: SUB_DATABASE
. . .
Copy

business_needs

목록은 쉽게 찾을 수 있도록 비즈니스 요구 사항별로 그룹화됩니다. 비즈니스 요구 사항은 특정 목록이 주어진 비즈니스 요구 사항을 충족하는 방법을 설명합니다. 자세한 내용은 비즈니스 요구 사항 을 참조하십시오.

STANDARD 비즈니스 요구 사항

  • business_needs.name (business_needs 사용 시 필수):

    다음과 같은 값이 유효한 값입니다.

    • “360-Degree Customer View”

    • “Supply Chain”

    • “고객 경험 개인화”

    • “재고 관리”

    • “광고 수익 가속화”

    • “특성 분석”

    • “연락처 데이터 강화”

    • “보행자 트래픽 분석”

    • “대상 그룹 세분화”

    • “감정 분석”

    • “ESG 투자 분석”

    • “펀더멘탈 분석”

    • “정량적 분석”

    • “리스크 분석”

    • “부정 행위 시정”

    • “고객 온보딩”

    • “ID 분해능”

    • “자산 평가”

    • “경제적 영향 분석”

    • “수요 예측”

    • “인구 건강 관리”

    • “실제 세계 데이터(RWD)”

    • “위치 계획”

    • “규제 보고”

    • “가입자 확보 및 유지”

    • “생명과학 상용화”

    • “환자 360”

    • “블록체인 분석”

    • “고객 확보”

    • “데이터 품질 및 정리”

    • “위치 데이터 강화”

    • “위치 지리 코딩”

    • “머신 러닝”

    • “시장 분석”

    • “가격 분석”

    • “대상 그룹 활성화”

business_needs[].description (business_needs 사용 시 필수): 관련 business_needs.name에 대한 설명으로, 최대 길이는 1000입니다.

business_needs[].type: STANDARD(선택 사항)

CUSTOM 비즈니스 요구 사항

사용자 지정 비즈니스 요구 사항에는 사용자 정의 name, description 및 값이 CUSTOM인 필수 type 필드가 포함됩니다.

business_needs.name (business_needs 사용 시 필수): 사용자 정의 이름.

business_needs[].description (business_needs 사용 시 필수): 관련 business_needs.name에 대한 설명으로, 최대 길이는 1000입니다.

business_needs[].type: CUSTOM(사용자 지정 비즈니스 요구 사항을 정의하는 경우 필수).

business_needs 예

선택 사항 type 이 없는 경우 표준

. . .
business_needs:
 - name: "Real World Data (RWD)"
   description: "Global weather data"
. . .
Copy

선택 사항 type 이 있는 경우 표준

. . .
business_needs:
 - name: "Real World Data (RWD)"
   description: "Global weather data"
   type: STANDARD
. . .
Copy

필수 type 이 있는 경우 사용자 지정

. . .
business_needs:
 - name: "Machinery Maintenance"
   description: "Repair and maintenance data for machinery"
   type: CUSTOM
. . .
Copy

categories

categories 필드는 목록이 속한 카테고리 또는 리전을 지정합니다. 카테고리는 비공개 목록의 경우 선택 사항이지만, 마켓플레이스 목록의 경우 필수입니다.

카테고리는 Snowflake Marketplace 에서 지역별로 목록을 검색하고 컨슈머가 데이터를 찾을 수 있도록 지원하는 데 사용됩니다.

categories 필드는 목록이지만, 아래 세트에서 단일 항목만 포함할 수 있습니다.

  • BUSINESS

  • CONNECTORS

  • DEMOGRAPHICS

  • ECONOMY

  • ENERGY

  • ENVIRONMENT

  • FINANCIAL

  • GOVERNMENT

  • HEALTH

  • IDENTITY

  • LEGAL

  • LOCAL

  • LOOKUP_TABLES

  • MARKETING

  • MEDIA

  • SECURITY

  • SPORTS

  • TRANSPORTATION

  • TRAVEL

  • WEATHER

categories 예제

. . .
categories:
 - ECONOMY
. . .
Copy

data_attributes

데이터 특성은 컨슈머에게 목록에 대한 정보(새로 고침 빈도 및 기타 특징 등)에 대한 인사이트를 제공합니다.

data_attributes 필드는 비공개 목록의 경우 선택 사항이지만, 마켓플레이스 목록의 경우 필수입니다.

데이터 제품 특성에 대한 자세한 내용은 데이터 제품 - 특성 섹션을 참조하십시오.

다음 이름 값 쌍을 포함합니다.

  • data_attributes.refresh_rate (필수)

    Snowflake에서 데이터 제품이 업데이트되는 빈도를 지정합니다.

    다음 중 하나:

    • CONTINUOUSLY

    • HOURLY

    • DAILY

    • WEEKLY

    • MONTHLY

    • QUARTERLY

    • ANNUALLY

    • STATIC

  • data_attributes.geography (필수), 다음 포함:

    데이터 제품이 적용되는 리전 지역을 지정합니다.

    • granularity (문자열, 필수)

      데이터 세트의 지리적 범위입니다.

      다음 중 하나:

      • LATITUDE_LONGITUDE

      • ADDRESS

      • POSTAL_CODE

      • CITY

      • COUNTY

      • STATE

      • COUNTRY

      • REGION_CONTINENT

    • geo_option (문자열, 필수)

      다음 중 하나:

      • NOT_APPLICABLE

      • GLOBAL

      • COUNTRIES

    • coverage (geo_option 선택 시 필수), 다음 중 하나 포함:

      • states (문자열 목록), 유효한 미국 주 이름 목록 포함.

      Or

      • continents (문자열 목록):

        다음 중 하나:

        • ASIA

        • EUROPE

        • AFRICA

        • NORTH AMERICA

        • SOUTH AMERICA

        • OCEANIA

        • ANTARCTICA

    • time (필수), 다음 포함:

      데이터 제품이 적용되는 기간을 지정합니다.

      • granularity (필수)

      다음 중 하나:

      • EVENT_BASED

      • HOURLY

      • DAILY

      • WEEKLY

      • MONTHLY

      • YEARLY

      • time_range (필수), 다음 이름/값 페어 포함:

        • time_frame (필수)

          다음 중 하나:

          • NEXT

          • LAST

          • BETWEEN

        • unit (필수)

          다음 중 하나:

          • DAYS

          • WEEKS

          • MONTHS

          • YEARS

        • value (time_frame 이 NEXT/LAST인 경우 필수), 범위 1~100.

        • start_time (time_frame 이 BETWEEN인 경우 필수, 문자열 날짜), MM-DD-YYYY 형식.

        • end_time (time_frame 이 BETWEEN인 경우 필수, 문자열 날짜), MM-DD-YYYY 형식.

data_attributes 예제

. . .
data_attributes:
  refresh_rate: DAILY
  geography:
    granularity:
      - REGION_CONTINENT
    geo_option: COUNTRIES
    coverage:
      continents:
        ASIA:
          - INDIA
          - CHINA
        NORTH AMERICA:
          - UNITED STATES
          - CANADA
        EUROPE:
          - UNITED KINGDOM
  time:
    granularity: MONTHLY
    time_range:
      time_frame: LAST
      unit: MONTHS
      value: 6
Copy

data_dictionary

data_dictionary 필드를 통해 컨슈머는 계정에 목록을 설치하기 전에 목록의 내용과 정형화된 정보를 확인할 수 있습니다. 비공개 목록의 경우 선택 사항이지만, 마켓플레이스 목록의 경우 필수입니다.

data_dictionary 필드에는 최대 5개의 데이터 사전 항목 목록이 있습니다.

  • data_dictionary.featured (data_dictionary 사용 시 필수): ‘featured’이어야 함.

  • data_dictionary.featured.database (data_dictionary 사용 시 필수): 데이터베이스 이름입니다.

  • data_dictionary.featured.objects (data_dictionary 사용 시 필수): 이름 값 쌍의 목록입니다.

    • name (문자열, 필수): 오브젝트 이름

    • schema (문자열, 필수): 스키마

    • domain (필수):

      다음 중 하나:

      • DATABASE

      • SCHEMA

      • TABLE

      • VIEW

      • EXTERNAL_TABLE

      • MATERIALIZED_VIEW

      • DIRECTORY_TABLE

      • FUNCTION

      • COLUMN

데이터 제품 - 데이터 사전 도 참조하십시오.

data_dictionary 예제

. . .
data_dictionary:
 featured:
    database: "WEATHERDATA"
    objects:
       - name: "GLOBAL_WEATHER"
         schema: "PUBLIC"
         domain: "TABLE"
       - name: "GLOBAL_WEATHER_REPORT"
         schema: "PUBLIC"
         domain: "TABLE"
. . .
Copy

usage_examples

usage_examples 필드는 비공개 목록의 경우 선택 사항이지만, 마켓플레이스 목록의 경우 필수입니다.

다음 이름 값 쌍의 목록을 포함합니다.

  • usage.title (문자열, 필수): 사용 예제 제목으로, 최대 길이는 110자입니다.

  • usage.description (문자열, 선택 사항): 관련 설명으로, 최대 길이는 300자입니다.

  • usage.query (문자열, 필수): 사용 예제와 관련된 쿼리로, 최대 길이는 30,000자입니다.

자세한 내용은 샘플 SQL 쿼리 섹션을 참조하십시오.

usage_examples 예제

. . .
usage_examples:
  - title: "Return all weather for the US"
    description: "Example of how to select weather information for the United States"
    query: "select * from weather where country_code='USA'";
. . .
Copy

resources

리소스에는 목록에 대한 정보, 설명서 및 비디오 링크 등이 들어 있습니다.

resources 필드는 비공개 목록의 경우 선택 사항이지만, 마켓플레이스 목록의 경우 필수입니다.

다음 이름 값 쌍을 포함합니다.

  • resources.documentation (문자열, 필수): 목록에 대한 자세한 설명서가 있는 웹사이트 페이지로 연결되는 정규화된 링크입니다. http 또는 https 로 시작해야 합니다.

  • resources.media (문자열, 선택 사항): 목록에 대한 비공개 또는 공개 YouTube 비디오에 대한 정규화된 링크입니다.

자세한 내용은 목록 세부 정보 섹션을 참조하십시오.

resources 예제

. . .
resources:
  documentation: https://www.example.com/documentation/
  media: https://www.youtube.com/watch?v=MEFlT3dc3uc
. . .
Copy

데이터 공유 목록에 대한 완전한 YAML 예

title: "Covid data listing"
subtitle: "Listing about covid"
description: "Example covid manifest"
profile: "MyProfile"
listing_terms:
  type: "STANDARD"
targets:
  accounts: ["Org1.Account1", "Org2.Account2"]
auto_fulfillment:
  refresh_schedule: "120 MINUTE"
  refresh_type: "SUB_DATABASE"
business_needs:
  - name: "Life Sciences Commercialization"
    description: "COVID-19 Epidemiological Data"
usage_examples:
  - title: "Get total case count by country"
    description: "Calculates the total number of cases by country, aggregated over time."
    query: "SELECT  COUNTRY_REGION, SUM(CASES) AS Cases FROM ECDC_GLOBAL GROUP BY COUNTRY_REGION;"
data_attributes:
  refresh_rate: HOURLY
  geography:
    granularity:
      - ADDRESS
    geo_option: COUNTRIES
    coverage:
      continents:
        ASIA:
          - INDIA
          - CHINA
        NORTH AMERICA:
          - UNITED STATES
          - CANADA
        EUROPE:
          - UNITED KINGDOM
  time:
    granularity: MONTHLY
    time_range:
      time_frame: BETWEEN
      start_date: 12-24-2020
      end_date: 12-25-2021
  resources:
    documentation: https://www.example.com/documentation/
    media: https://www.youtube.com/watch?v=MEFlT3dc3uc
categories:
 - HEALTH
Copy
언어: 한국어