ALTER SHARE

기존 공유 의 속성을 수정합니다.

  • 계정 목록에 계정을 추가하거나 목록에서 제거합니다.

  • 공유에 대한 해당 데이터베이스가 공유되는 계정의 새 목록을 설정합니다.

  • 다른 속성을 수정합니다. 매개 변수 세부 정보는 매개 변수 를 참조하십시오.

참고 항목:

CREATE SHARE , DROP SHARE , DESCRIBE SHARE , SHOW SHARES

구문

ALTER SHARE [ IF EXISTS ] <name> { ADD | REMOVE } 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
Copy

매개 변수

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 권한입니다.

    • MANAGE SHARE TARGET 권한에 따라 공유에서 계정을 추가하거나 제거할 수 있는 역할이 결정됩니다. MANAGE SHARE TARGET 권한을 부여받은 역할만 공유 계정 액세스 권한을 추가하거나 제거할 수 있습니다.

  • 키워드 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

MANAGE SHARE TARGET 을 역할에 부여하고 해당 역할을 사용하여 공유 대상을 관리합니다.

GRANT MANAGE SHARE TARGET ON ACCOUNT TO ROLE <role_name>;

GRANT ROLE <role_name> TO USER <user_name>;

USE ROLE <role_name>;

ALTER SHARE <data_share_name> ADD ACCOUNTS = <orgname.accountname1>,<orgname.accountname2>;
Copy

sales_s 에 대한 새 설명 설정:

ALTER SHARE sales_s SET COMMENT='This share contains sales data for 2017';

+----------------------------------+
| status                           |
|----------------------------------|
| Statement executed successfully. |
+----------------------------------+
Copy
언어: 한국어