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 o operador de canal (
->>) ou a função RESULT_SCAN. Ambos os constructos tratam a saída como um conjunto de resultados que você pode consultar.For example, you can use the pipe operator or RESULT_SCAN function to select specific columns from the SHOW command output or filter the rows.
When you refer to the output columns, use double-quoted identifiers for the column names. For example, to select the output column
type, specifySELECT "type".You must use double-quoted identifiers because the output column names for SHOW commands are in lowercase. The double quotes ensure that the column names in the SELECT list or WHERE clause match the column names in the SHOW command output that was scanned.
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%';