조직 목록 매니페스트 참조¶

조직 목록 접두사¶

각 조직 목록 매니페스트는 다음 필드로 시작됩니다.

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

• description (String, 선택 사항, 최대 길이 7500): 목록 설명입니다. 마크다운 구문이 지원됩니다.

• resources (String, 선택 사항): 목록에 대한 리소스입니다.

• listing_terms (하위 필드가 있는 상위 항목, 선택 사항): 목록에 대한 약관입니다.

• :code:`organization_profile`(문자열, 선택 사항): 사용자 지정 조직 프로필입니다(선택 사항). 지정하지 않으면 기본값은 INTERNAL입니다.

resources¶

목록에 대한 리소스입니다.

선택 사항 resources 필드에는 다음과 같은 이름 값 쌍이 포함됩니다.

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

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

이 필드에 포함할 수 있는 정보 유형에 대한 자세한 내용은 세부 정보 섹션을 참조하세요.

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

listing_terms¶

목록의 서비스 약관을 정의합니다.

선택 사항 listing_terms 필드에는 다음과 같은 이름 값 쌍이 포함됩니다.

• listing_terms.type

  • CUSTOM - CUSTOM`만 지원됩니다. :codenowrap:`listing_terms.type`이 지정된 경우 :codenowrap:`listing_terms.link 값도 지정해야 합니다.

• listing_terms.link: 공급자의 목록 약관에 대한 정규화된 링크로, http 또는 https 로 시작해야 합니다.

자세한 내용은 :ref:`label-configuring_metadata_for_data_listing`의 테이블에서 **서비스 약관**을 참조하세요.

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

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"
. . .

usage_examples¶

선택 사항 usage_examples 필드에는 다음 이름 값 쌍의 목록이 포함됩니다.

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

• usage.description (String, 선택 사항): 사용 예제에 대한 설명입니다. 최대 길이는 300자입니다.

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

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

. . .
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'";
. . .

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 선택에 따라 필수):

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

    Or

    • :code:`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:
  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

organization_targets¶

필수 organization_targets 필드는 목록을 검색하고 액세스할 수 있는 사용자를 정의합니다.

discovery 및 access 필드를 포함하며, 이 중 하나를 지정해야 합니다.

discovery

:code:`access`를 지정하지 않을 경우 필수, 지정할 경우 **선택 사항**입니다. 목록을 검색할 수 있는 사용자를 정의합니다. 입력하지 않으면 어떤 계정도 목록을 검색할 수 없습니다.

access

:code:`discovery`를 지정하지 않을 경우 필수, 지정할 경우 **선택 사항**입니다. 목록에 액세스할 수 있는 사용자를 정의합니다.

discovery 및 access 모두, 동일한 하위 필드를 포함합니다.

다음 중 하나를 수행합니다.

all_internal_accounts : {true | false}

`true`인 경우 모든 내부 계정은 목록을 찾거나 액세스할 수 있습니다. `false`인 경우 어떤 계정도 목록을 찾거나 액세스할 수 없습니다.

또는 계정 배열을 입력한 후 지정된 계정 내에 roles 배열(선택 사항)을 입력합니다.

- account: "<계정_이름>"

roles 이 있으면 계정 내에서 목록에 액세스하거나 목록을 검색할 수 있는 역할 목록을 지정합니다. 예:

… roles: [ 'role1','role2'] …

organization_target 예¶

다음 예제는 discovery 및 access 필드의 다양한 조합을 보여줍니다.

. . .
organization_targets:
   discovery:
   - all_internal_accounts : true
   access:
   - all_internal_accounts : true
. . .

. . .
organization_targets:
   discovery:
   - all_internal_accounts : true
   access:
   - account: 'finance'
. . .

. . .
organization_targets:
   discovery:
   - all_internal_accounts : true
   access:
   - account: 'finance'
   - account: 'credit'
. . .

. . .
organization_targets:
    discovery:
    - all_internal_accounts : true
    access:
    - account: 'finance'

      roles: [ 'accounting','debit']
. . .

support_contact¶

목록과 관련된 지원 정보에 대한 이메일 주소입니다.

discovery 필드가 지정된 경우 **필수**입니다.

. . .
support_contact: "support@exampledomain.com"
. . .

approver_contact¶

목록 승인자의 이메일 주소입니다.

discovery 필드가 지정된 경우 **필수**입니다.

. . .
  approver_contact: "approver@exampledomain.com"
. . .

Copy

request_approval_type¶

Define whether approval requests and approvals will happen inside or outside of Snowflake. Specify one of the following values:

• NULL

• REQUEST_AND_APPROVE_IN_SNOWFLAKE indicates access requests are submitted and approved within the Snowflake environment.

• REQUEST_AND_APPROVE_OUTSIDE_SNOWFLAKE indicates the provider manages access request submissions and approvals independently.

The value for external listings is always NULL.

. . .
  request_approval_type: "REQUEST_AND_APPROVE_IN_SNOWFLAKE"
. . .

Copy

locations¶

목록을 검색하거나 액세스할 수 있는 선택 사항 locations 을 지정합니다.

access_regions 필드는 :code:`locations`를 지정할 경우 **필수**이며 다음 하위 필드 중 하나를 포함해야 합니다.

• ALL - 모든 리전에서 목록을 검색하거나 액세스할 수 있습니다.

• 목록을 검색하거나 액세스할 수 있는 PUBLIC 접두사가 붙은 리전 이름의 배열입니다. 예: access_regions: - name: PUBLIC.AWS_US_WEST_2.

  . . .
  locations:
    access_regions:
    - name: "<names | ALL>"
  . . .
  

  Copy

전체 리전 목록은 SHOW REGIONS 섹션을 참조하십시오.

auto_fulfillment.refresh_schedule examples¶

The following example refreshes the data product associated with a listing every 10 minutes:

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

The following example refreshes the data product associated with a listing on specific days and times in specific regions:

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

The following example enables the refresh frequency override for listings that share the same database but have different refresh frequencies:

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

Snowflake Native App auto_fulfillment example¶

SUB_DATABASE_WITH_REFERENCE_USAGE can only be used with application packages and cannot be combined with auto_fulfillment.refresh_schedule.

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

Object level auto_fulfillment example¶

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