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

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

사용법 노트

  • 목록은 DRAFT 상태에서만 이름을 변경할 수 있습니다.

  • 목록에 대한 YAML 형식 매니페스트의 라이브 버전을 설정할 때는 COMMIT 를 사용하여 변경 사항을 적용하거나 ABORT 를 사용하여 변경 사항을 삭제해야 합니다.

액세스 제어 요구 사항

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

권한

오브젝트

참고

OWNERSHIP 또는 MODIFY

수정 중인 목록에서.

ALTER 명령을 사용하여 자동 복제를 위한 매니페스트 내용을 수정하는 경우 클라우드 간 자동 복제를 구성하는 데 필요한 위임된 권한이 있는 역할을 사용해야 합니다. 계정이 클라우드 간 자동 복제를 설정하도록 허용하기 섹션을 참조하십시오.

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

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

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

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

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