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.

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

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 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 | instance_id | status | spec_digest                                                      | creation_time        | start_time           |
|---------------+-------------+--------------+-------------+--------+------------------------------------------------------------------+----------------------+----------------------|
| TUTORIAL_DB   | DATA_SCHEMA | ECHO_SERVICE | 0           | READY  | cb0cbefa3376e75e5926d56535198ce27b3790780beb2c924085eef41dad9adf | 2024-08-08T18:31:38Z | 2024-08-08T18:34:01Z |
+---------------+-------------+--------------+-------------+--------+------------------------------------------------------------------+----------------------+----------------------+
Linguagem: Português