SHOW SERVICE VOLUMES IN SERVICE¶

Lista os volumes de armazenamento para todas as instâncias de um serviço. Para cada volume montado, a saída inclui uma linha para cada contêiner que monta esse volume. A saída mostra apenas os volumes que estão montados em pelo menos um contêiner no serviço; volumes especificados, mas não utilizados por nenhum contêiner, não são incluídos.

Consulte também:: Visão geral do Snowpark Container Services, CREATE SERVICE, SHOW SERVICES, SHOW SERVICE INSTANCES IN SERVICE, SHOW SERVICE CONTAINERS IN SERVICE, SHOW <objetos>

Sintaxe¶

SHOW SERVICE VOLUMES IN SERVICE <name>

Copy

Parâmetros¶

name

Especifica o nome do serviço para o qual exibir a lista de volumes montados.

Nomes entre aspas para caracteres especiais ou nomes que diferenciam maiúsculas de minúsculas não são compatíveis.

Saída¶

A saída do comando fornece propriedades de volumes de serviço nas seguintes colunas:

Coluna	Descrição
`volume_name`	Nome do volume
`instance_id`	ID da instância do serviço, que é o índice da instância do serviço que começa em 0.
`container_name`	Nome do contêiner ao qual um volume está montado.
`volume_type`	Tipo do volume. Pode ser um dos seguintes tipos: `block` `stage` `local` `memory` Para uma descrição detalhada dos tipos de volume, consulte a especificação do serviço.
`size`	Tamanho do volume no formato `numberGi`.
`iops`	Aplicável somente a volumes de bloco. Mostra as operações de entrada/saída configuradas por segundo para cada volume de bloco.
`throughput`	Aplicável somente a volumes de bloco. Mostra a taxa de transferência configurada para cada volume de bloco.
`encryption`	Aplicável somente a volumes de área de preparação e de bloco. No caso de volumes de bloco, mostra o tipo de criptografia de volume configurado. Para uma descrição detalhada dos tipos de criptografia de volumes de bloco, consulte Suporte à criptografia para volumes de armazenamento em bloco. No caso de volumes de área de preparação, mostra o tipo de criptografia da área de preparação subjacente. O privilégio USAGE ou OWNERSHIP em uma área de preparação para o autor da chamada é necessário para obter as informações de criptografia da área de preparação.
`snapshot_used`	Aplicável somente a volumes de bloco. Mostra qual instantâneo foi utilizado para criar o volume. O instantâneo será listado nesta coluna somente se você estiver usando uma função que recebeu o privilégio USAGE ou OWNERSHIP no instantâneo.
`stage_source`	Aplicável somente a volumes de área de preparação. Mostra o nome totalmente qualificado de uma área de preparação utilizada para o volume.
`volume_mounts`	Lista de caminhos separados por vírgula, em que o volume está montado no contêiner especificado.

Se um campo for aplicável a tipos de volume específicos, ele será preenchido com NULL para todos os outros tipos de volume.

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
OWNERSHIP ou MONITOR	Serviço	Nenhum
OWNERSHIP ou USAGE	Instantâneo	Sem acesso a um instantâneo de armazenamento em bloco, o Snowflake preenche o campo `snapshot_used` com um erro de autorização, mas o comando não falha.
Qualquer um destes privilégios: OWNERSHIP ou USAGE	Estágio	Sem acesso a uma área de preparação, vamos preencher o campo de criptografia com um erro de autorização para volumes de área de preparação, mas o comando não falhará.

A operação em um objeto de esquema requer pelo menos um privilégio no banco de dados pai e um privilégio no esquema pai.

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.

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.

Por exemplo, você pode usar o operador de canal ou a função RESULT_SCAN para selecionar colunas específicas da saída do comando SHOW ou filtrar as linhas.

Quando você fizer referência a colunas de saída, use identificadores entre aspas duplas para os nomes das colunas. Por exemplo, para selecionar a coluna de saída type, especifique SELECT "type".

Você deve usar identificadores entre aspas duplas porque os nomes das colunas de saída para os comandos SHOW estão em minúsculas. As aspas duplas garantem que os nomes das colunas na lista SELECT ou na cláusula WHERE correspondam aos nomes das colunas na saída do comando SHOW que foi verificada.

O comando retorna um máximo de dez mil registros para o tipo de objeto especificado, conforme ditado pelos privilégios de acesso da função usada para executar o comando. Todos os registros acima do limite de dez mil registros não são retornados, mesmo com um filtro aplicado.

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

Exemplos¶

O exemplo a seguir lista os volumes para o serviço echo_service:

SHOW SERVICE VOLUMES IN SERVICE echo_service;

Copy

Exemplo de saída:

+----------------+-------------+----------------+-------------+--------+--------+------------+----------------+---------------+--------------+---------------------------+
| volume_name    | instance_id | container_name | volume_type |  size  |  iops  | throughput |   encryption   | snapshot_used | stage_source |       volume_mounts       |
+----------------+-------------+----------------+-------------+--------+--------+------------+----------------+---------------+--------------+---------------------------+
| block-volume-1 | 0           | main           | block       | 1Gi    | 3000   | 125        | SNOWFLAKE_SSE  | [NULL]        | [NULL]       | /tmp/block1               |
| block-volume-1 | 0           | secondary      | block       | 1Gi    | 3000   | 125        | SNOWFLAKE_SSE  | [NULL]        | [NULL]       | /data/shared              |
| block-volume-2 | 0           | main           | block       | 50Gi   | 3500   | 150        | SNOWFLAKE_FULL | [NULL]        | [NULL]       | /tmp/block2               |
| local-volume   | 0           | main           | local       | [NULL] | [NULL] | [NULL]     | [NULL]         | [NULL]        | [NULL]       | /tmp/local                |
| memory-volume  | 0           | main           | memory      | 512Mi  | [NULL] | [NULL]     | [NULL]         | [NULL]        | [NULL]       | /tmp/memory, /tmp/memory2 |
| memory-volume  | 0           | secondary      | memory      | 512Mi  | [NULL] | [NULL]     | [NULL]         | [NULL]        | [NULL]       | /cache/memory             |
+----------------+-------------+----------------+-------------+--------+--------+------------+----------------+---------------+--------------+---------------------------+