ALTER 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>'
매개 변수¶
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 *" $$
목록을 게시하여 MYLISTING 목록을 변경합니다.
ALTER LISTING MYLISTING PUBLISH;
게시를 취소하여 MYLISTING 목록을 변경합니다.
ALTER LISTING MYLISTING UNPUBLISH;
새 설명을 설정하여 MYLISTING 목록을 변경합니다.
ALTER LISTING MYLISTING SET COMMENT = 'My listing is ready!';