SHOW SERVICE INSTANCES IN SERVICE¶

Lista instâncias de um serviço

A saída do comando oferece visibilidade sobre dimensionamento automático e atualizações contínuas, exibindo o status de cada instância de serviço individual.

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

Sintaxe¶

SHOW SERVICE INSTANCES IN SERVICE <name>

Copy

Parâmetros¶

name

Especifica o identificador do serviço cujas instâncias devem ser listadas.

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 das instâncias 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.
`service_status`	Um dos seguintes valores, que indica o status atual do serviço: `PENDING` `RUNNING` `FAILED` `DONE` `SUSPENDING` `SUSPENDED` `DELETING` `DELETED` `INTERNAL_ERROR` Observe que o valor dessa coluna é o mesmo da coluna `status` na saída do DESCRIBE SERVICE.
`instance_id`	ID da instância de serviço (este é o índice da instância de serviço que começa em 0).
`status`	Um dos seguintes valores, que indica o status atual da instância do serviço: `PENDING`: A instância de serviço está sendo implementada e ainda não está pronta para atender solicitações. `READY`: Todos os contêineres na instância de serviço estão prontos; a instância de serviço está pronta para atender solicitações. `FAILED`: Pelo menos um contêiner na instância de serviço saiu com falha. `TERMINATING`: A instância do serviço está em processo de encerramento e será removida após a conclusão do processo. `SUCCEEDED`: O serviço é um serviço de trabalho e todos os contêineres na instância do serviço foram encerrados com sucesso.
`spec_digest`	O identificador único e imutável que representa o conteúdo da especificação do serviço.
`creation_time`	O momento em que o Snowflake começou a criar a instância de serviço.
`start_time`	O momento em que o Snowflake reconheceu que a instância do serviço está sendo executada em um nó.
`ip_address`	Endereço IP da instância de serviço. Outras instâncias do mesmo serviço (ou outros serviços) podem usar esse endereço IP para se conectar a uma instância de serviço específica. Quando estiver executando várias instâncias de serviço, você pode implementar a eleição do líder entre as instâncias de um serviço, elegendo a instância com `instance_id` 0 como líder.

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

Os nomes das colunas de saída para este comando são gerados em minúsculas. Se você consumir um conjunto de resultados deste comando com o operador de canal ou a função RESULT_SCAN, use identificadores entre aspas duplas para os nomes das colunas na consulta para garantir que eles correspondam aos nomes das colunas na saída que foi verificada. Por exemplo, se o nome de uma coluna de saída for type, especifique "type" para o identificador.

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 instâncias do serviço echo_service no banco de dados atual e o esquema para a sessão:

SHOW SERVICE INSTANCES IN SERVICE echo_service;

Copy

Exemplo de saída:

+---------------+-------------+--------------+----------------+-------------+--------+------------------------------------------------------------------+----------------------+----------------------+------------+
| database_name | schema_name | service_name | service_status | instance_id | status | spec_digest                                                      | creation_time        | start_time           | ip_address |
|---------------+-------------+--------------+----------------+-------------+--------+------------------------------------------------------------------+----------------------+----------------------+------------|
| TUTORIAL_DB   | DATA_SCHEMA | ECHO_SERVICE | RUNNING        | 0           | READY  | 2831c241b8d64104fbc562d60764d7abd28602c70b6a8357341e8c8210b79da4 | 2025-04-25T06:01:32Z | 2025-04-25T06:01:32Z | 10.244.0.9 |
+---------------+-------------+--------------+----------------+-------------+--------+------------------------------------------------------------------+----------------------+----------------------+------------+