ALTER SHARE¶
기존 공유 의 속성을 수정합니다.
계정 목록에 계정을 추가하거나 목록에서 제거합니다.
공유에 대한 해당 데이터베이스가 공유되는 계정의 새 목록을 설정합니다.
다른 속성을 수정합니다. 매개 변수 세부 정보는 매개 변수 를 참조하십시오.
- 참고 항목:
구문¶
ALTER SHARE [ IF EXISTS ] <name> { ADD | REMOVE } ACCOUNTS = <consumer_account> [ , <consumer_account> , ... ]
[ SHARE_RESTRICTIONS = { TRUE | FALSE } ]
ALTER SHARE [ IF EXISTS ] <name> ADD ACCOUNTS = <consumer_account> [ , <consumer_account> , ... ]
[ SHARE_RESTRICTIONS = { TRUE | FALSE } ]
ALTER SHARE [ IF EXISTS ] <name> SET { [ ACCOUNTS = <consumer_account> [ , <consumer_account> ... ] ]
[ COMMENT = '<string_literal>' ] }
ALTER SHARE [ IF EXISTS ] <name> SET TAG <tag_name> = '<tag_value>' [ , <tag_name> = '<tag_value>' ... ]
ALTER SHARE <name> UNSET TAG <tag_name> [ , <tag_name> ... ]
ALTER SHARE [ IF EXISTS ] <name> UNSET COMMENT
매개 변수¶
name
변경할 공유의 식별자를 지정합니다. 식별자에 공백이나 특수 문자가 포함된 경우 전체 문자열을 큰따옴표로 묶어야 합니다. 큰따옴표로 묶인 식별자도 대/소문자를 구분합니다.
ADD | REMOVE ACCOUNTS = consumer_account [ , consumer_account , ... ]
공유에 대한 계정 목록에 추가하거나 목록에서 제거할 계정의 이름을 지정합니다.
목록에 이미 있는 공유에 계정을 추가해도 아무런 영향이 없습니다.
이미 공유 데이터베이스를 가져온 계정을 제거하는 즉시 데이터베이스에 대한 해당 계정의 액세스 권한이 취소됩니다. 나중에 계정을 공유에 다시 추가할 경우 계정이 데이터베이스를 다시 만들어야 다시 사용할 수 있습니다.
공유 계정의 목록에 아직 없는 계정을 공유에서 제거해도 아무런 영향이 없습니다.
이 매개 변수는 공유에 대한 기존 계정 목록에 추가(또는 제거)합니다. 전체 계정 목록을 바꾸려면
SET
를 대신 사용하십시오.SHARE_RESTRICTIONS = { TRUE | FALSE }
FALSE
: Standard 또는 Enterprise 컨슈머 계정을 Business Critical 공급자 계정에 속하는 공유에 추가할 수 있습니다.TRUE
: Standard 또는 Enterprise 컨슈머 계정을 Business Critical 공급자 계정에 속하는 공유에 추가할 수 없습니다.- 기본값:
TRUE
중요
Business Critical 공급자에게 속한 공유에 Business Critical이 아닌 컨슈머 계정을 새로 추가할 때마다 이 매개 변수를 설정해야 합니다. 자세한 내용은 Business Critical 계정에서 Business Critical 외 계정으로 공유 활성화하기 를 참조하십시오.
SET...
ACCOUNTS = consumer_account [ , consumer_account ... ]
공유를 공유한 이전의 모든 계정을 바꿀 계정을 지정합니다. 목록에서 개별 계정을 추가/제거하려면
ADD | REMOVE
를 대신 사용하십시오.
TAG tag_name = 'tag_value' [ , tag_name = 'tag_value' , ... ]
태그 이름과 태그 문자열 값을 지정합니다.
태그 값은 항상 문자열이며, 태그 값의 최대 문자 수는 256자입니다.
문에서 태그를 지정하는 방법에 대한 자세한 내용은 오브젝트 및 열에 대한 태그 할당량 섹션을 참조하십시오.
COMMENT = 'string'
공유에 대한 설명을 추가하거나 기존 설명을 덮어씁니다.
UNSET ...
공유에 대해 설정 해제할 속성/매개 변수를 하나 이상 지정하여 다시 기본값으로 재설정합니다.
TAG tag_name [ , tag_name ... ]
COMMENT
사용법 노트¶
공유를 변경하려면 다음 권한 중 하나가 필요합니다.
공유를 생성하는 역할에 부여되는 OWNERSHIP 권한입니다.
CREATE SHARE 권한입니다. 기본적으로, ACCOUNTADMIN만 CREATE SHARE 권한을.갖습니다. ACCOUNTADMIN은 다른 역할에 권한을 부여할 수 있습니다. 공유의 소유자는 이 권한을 부여할 수 없습니다.
키워드
ACCOUNT
와ACCOUNTS
가 둘 다 지원되며 서로 바꿔서 사용할 수 있습니다.메타데이터 관련:
주의
고객은 Snowflake 서비스를 사용할 때 개인 데이터(사용자 오브젝트 제외), 민감한 데이터, 수출 통제 대상 데이터 또는 기타 규제 데이터가 메타데이터로 입력되지 않도록 해야 합니다. 자세한 내용은 Snowflake의 메타데이터 필드 섹션을 참조하십시오.
예¶
sales_s
로 명명된 기존 공유에 두 계정 추가:
ALTER SHARE sales_s ADD ACCOUNTS=<orgname.accountname1>,<orgname.accountname2>; +----------------------------------+ | status | |----------------------------------| | Statement executed successfully. | +----------------------------------+Copy
sales_s
에서 계정 <orgname.accountname>;
제거:
ALTER SHARE sales_s REMOVE ACCOUNT=<orgname.accountname>; +----------------------------------+ | status | |----------------------------------| | Statement executed successfully. | +----------------------------------+Copy
sales_s
에 대한 새 설명 설정:
ALTER SHARE sales_s SET COMMENT='This share contains sales data for 2017'; +----------------------------------+ | status | |----------------------------------| | Statement executed successfully. | +----------------------------------+Copy