DESCRIBE SHARE

Descreve os objetos de dados que estão incluídos em um compartilhamento.

DESCRIBE pode ser abreviado como DESC.

Consulte também:

DROP SHARE , ALTER SHARE , CREATE SHARE , SHOW SHARES

Sintaxe

Provedores (compartilhamento de saída)

DESC[RIBE] SHARE <name>
Copy

Consumidores (compartilhamento de entrada)

DESC[RIBE] SHARE <provider_account>.<share_name>
Copy

Parâmetros

name

Especifica o identificador da ação de saída a ser descrita. 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.

provider_account.share_name

Especifica o identificador totalmente qualificado para o compartilhamento de entrada a ser descrito.

Notas de uso

  • Somente a função ACCOUNTADMIN tem o privilégio de descrever um compartilhamento. A execução deste comando com qualquer outra função além de ACCOUNTADMIN retorna um erro.

  • Para pós-processar a saída deste comando, você pode usar a função RESULT_SCAN, que trata a saída como uma tabela que pode ser consultada.

Saída

  • A saída do comando é diferente, dependendo se você é um provedor ou consumidor:

    • Para os provedores, os nomes dos objetos no compartilhamento são prefixados com o nome do banco de dados.

    • Para os consumidores, os nomes dos objetos no compartilhamento são prefixados com um nome de banco de dados somente se um banco de dados tiver sido criado a partir do compartilhamento. Se não tiver sido criado um banco de dados a partir do compartilhamento, os objetos serão prefixados com <DB>.

  • A coluna kind na saída exibe o tipo dos objetos no compartilhamento.

Exemplos

Como provedor, exibir os objetos no compartilhamento sales_s:

DESC SHARE sales_s;

+----------+--------------------------------------+-------------------------------+
| kind     | name                                 | shared_on                     |
|----------+--------------------------------------+-------------------------------|
| DATABASE | SALES_DB                             | 2017-06-15 17:03:16.642 -0700 |
| SCHEMA   | SALES_DB.AGGREGATES_EULA             | 2017-06-15 17:03:16.790 -0700 |
| TABLE    | SALES_DB.AGGREGATES_EULA.AGGREGATE_1 | 2017-06-15 17:03:16.963 -0700 |
+----------+--------------------------------------+-------------------------------+
Copy

Como consumidor, exibir os objetos no compartilhamento sales_s fornecida pela conta ab67890:

DESC SHARE ab67890.sales_s;

+----------+----------------------------------+---------------------------------+
| kind     | name                             | shared_on                       |
|----------+----------------------------------+---------------------------------|
| DATABASE | <DB>                             | Thu, 15 Jun 2017 17:03:16 -0700 |
| SCHEMA   | <DB>.AGGREGATES_EULA             | Thu, 15 Jun 2017 17:03:16 -0700 |
| TABLE    | <DB>.AGGREGATES_EULA.AGGREGATE_1 | Thu, 15 Jun 2017 17:03:16 -0700 |
+----------+----------------------------------+---------------------------------+
Copy

Neste exemplo, ainda não foi criado um banco de dados na conta do consumidor a partir do compartilhamento sales_s.

Linguagem: Português