DROP SHARE

Remove o compartilhamento especificado do sistema e imediatamente revoga o acesso para todos os consumidores (ou seja, contas que criaram um banco de dados a partir do compartilhamento).

Consulte também:

CREATE SHARE , ALTER SHARE , SHOW SHARES , DESCRIBE SHARE

Sintaxe

DROP SHARE <name>
Copy

Parâmetros

name

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

Notas de uso

  • Somente o proprietário do compartilhamento, a função com o privilégio OWNERSHIP no compartilhamento, tem privilégios para descartar um compartilhamento. A execução desse comando com qualquer outra função retorna um erro.

  • Não é possível recuperar os compartilhamentos descartados; eles devem ser recriados.

  • O descarte de um compartilhamento não afeta o banco de dados do compartilhamento (ou qualquer um dos objetos do banco de dados).

Importante

Antes de descartar um compartilhamento, considere o impacto a jusante da realização desta operação:

  • As contas de consumidores que criaram bancos de dados a partir do compartilhamento não poderão mais consultar esses bancos de dados.

  • Recriar uma ação com o mesmo nome de uma ação anterior não restaura os bancos de dados criados (por qualquer consumidor) a partir do compartilhamento. Cada consumidor deve criar um novo banco de dados a partir do novo compartilhamento.

  • Um compartilhamento descartado não pode ser restaurado. O compartilhamento deve ser criado novamente usando o comando CREATE SHARE e depois configurado usando GRANT <privilégio> … TO SHARE e ALTER SHARE.

Exemplos

DROP SHARE sales_s;

+-------------------------------+
| status                        |
|-------------------------------|
| SALES_S successfully dropped. |
+-------------------------------+
Copy