SHOW SHARES

Lista todos os compartilhamentos disponíveis no sistema.

  • Compartilhamentos de saída (para consumidores) que tenham sido criados em sua conta (como provedor).

  • Compartilhamentos de entrada (de provedores) que estão disponíveis para consumo em sua conta.

Consulte também:

CREATE SHARE , ALTER SHARE , DROP SHARE , DESCRIBE SHARE

Sintaxe

SHOW SHARES [ LIKE '<pattern>' ]
            [ LIMIT <rows> [ FROM '<name_string>' ] ]
Copy

Parâmetros

LIKE 'pattern'

Filtra a saída do comando pelo nome do objeto. O filtro utiliza correspondência de padrão que não diferencia maiúsculas e minúsculas, com suporte para caracteres curinga SQL (% e _).

Por exemplo, os seguintes padrões retornam os mesmos resultados:

... LIKE '%testing%' ...
... LIKE '%TESTING%' ...
STARTS WITH 'name_string'

Filtra a saída do comando com base na cadeia de caracteres que aparecem no início do nome do objeto. A cadeia de caracteres deve ser delimitada entre aspas simples e há distinção entre maiúsculas e minúsculas. Por exemplo, os seguintes retornam resultados diferentes:

... STARTS WITH 'B' ...
... STARTS WITH 'b' ...
LIMIT rows [ FROM 'name_string' ]

Opcionalmente, limita o número máximo de linhas retornadas, ao mesmo tempo em que permite a «paginação» dos resultados. Observe que o número real de linhas retornadas pode ser inferior ao limite especificado (por exemplo, o número de objetos existentes é menor que o limite especificado).

A subcláusula opcional FROM 'name_string' serve efetivamente como um “cursor” para os resultados. Isso permite obter o número especificado de linhas seguindo a primeira linha cujo nome do objeto corresponde à cadeia de caracteres especificada:

  • A cadeia de caracteres deve ser delimitada entre aspas simples e há distinção entre maiúsculas e minúsculas.

  • A cadeia de caracteres não precisa incluir o nome completo do objeto; também é permitido usar nomes parciais.

Padrão: nenhum valor (nenhum limite é aplicado à saída)

Nota

Ambos FROM 'name_string' e STARTS WITH 'name_string' podem ser combinados na mesma instrução; no entanto, ambas as condições devem ser cumpridas ou elas se cancelam mutuamente e nenhum resultado é retornado.

Além disso, os objetos são devolvidos em ordem lexicográfica por nome, portanto FROM 'name_string' só retorna linhas com um valor lexicográfico maior que as linhas retornadas por STARTS WITH 'name_string'.

Por exemplo:

  • ... STARTS WITH 'A' LIMIT ... FROM 'B' não retornaria nenhum resultado.

  • ... STARTS WITH 'B' LIMIT ... FROM 'A' não retornaria nenhum resultado.

  • ... STARTS WITH 'A' LIMIT ... FROM 'AB' retornariam resultados (se alguma linha corresponder às cadeias de caracteres de entrada).

Notas de uso

  • O comando lista compartilhamentos somente para usuários com uma função que tem o privilégio IMPORT SHARE:

    Nota

    A execução deste comando sem privilégios suficientes retorna resultados vazios.

  • O comando não precisa de um warehouse em funcionamento para ser executado.

  • O comando retorna um máximo de 10 mil registros para o tipo de objeto especificado, como ditado pelos privilégios de acesso para a função usada para executar o comando; quaisquer registros acima do limite 10 mil não são retornados, mesmo com um filtro aplicado.

    Para visualizar resultados para os quais existem mais de 10.000 registros, consulte a visualização correspondente (se houver) em Snowflake Information Schema.

  • 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 coluna kind exibe:

    • INBOUND indica que o compartilhamento está disponível para consumo em sua conta (ou seja, você pode criar um banco de dados a partir do compartilhamento).

    • OUTBOUND indica que sua conta está compartilhando dados com outras contas e este compartilhamento foi criado em sua conta.

  • Para compartilhamentos OUTBOUND, se forem adicionadas contas ao compartilhamento, a coluna to exibirá essas contas. O número máximo de contas apresentadas nesta coluna é de três; no entanto, não há um limite rígido para o número de contas que podem ser adicionadas a um compartilhamento.

Exemplos

Mostrar todos os compartilhamentos criados em sua conta ou que estão disponíveis para consumo por sua conta:

SHOW SHARES;

+-------------------------------+----------+-------------------------+-----------------------+------------------+--------------+----------------------------------------+
| created_on                    | kind     | name                    | database_name         | to               | owner        | comment                                |
|-------------------------------+----------+-------------------------+-----------------------+------------------+--------------+----------------------------------------|
| 2016-07-09 19:18:09.821 -0700 | INBOUND  | SFC_SAMPLES.SAMPLE_DATA | SNOWFLAKE_SAMPLE_DATA |                  |              | Sample data sets provided by Snowflake |
| 2017-06-15 17:02:29.625 -0700 | OUTBOUND | AB67890.SALES_S         | SALES_DB              | XY12345, YZ23456 | ACCOUNTADMIN |                                        |
+-------------------------------+----------+-------------------------+-----------------------+------------------+--------------+----------------------------------------+
Copy

Mostrar todos os compartilhamentos criados em sua conta ou que estão disponíveis para consumo por sua conta com a cadeia de caracteres “SNOW”:

SHOW SHARES LIMIT 5 FROM 'SNOW';

+-------------------------------+----------+-------------------------+-----------------------+------------------+--------------+----------------------------------------+
| created_on                    | kind     | name                    | database_name  | to               | owner        | comment | listing_global_name |
|-------------------------------+----------+-------------------------+-----------------------+------------------+--------------+----------------------------------------|
| 2020-07-07 19:18:09.821 -0700 | OUTBOUND | EXAMPLE.SNOW_DATA       | EXAMPLE        |                  | ACCOUNTADMIN |         |                     |
| 2020-07-10 19:18:09.821 -0700 | OUTBOUND | EXAMPLE.DATA_SNOWS      | EXAMPLE        |                  | ACCOUNTADMIN |         |                     |
| 2022-08-18 12:02:29.625 -0700 | OUTBOUND | ALFALFA_DB.SNOW_DATA    | ALFALFA_DB     | AB12345, YZ23456 | ACCOUNTADMIN |         |                     |
| 2022-08-18 13:04:29.625 -0700 | OUTBOUND | SALES_DB.SNOW_SHARE     | SALES_DB       | AB12345          | ACCOUNTADMIN |         |                     |
| 2022-08-18 14:02:40.625 -0700 | OUTBOUND | SALES_DB.SNOWIER_SHARE  | SALES_DB       |                  | ACCOUNTADMIN |         |                     |
+-------------------------------+----------+-------------------------+-----------------------+------------------+--------------+----------------------------------------+
Copy

Mostrar todos os compartilhamentos criados em sua conta ou que estão disponíveis para consumo por sua conta que comecem com SNOW, classificados em ordem lexicográfica:

SHOW SHARES STARTS WITH 'SNOW' LIMIT 5 FROM 'A';

+-------------------------------+----------+-------------------------+-----------------------+------------------+--------------+----------------------------------------+
| created_on                    | kind     | name                   | database_name  | to               | owner        | comment | listing_global_name |
|-------------------------------+----------+-------------------------+-----------------------+------------------+--------------+----------------------------------------|
| 2020-07-07 19:18:09.821 -0700 | OUTBOUND | EXAMPLE.SNOW_DATA      | EXAMPLE        |                  | ACCOUNTADMIN |         |                     |
| 2022-08-18 12:02:29.625 -0700 | OUTBOUND | ALFALFA_DB.SNOW_DATA   | ALFALFA_DB     | AB12345, YZ23456 | ACCOUNTADMIN |         |                     |
| 2022-08-18 14:02:40.625 -0700 | OUTBOUND | SALES_DB.SNOWIER_SHARE | SALES_DB       |                  | ACCOUNTADMIN |         |                     |
| 2022-08-20 15:03:50.625 -0700 | OUTBOUND | SALES_DB.SNOWY_SHARE   | SALES_DB       |                  | ACCOUNTADMIN |         |                     |
| 2022-08-18 13:04:29.625 -0700 | OUTBOUND | SALES_DB.SNOW_SHARE    | SALES_DB       | AB12345          | ACCOUNTADMIN |         |                     |
+-------------------------------+----------+-------------------------+-----------------------+------------------+--------------+----------------------------------------+
Copy