SHOW EXTERNAL VOLUMES¶
Lista os volumes externos da sua conta para os quais você tem privilégios de acesso.
A saída retorna metadados e propriedades do volume externo.
- Consulte também:
CREATE EXTERNAL VOLUME , DROP EXTERNAL VOLUME , ALTER EXTERNAL VOLUME , DESCRIBE EXTERNAL VOLUME
Sintaxe¶
SHOW EXTERNAL VOLUMES [ LIKE '<pattern>' ]
Parâmetros¶
LIKE 'pattern'Opcionalmente, 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%' .... padrão: sem valor (nenhuma filtragem é aplicada à saída).
Requisitos de controle de acesso¶
A função usada para executar essa operação deve ter, no mínimo, os seguintes privilégios:
Privilégio |
Objeto |
Notas |
|---|---|---|
USAGE |
Volume externo |
Para ver um volume externo específico na saída de SHOW EXTERNAL VOLUMES, uma função deve ter o privilégio USAGE nesse volume externo. |
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.
Saída¶
O comando de saída fornece propriedades de tabela e metadados nas seguintes colunas:
Coluna |
Descrição |
|---|---|
|
Nome do volume externo. |
|
Significa se o Snowflake pode gravar arquivos no(s) local(is) de armazenamento. |
|
Comentário para o volume externo. |
Notas de uso¶
O comando não precisa de um warehouse em funcionamento para ser executado.
O comando retorna apenas objetos para os quais a função atual do usuário atual recebeu pelo menos um privilégio de acesso.
O privilégio de acesso MANAGE GRANTS permite implicitamente que seu titular consulte todos os objetos da conta. Por padrão, somente o administrador de conta (usuários com a função ACCOUNTADMIN) e o administrador de segurança (usuários com a função SECURITYADMIN) têm o privilégio MANAGE GRANTS.
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. Você também pode usar o operador de canal para consultar a saída desse comando.
Exemplos¶
Mostrar todos os volumes externos:
SHOW EXTERNAL VOLUMES;
Mostrar todos os volumes externos cujo nome começa com aws que você tem privilégios para visualizar:
SHOW EXTERNAL VOLUMES LIKE 'aws%';