ALTER SHARE

Modifica as propriedades de um compartilhamento existente:

  • Adiciona ou remove contas da lista de contas.

  • Define uma nova lista de contas com as quais o banco de dados correspondente para o compartilhamento é compartilhado.

  • Modifica outras propriedades. Para detalhes dos parâmetros, consulte Parâmetros.

Consulte também:

CREATE SHARE , DROP SHARE , DESCRIBE SHARE , SHOW SHARES

Sintaxe

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
Copy

Parâmetros

name

Especifica o identificador do compartilhamento a ser alterado. Se o identificador contiver espaços ou caracteres especiais, toda a cadeia de caracteres deverá ser delimitada por aspas duplas. Os identificadores delimitados por aspas duplas também diferenciam letras maiúsculas de minúsculas.

ADD | REMOVE ACCOUNTS = consumer_account [ , consumer_account , ... ]

Especifica o nome da(s) conta(s) a adicionar ou remover da lista de contas para o compartilhamento:

  • Adicionar uma conta a um compartilhamento que já estava na lista não tem nenhum efeito.

  • A remoção de uma conta que já importou o banco de dados compartilhado revoga imediatamente o acesso dessa conta ao banco de dados. Se a conta for posteriormente adicionada de volta ao compartilhamento, a conta deverá recriar o banco de dados antes que eles possam utilizá-lo novamente.

  • A remoção de uma conta de um compartilhamento que ainda não estava na lista de contas compartilhadas não tem nenhum efeito.

Este parâmetro adiciona (ou remove) a lista existente de contas para o compartilhamento. Se você quiser substituir toda a lista de contas, use SET em seu lugar.

SHARE_RESTRICTIONS = { TRUE | FALSE }

FALSE: uma conta de consumidor Standard ou Enterprise pode ser adicionada a um compartilhamento pertencente a uma conta de provedor Business Critical.

TRUE: uma conta de consumidor Standard ou Enterprise não pode ser adicionada a um compartilhamento pertencente a uma conta de provedor Business Critical.

Padrão:

TRUE

Importante

Você deve definir este parâmetro sempre que adicionar uma nova conta de consumidor diferente de Business Critical ao compartilhamento pertencente a um provedor Business Critical. Para obter mais informações, consulte, Habilitação do compartilhamento de uma conta Business Critical para outro tipo de conta.

SET...

ACCOUNTS = consumer_account [ , consumer_account ... ]

Especifica a(s) conta(s) a substituir todas as contas anteriores com as quais o compartilhamento foi compartilhado. Para adicionar/remover contas individuais da lista, use ADD | REMOVE em seu lugar.

TAG tag_name = 'tag_value' [ , tag_name = 'tag_value' , ... ]

Especifica o nome da tag e o valor da cadeia de caracteres dela.

O valor de tag é sempre uma cadeia de caracteres, e o número máximo de caracteres do valor da tag é 256.

Para obter informações sobre como especificar tags em uma instrução, consulte Cotas de tags para objetos e colunas.

COMMENT = 'string'

Adiciona um comentário ou substitui um comentário existente para o compartilhamento.

UNSET ...

Especifica uma ou mais propriedades/parâmetros a serem desativados para o compartilhamento, o que os restaura aos seus padrões:

  • TAG tag_name [ , tag_name ... ]

  • COMMENT

Notas de uso

  • Um dos seguintes privilégios é necessário para alterar um compartilhamento:

    • O privilégio OWNERSHIP que é concedido à função que cria o compartilhamento.

    • O privilégio CREATE SHARE. Por padrão, somente o ACCOUNTADMIN tem o privilégio CREATE SHARE. O ACCOUNTADMIN pode conceder o privilégio a qualquer outra função. O proprietário do compartilhamento não pode conceder este privilégio.

  • As palavras-chave ACCOUNT e ACCOUNTS são ambas suportadas e podem ser usadas de forma intercambiável.

  • Em relação aos metadados:

    Atenção

    Os clientes devem garantir que nenhum dado pessoal (exceto para um objeto do usuário), dados sensíveis, dados controlados por exportação ou outros dados regulamentados sejam inseridos como metadados ao usar o serviço Snowflake. Para obter mais informações, consulte Campos de metadados no Snowflake.

Exemplos

Adicione duas contas ao compartilhamento existente denominado sales_s:

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

+----------------------------------+
| status                           |
|----------------------------------|
| Statement executed successfully. |
+----------------------------------+
Copy

Remover conta <orgname.accountname>; de sales_s:

ALTER SHARE sales_s REMOVE ACCOUNT=<orgname.accountname>;

+----------------------------------+
| status                           |
|----------------------------------|
| Statement executed successfully. |
+----------------------------------+
Copy

Definir um novo comentário para sales_s:

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

+----------------------------------+
| status                           |
|----------------------------------|
| Statement executed successfully. |
+----------------------------------+
Copy