CREATE SHARE
CREATE SHARE
CREATE SHARE 명령은 새롭고 비어 있는 공유(share)를 만드는 명령이에요. 공유를 만든 후엔 데이터베이스와 그 객체를 공유에 포함시킬 수 있습니다.
출처: CREATE SHARE
본문
새롭고 비어 있는 공유를 만드는 명령입니다. 공유가 생성되면 GRANT <privilege> … TO SHARE 명령을 사용해 데이터베이스와 그 데이터베이스의 객체(스키마, 테이블, 뷰)를 공유에 포함시킬 수 있고, ALTER SHARE를 사용해 공유에 계정을 하나 이상 추가할 수 있어요.
참고 프로바이더 공유는 모든 계정에서 기본적으로 활성화되는 것은 아니에요. 컨슈머와 데이터를 공유하려고 할 때 오류가 발생하면 계정에 이 기능이 활성화되지 않았을 수 있습니다. 활성화 문의는 Snowflake Support에 연락하세요.
이 명령은 다음 변형을 지원해요: DROP SHARE, ALTER SHARE, SHOW SHARES, DESCRIBE SHARE
Syntax
CREATE [ OR REPLACE ] SHARE [ IF NOT EXISTS ] <name>
[ COMMENT = '<string_literal>' ]
Variant syntax
CREATE OR ALTER SHARE
이미 존재하지 않으면 새 공유를 만들고, 존재하면 그 공유를 문에 정의된 공유로 변환해요. CREATE OR ALTER SHARE 문은 CREATE SHARE 문의 구문 규칙을 따르며 ALTER SHARE 문과 동일한 제한 사항을 가집니다.
CREATE OR ALTER SHARE <name>
[ COMMENT = '<string_literal>' ]
Required parameters (필수 파라미터)
name— 공유의 식별자를 지정해요. 공유가 생성되는 계정 내에서 고유해야 합니다. 또한 식별자는 알파벳 문자로 시작해야 하고, 전체 식별자 문자열을 큰따옴표로 감싸지 않는 한 공백이나 특수 문자를 포함할 수 없어요 (예:"My object"). 큰따옴표로 감싼 식별자는 대소문자를 구분합니다. 자세한 내용은 Identifier requirements 문서를 참고하세요.
Optional parameters (선택 파라미터)
COMMENT = '<string_literal>'— 공유에 대한 주석을 지정해요. 기본값: 값 없음
Access control requirements (접근 제어 요구 사항)
이 작업을 실행하는 데 사용되는 역할은 최소한 다음 권한을 보유해야 해요.
지정된 권한 집합으로 사용자 정의 역할을 만드는 방법은 Creating custom roles 문서를, 보안 객체에 대한 SQL 작업의 역할·권한 부여에 대한 일반적인 정보는 Overview of Access Control 문서를 참고하세요. Snowflake Secure Data Sharing에 대한 접근 제어 요구 사항은 Enable non-ACCOUNTADMIN roles to perform data sharing tasks 문서를 참고하세요.
Usage notes (사용 참고 사항)
공유는 데이터 공유를 위한 핵심 객체예요. 공유를 만든 후 GRANT로 객체를 추가하고 ALTER SHARE로 계정을 추가해 사용합니다.
Examples (예제)
sales_s라는 빈 공유를 만들어 봅시다.
CREATE SHARE sales_s;
+-----------------------------------------+
| status |
|-----------------------------------------|
| Share SALES_S successfully created. |
+-----------------------------------------+
공유를 만든 후 다음 명령들을 실행해 공유를 완성해요.
CREATE OR ALTER SHARE
새 공유를 만들거나 기존 공유의 주석을 업데이트해 봅시다.
CREATE OR ALTER SHARE sales_s
COMMENT = 'Sales data share for consumer accounts';