ALTER LISTING

목록 의 속성을 수정합니다.

참고 항목:

CREATE LISTING, DESCRIBE LISTING, SHOW LISTINGS, DROP LISTING, 목록 매니페스트 참조

구문

ALTER LISTING [ IF EXISTS ] <name>
  [ { PUBLISH | UNPUBLISH } ]
  [ COMMENT = '<string>'' ]

ALTER LISTING [ IF EXISTS ] <name> [ { PUBLISH | UNPUBLISH } ]
  [ COMMENT = '<string>'' ]

ALTER LISTING [ IF EXISTS ] <name> AS '<yaml_manifest_string>'
  [ PUBLISH={ TRUE | FALSE } ]
  [ REVIEW= { TRUE | FALSE } ]
  [ COMMENT = '<string>' ]

ALTER LISTING [ IF EXISTS ] <name> RENAME TO <new_name>;

ALTER LISTING [ IF EXISTS ] <name> SET COMMENT = '<string>'
Copy

매개 변수

name

변경 중인 목록에 대한 식별자(즉, 이름)를 지정합니다.

yaml_manifest_string

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

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

RENAME TO new_name

목록의 새 식별자를 지정합니다. 식별자는 고유해야 합니다. 다른 목록에 대해 식별자가 이미 준비되어 있으면 새 식별자를 사용할 수 없습니다.

{ PUBLISH | UNPUBLISH }

목록에 대해 수행할 동작을 지정합니다.

  • PUBLISH 이전에는 검색할 수 없었던 목록을 검색할 수 있게 만듭니다.

    이전에 게시한 목록에 PUBLISH를 지정해도 효과가 없습니다.

  • UNPUBLISH 이전에 검색 가능했던 목록을 새로운 컨슈머가 검색할 수 없도록 설정합니다. 기존 컨슈머는 게시되지 않은 목록과 관련된 데이터에 계속 액세스할 수 있습니다.

    이전에 게시 취소한 목록에 UNPUBLISH를 지정해도 효과가 없습니다.

목록 게시 취소하기 도 참조하십시오.

SET ...

목록에 설정할 하나 이상의 속성을 지정합니다(공백, 쉼표 또는 줄 바꿈으로 구분됨).

COMMENT = 'string_literal'

기존 목록에 대한 설명을 추가하거나 기존 설명을 덮어씁니다.

PUBLISH = { TRUE | FALSE }

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

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

기본값: TRUE.

REVIEW =  { TRUE | FALSE }

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

기본값: TRUE.

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

PUBLISH

REVIEW

동작

TRUE

TRUE

검토를 요청한 후 승인 후 즉시 게시합니다.

TRUE

FALSE

오류가 발생합니다. 검토하지 않고는 Snowflake Marketplace 에 목록을 게시할 수 없습니다.

FALSE

TRUE

검토 후 자동으로 게시하지 않고 검토를 요청합니다.

FALSE

FALSE

검토나 게시를 요청하지 않고 목록을 초안으로 저장합니다.

사용법 노트

  • 초안이나 게시되지 않은 목록만 이름을 변경할 수 있습니다.

액세스 제어 요구 사항

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

권한

권한

오브젝트

참고

OWNERSHIP 또는 MODIFY

수정 중인 목록에서.

클라우드 간 자동 복제를 구성하기 위해 위임된 권한.

ALTER 명령이 자동 이행을 위해 매니페스트 콘텐츠를 수정하는 경우

계정이 클라우드 간 자동 복제를 설정하도록 허용하기 섹션을 참조하십시오.

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

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

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

예

업데이트된 매니페스트 파일을 사용하도록 목록 MY_LISTING을 변경합니다.

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

MYLISTING 목록을 변경하여 목록을 게시합니다.

ALTER LISTING MYLISTING PUBLISH;
Copy

MYLISTING 목록을 변경하여 목록 게시를 취소합니다.

ALTER LISTING MYLISTING UNPUBLISH;
Copy

MYLISTING 목록을 변경하고 새 설명을 설정합니다.

ALTER LISTING MYLISTING SET COMMENT = 'My listing is ready!';
Copy
언어: 한국어