CREATE ORGANIZATION LISTING¶
조직 목록을 만들어 조직 내에서 데이터 제품을 안전하게 공유하십시오.
구문¶
CREATE ORGANIZATION LISTING [ IF NOT EXISTS ] <name>
[ { SHARE <share_name> | APPLICATION PACKAGE <package_name> } ]
AS '<yaml_manifest_string>'
[ PUBLISH = { TRUE | FALSE } ]
[ REVIEW = { TRUE | FALSE } ]
매개 변수¶
name
목록의 식별자(이름)를 지정합니다. 식별자는 다음을 준수해야 합니다.
계정이 위치한 Snowflake Region에 관계없이 계정 내에서 고유해야 합니다. Uniform Listing Locator(ULL)는 조직 내에서 고유해야 합니다.
임베디드 달러 기호를 포함할 수 없습니다.
Snowflake 식별자 요구 사항을 준수해야 합니다. 식별자 요구 사항 을 참조하십시오.
SHARE share_name
목록에 첨부할 공유의 식별자를 지정합니다.
APPLICATION PACKAGE package_name
목록에 첨부된 애플리케이션 패키지를 지정합니다.
SHOW APPLICATION PACKAGES 도 참조하십시오.
AS 'yaml_manifest_string'
목록에 대한 YAML 형식의 매니페스트를 지정합니다. 매니페스트 파일 목록에 대한 자세한 내용과 예제는 목록 매니페스트 참조 섹션을 참조하십시오.
매니페스트는 일반적으로 달러 기호로 묶인 문자열로 제공됩니다. 자세한 내용은 달러로 묶인 문자열 상수 섹션을 참조하십시오.
PUBLISH = { TRUE | FALSE }
목록을 게시하는 방법을 지정합니다.
TRUE 인 경우 목록이 내부 마켓플레이스에 즉시 게시됩니다.
기본값: TRUE.
REVIEW = { TRUE | FALSE }
검토 및 승인을 위해 목록을 제출할지 여부를 지정합니다.
기본값: TRUE.
다음 표에는 다양한 PUBLISH 및 REVIEW 속성 조합과 관련 동작이 나열되어 있습니다.
PUBLISH
REVIEW
동작
TRUE
TRUE
검토를 요청한 후 승인 후 즉시 게시합니다.
TRUE
FALSE
오류를 반환합니다. 목록은 게시하기 전에 검토를 받아야 합니다.
FALSE
TRUE
자동 게시 없이 검토를 요청하십시오.
FALSE
FALSE
검토나 게시 없이 목록을 초안으로 저장합니다.
액세스 제어 요구 사항¶
이 SQL 명령을 실행하는 데 사용되는 역할 에는 최소한 다음 권한 중 하나가 있어야 합니다.
권한 |
오브젝트 |
참고 |
---|---|---|
CREATE ORGANIZATION LISTING 또는 CREATE DATA EXCHANGE LISTING |
계정 |
조직 목록을 만들고 변경하려면 다음을 수행합니다. |
이 SQL 명령을 실행하는 데 사용되는 역할은 다음 권한 중 하나를 가지고 있어야 합니다.
권한 |
오브젝트 |
참고 |
---|---|---|
USAGE |
SHARE |
지정된 공유를 목록에 첨부하려면 다음을 수행합니다. |
USAGE |
APPLICATION |
지정된 Snowflake Native App Framework 를 목록에 첨부합니다. |
사용법 노트¶
CREATE ORGANIZATION LISTING …을 사용하여 생성된 목록은 자동으로 게시됩니다.
예¶
이 예제에서는 매니페스트 YAML 에 지정된 설정을 사용하여 MYORGLISTING 이라는 이름의 목록을 만듭니다. 여기에는 한 리전의 한 계정에서 하나의 역할을 대상으로 하며 지원 및 승인자 연락처가 포함됩니다.
참고
support_contact
는 필수입니다. approver_contact
는 discovery
대상이 제공되는 경우에 필수입니다.
USE ROLE <organization_listing_role>;
CREATE ORGANIZATION LISTING MYORGLISTING
SHARE <share_name> AS
$$
title: "My title"
description: "One region, all accounts"
organization_profile: "INTERNAL"
organization_targets:
discovery:
- account: "<account_name>"
roles:
- "<role>"
access:
- account: "<account_name>"
roles:
- "<role>"
support_contact: "support@somedomain.com"
approver_contact: "approver@somedomain.com"
locations:
access_regions:
- name: "PUBLIC.<snowflake_region>"
$$
;