SHOW SERVICE CONTAINERS IN SERVICE

Lista os contêineres em todas as instâncias de um serviço.

Se o Snowflake encontrar problemas ao executar um ou mais contêineres de serviço, este comando fornecerá visibilidade do status de contêineres individuais. Da mesma forma, durante uma atualização contínua, ele mostra a versão do seu código de serviço em execução em cada contêiner.

Consulte também:

Visão geral do Snowpark Container Services, CREATE SERVICE, SHOW SERVICES, SHOW SERVICE INSTANCES IN SERVICE

Sintaxe

SHOW SERVICE CONTAINERS IN SERVICE <name>
Copy

Parâmetros

name

Especifica o identificador do serviço cujos contêineres devem ser listados.

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

Saída

A saída do comando fornece propriedades e metadados dos contêineres de serviço nas seguintes colunas:

Coluna

Descrição

database_name

Banco de dados no qual o serviço é criado.

schema_name

Esquema no qual o serviço é criado.

service_name

Nome do serviço.

instance_id

ID da instância de serviço (este é o índice da instância de serviço que começa em 0).

container_name

Nome do contêiner.

status

Status do contêiner de serviço. Os valores de status compatíveis atualmente incluem o seguinte:

  • PENDING: O contêiner está sendo implementado no momento.

  • READY: O contêiner foi iniciado e a sonda de prontidão retornou o status HTTP 200 OK.

  • DONE: O contêiner saiu com um código de saída 0.

  • FAILED: O contêiner saiu com um código de saída diferente de zero (o código de saída 0 indica sucesso).

  • UNKNOWN: O Snowflake não conseguiu recuperar o status do contêiner. Contato com o suporte

message

Esclarecimento adicional sobre o status. Por exemplo, quando o status é FAILED, o Snowflake pode fornecer informações adicionais.

image_name

Nome da imagem usada para criar o serviço.

image_digest

O identificador único e imutável que representa o conteúdo da imagem.

restart_count

Número de vezes que o Snowflake reiniciou o serviço.

start_time

Data e hora em que o contêiner foi iniciado.

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

Qualquer um destes privilégios: OWNERSHIP ou MONITOR

Serviço

O privilégio USAGE no banco de dados e no esquema pai é necessário para executar operações em qualquer objeto de um esquema.

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

  • 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.

Exemplos

O exemplo a seguir lista os contêineres do serviço echo_service no banco de dados atual e o esquema para a sessão:

SHOW SERVICE CONTAINERS IN SERVICE echo_service;
Copy

Exemplo de saída:

+---------------+-------------+--------------+-------------+----------------+--------+---------+---------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------+---------------+----------------------+
| database_name | schema_name | service_name | instance_id | container_name | status | message | image_name                                                                                                                | image_digest                                                            | restart_count | start_time           |
|---------------+-------------+--------------+-------------+----------------+--------+---------+---------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------+---------------+----------------------|
| TUTORIAL_DB   | DATA_SCHEMA | ECHO_SERVICE | 0           | echo           | READY  | Running | orgname-acctname.registry.snowflakecomputing.com/tutorial_db/data_schema/tutorial_repository/my_echo_service_image:latest | sha256:060d2dd3dc1da647b5bdbfd3b86251d80e955c5dcd9a6a19a8593aa0a1627676 |             0 | 2024-08-08T18:34:24Z |
+---------------+-------------+--------------+-------------+----------------+--------+---------+---------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------+---------------+----------------------+
Linguagem: Português