CREATE SHARE

Cria um novo compartilhamento vazio. Uma vez criado o compartilhamento, você pode incluir um banco de dados e objetos do banco de dados (esquemas, tabelas e visualizações) nele usando o comando GRANT <privilégio> … TO SHARE. Você pode então usar ALTER SHARE para adicionar uma ou mais contas ao compartilhamento.

Consulte também:

DROP SHARE , ALTER SHARE , SHOW SHARES , DESCRIBE SHARE

Sintaxe

CREATE [ OR REPLACE ] SHARE [ IF NOT EXISTS ] <name>
  [ COMMENT = '<string_literal>' ]
Copy

Parâmetros obrigatórios

name

Especifica o identificador da ação; deve ser único para a conta na qual a ação é criada.

Além disso, o identificador deve começar com um caractere alfabético e não pode conter espaços ou caracteres especiais, a menos que toda a cadeia de caracteres do identificador esteja entre aspas duplas (por exemplo, "My object"). Os identificadores delimitados por aspas duplas também diferenciam letras maiúsculas de minúsculas.

Para obter mais detalhes, consulte Requisitos para identificadores.

Parâmetros opcionais

COMMENT = 'string_literal'

Especifica um comentário para o compartilhamento.

Padrão: sem valor

Requisitos de controle de acesso

Uma função usada para executar este comando SQL deve ter os seguintes privilégios no mínimo:

Privilégio

Objeto

Notas

CREATE SHARE

Conta

Only the ACCOUNTADMIN role has this privilege by default. The privilege can be granted to additional roles as needed.

Para instruções sobre como criar uma função personalizada com um conjunto específico de privilégios, consulte Criação de funções personalizadas.

Para informações gerais sobre concessões de funções e privilégios para executar ações de SQL em objetos protegíveis, consulte Visão geral do controle de acesso.

Para obter mais informações sobre os requisitos de controle de acesso para o Snowflake Secure Data Sharing especificamente, consulte Habilitação de funções diferentes de ACCOUNTADMIN para executar tarefas de compartilhamento de dados.

Notas de uso

  • 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.

  • Instruções CREATE OR REPLACE <object> são atômicas. Ou seja, quando um objeto é substituído, o objeto antigo é excluído e o novo objeto é criado em uma única transação.

Exemplos

Criar um compartilhamento vazio com nome sales_s:

CREATE SHARE sales_s;
Copy
+-----------------------------------------+
| status                                  |
|-----------------------------------------|
| Share SALES_S successfully created.     |
+-----------------------------------------+

Depois de criar o compartilhamento, conclua-o executando os seguintes comandos:

  1. Execute o comando GRANT <privilégio> … TO SHARE para adicionar um banco de dados (e objetos no banco de dados) ao compartilhamento.

  2. Execute o comando ALTER SHARE para adicionar contas ao compartilhamento.