ALTER LISTING¶
인라인 YAML 매니페스트가 있는 목록 또는 스테이지 위치에 있는 파일에서 속성을 수정합니다.
구문¶
ALTER LISTING [ IF EXISTS ] <name> [ { PUBLISH | UNPUBLISH | REVIEW } ]
ALTER LISTING [ IF EXISTS ] <name> AS '<yaml_manifest_string>'
[ PUBLISH={ TRUE | FALSE } ]
[ REVIEW= { TRUE | FALSE } ]
[ COMMENT = '<string>' ]
ALTER LISTING <name> ADD VERSION [ [ IF NOT EXISTS ] <version_name> ]
FROM <yaml_manifest_stage_location>
[ COMMENT = '<string>' ]
ALTER LISTING [ IF EXISTS ] <name> RENAME TO <new_name>;
ALTER LISTING [ IF EXISTS ] <name> SET COMMENT = '<string>'
매개 변수¶
name
변경할 목록의 식별자(이름)를 지정합니다.
{ PUBLISH | UNPUBLISH | REVIEW }
목록에서 수행할 작업입니다.
PUBLISH
이전에는 검색할 수 없었던 목록을 검색할 수 있게 만듭니다.이전에 게시한 목록에 PUBLISH를 지정해도 효과가 없습니다.
UNPUBLISH
이전에 검색 가능했던 목록을 새로운 컨슈머가 검색할 수 없도록 설정합니다. 기존 컨슈머는 게시되지 않은 목록과 관련된 데이터에 계속 액세스할 수 있습니다.이전에 게시 취소한 목록에 UNPUBLISH를 지정해도 효과가 없습니다.
목록 게시 취소 를 참조하십시오.
REVIEW
검토를 위해 목록을 제출합니다.
yaml_manifest_string
목록의 YAML 매니페스트입니다. 매니페스트 매개 변수는 목록 매니페스트 참조 섹션을 참조하십시오.
매니페스트는 일반적으로 달러 기호로 묶인 문자열로 제공됩니다. 자세한 내용은 달러 기호로 묶인 문자열 상수 섹션을 참조하십시오.
ADD VERSION version_name
추가할 버전의 고유한 버전 식별자를 지정합니다. 식별자에 공백, 특수 문자 또는 대/소문자가 혼합된 문자가 포함된 경우 전체 식별자를 큰따옴표로 묶어야 합니다. 큰따옴표로 묶인 식별자도 대/소문자를 구분합니다. 식별자 구문에 대한 자세한 내용은 식별자 요구 사항 을 참조하십시오.
FROM 'yaml_manifest_stage_location'
내부 또는 Snowflake Git 리포지토리 복제본 manifest.yml 파일의 경로를 지정합니다. 변경에 대해 Marketplace Ops의 검토가 필요한 경우 REVIEW 및 PUBLISH 작업을 사용하십시오.
RENAME TO new_name
목록의 이름을
new_name
으로 변경합니다. 목록 이름은 고유해야 합니다. 다른 목록에 식별자가 이미 사용 중인 경우에는 새 식별자를 사용할 수 없습니다.
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
를 사용하여 변경 사항을 삭제해야 합니다.
액세스 제어 요구 사항¶
이 작업을 실행하는 데 사용되는 역할 에는 최소한 다음 권한 이 있어야 합니다.
권한 |
오브젝트 |
참고 |
---|---|---|
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 REVIEW;
목록을 게시하여 MYLISTING 목록을 변경합니다.
ALTER LISTING MYLISTING PUBLISH;
게시를 취소하여 MYLISTING 목록을 변경합니다.
ALTER LISTING MYLISTING UNPUBLISH;
새 설명을 설정하여 MYLISTING 목록을 변경합니다.
ALTER LISTING MYLISTING SET COMMENT = 'My listing is ready!';
지정된 YAML 매니페스트 파일 스테이지 위치에서 새 버전을 추가합니다.
ALTER LISTING MYLISTING ADD VERSION V3 FROM @dbforstage.public.listingstage/listingmanifests;