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

Uma função usada para executar este comando SQL deve ter os seguintes privilégios no mínimo:

Privilégio

Objeto

Notas

Qualquer um destes privilégios: OWNERSHIP ou MONITOR

Serviço

Observe que operar em qualquer objeto de um esquema também requer o privilégio USAGE no banco de dados e esquema principais.

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