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>
Parâmetros¶
nameEspecifica 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 |
|---|---|
|
Banco de dados no qual o serviço é criado. |
|
Esquema no qual o serviço é criado. |
|
Nome do serviço. |
|
Um dos seguintes valores, que indica o status atual do serviço:
O valor dessa coluna é igual ao da coluna |
|
ID da instância de serviço (este é o índice da instância de serviço que começa em 0). Quando não há instâncias de serviço em execução (ou seja, o serviço é SUSPENDED ou PENDING), instance_id e instance_status são retornados como NULL. Além disso, os campos relacionados ao contêiner na saída também são retornados como NULL. |
|
Um dos seguintes valores, que indica o status atual da instância do serviço:
Observe que, para uma determinada instância de serviço, conforme identificado pela coluna |
|
Nome do contêiner. Se nenhum contêiner estiver em execução (ou seja, o serviço estiver em um estado SUSPENDED ou PENDING), o nome do contêiner será retornado como NULL, e todos os valores de campo específicos do contêiner também serão NULL. |
|
Status do contêiner de serviço. Os valores de status compatíveis atualmente incluem o seguinte:
|
|
Esclarecimento adicional sobre o status. Por exemplo, quando o status é FAILED, o Snowflake pode fornecer informações adicionais. |
|
Nome da imagem usada para criar o serviço. |
|
O identificador único e imutável que representa o conteúdo da imagem. |
|
Número de vezes que o Snowflake reiniciou o serviço. |
|
Data e hora em que o contêiner foi iniciado. |
|
Indica o código de saída da última saída do contêiner. Para contêineres de serviço, o Snowflake reinicia o contêiner se ele sair prematuramente. O código de saída é representado como um valor inteiro:
|
|
Fornece o carimbo de data/hora da reinicialização mais recente do contêiner pelo Snowflake. Um valor NULL indica que o contêiner nunca foi reiniciado. |
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¶
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.
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 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;
Exemplo de saída:
+---------------+-------------+--------------+----------------+-------------+-----------------+----------------+--------+---------+----------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------+---------------+----------------------+----------------+-------------------+
| database_name | schema_name | service_name | service_status | instance_id | instance_status | container_name | status | message | image_name | image_digest | restart_count | start_time | last_exit_code | last_restart_time |
|---------------+-------------+--------------+----------------+-------------+-----------------+----------------+--------+---------+----------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------+---------------+----------------------+----------------+-------------------|
| TUTORIAL_DB | DATA_SCHEMA | ECHO_SERVICE | RUNNING | 0 | READY | echo | READY | Running | orgname.acctname.registry-dev.snowflakecomputing.com/tutorial_db/data_schema/tutorial_repository/my_echo_service_image:latest | sha256:d04a2d7b7d9bd607df994926e3cc672edcb541474e4888a01703e8bb0dd3f173 | 0 | 2025-04-25T06:01:38Z | NULL | NULL |
+---------------+-------------+--------------+----------------+-------------+-----------------+----------------+--------+---------+----------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------+---------------+----------------------+----------------+-------------------+