CREATE LISTING¶

무료 목록 을 생성하여 특정 컨슈머와 직접 공유합니다.

참고 항목:: ALTER LISTING, DESCRIBE LISTING, SHOW LISTINGS, DROP LISTING, 목록 매니페스트 참조

구문¶

CREATE EXTERNAL LISTING [ IF NOT EXISTS ] <name>
  [ { SHARE <share_name>  |  APPLICATION PACKAGE <package_name> } ]
  AS '<yaml_manifest_string>'
  [ PUBLISH = { TRUE | FALSE } ]
  [ REVIEW = { TRUE | FALSE } ]
  [ COMMENT = '<string>' ]

Copy

매개 변수¶

name

목록에 대한 식별자(즉, 이름)를 지정합니다. 식별자는 다음을 준수해야 합니다.

식별자는 계정이 위치한 Snowflake Region과 관계없이 조직 내에서 고유해야 합니다.
알파벳 문자로 시작해야 하며 밑줄(_)을 제외한 공백이나 특수 문자를 포함할 수 없습니다.

AS 'yaml_manifest_string'

목록에 대한 YAML 형식의 매니페스트를 지정합니다. 목록 매니페스트 파일에 대한 자세한 내용과 예는 목록 매니페스트 참조 섹션을 참조하십시오.

매니페스트는 일반적으로 달러 기호로 묶인 문자열로 제공됩니다. 자세한 내용은 달러로 묶인 문자열 상수 섹션을 참조하십시오.

SHARE share_name

목록에 첨부할 공유의 식별자를 지정합니다.

APPLICATION PACKAGE package_name

목록에 첨부된 애플리케이션 패키지를 지정합니다.

SHOW APPLICATION PACKAGES 도 참조하십시오.

PUBLISH = { TRUE | FALSE }

목록을 게시하는 방법을 지정합니다.

TRUE인 경우, 목록에 등록하는 즉시 Marketplace Ops에 목록이 게시되어 심사가 수행됩니다.

기본값: TRUE.

REVIEW = { TRUE | FALSE }

목록을 Marketplace Ops 검토에 제출해야 할지 여부를 지정합니다.

기본값: TRUE.

COMMENT = 'string_literal'

목록에 대한 설명을 지정합니다.

기본값: 값 없음

PUBLISH 및 REVIEW 속성의 값을 다르게 조합하면 다음과 같은 동작이 발생합니다.

PUBLISH	REVIEW	동작
TRUE	TRUE	검토를 요청한 후 승인 후 즉시 게시합니다.
TRUE	FALSE	오류가 발생합니다. 검토하지 않고는 Snowflake Marketplace 에 목록을 게시할 수 없습니다.
FALSE	TRUE	검토 후 자동으로 게시하지 않고 검토를 요청합니다.
FALSE	FALSE	검토나 게시를 요청하지 않고 목록을 초안으로 저장합니다.

액세스 제어 요구 사항¶

이 SQL 명령을 실행하는 데 사용되는 역할 에는 최소한 다음 권한 중 하나가 있어야 합니다.

권한	오브젝트	참고
CREATE DATA EXCHANGE LISTING	계정	Only the ACCOUNTADMIN role has this privilege by default. The privilege can be granted to additional roles as needed.
클라우드 간 자동 복제를 구성하기 위해 위임된 권한.	ALTER 명령이 자동 이행을 위해 매니페스트 콘텐츠를 수정하는 경우	계정이 클라우드 간 자동 복제를 설정하도록 허용하기 섹션을 참조하십시오.

스키마의 모든 오브젝트에 대해 작업하려면 상위 데이터베이스 및 스키마에 대한 USAGE 권한도 필요합니다.

이 SQL 명령을 실행하는 데 사용되는 역할 에는 최소한 다음 권한 중 하나가 있어야 합니다.

지정된 권한 세트로 사용자 지정 역할을 만드는 방법에 대한 지침은 사용자 지정 역할 만들기 섹션을 참조하십시오.

보안 오브젝트 에 대해 SQL 작업을 수행하기 위한 역할과 권한 부여에 대한 일반적인 정보는 액세스 제어의 개요 섹션을 참조하십시오.

사용법 노트¶

CREATE LISTING …를 사용하여 생성된 목록은 자동으로 게시됩니다. 게시 취소 및 게시 작업에 대한 자세한 내용은 ALTER LISTING 섹션을 참조하십시오.

예¶

지정된 매니페스트와 함께 이름이 ‘MYLISTING’인 목록을 만들고 검토 및 후속 게시를 위해 제출합니다.

SQL을 사용한 목록 관리와 관련된 추가 예제 및 사용 사례는 공급자로서 SQL로 목록 관리하기 - 예 섹션을 참조하십시오.

참고

이 예제에서는 PUBLISH 및 REVIEW의 기본값을 사용합니다.

CREATE EXTERNAL LISTING MYLISTING
SHARE MySHARE AS
$$
title: "MyListing"
subtitle: "Subtitle for MyListing"
description: "Description for MyListing"
listing_terms:
   type: "STANDARD"
targets:
    accounts: ["Org1.Account1"]
usage_examples:
    - title: "this is a test sql"
      description: "Simple example"
      query: "select *"
$$
;

Copy

초안으로 지정된 매니페스트를 사용하여 이름이 ‘MYLISTING’인 목록을 만듭니다.

CREATE EXTERNAL LISTING MYLISTING
SHARE MySHARE AS
$$
title: "MyListing"
subtitle: "Subtitle for MyListing"
description: "Description for MyListing"
listing_terms:
  type: "OFFLINE"
targets:
   regions: ["PUBLIC.AWS_US_EAST_1", "PUBLIC.AZURE_WESTUS2"]
usage_examples:
   - title: "this is a test sql"
     description: "Simple example"
     query: "select *"
$$ PUBLISH=FALSE REVIEW=FALSE;

Copy