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>
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 |
---|---|
|
Banco de dados no qual o serviço é criado. |
|
Esquema no qual o serviço é criado. |
|
Nome do serviço. |
|
ID da instância de serviço (este é o índice da instância de serviço que começa em 0). |
|
Um dos seguintes valores, que indica o status atual da instância do serviço:
|
|
O identificador único e imutável que representa o conteúdo da especificação do serviço. |
|
O momento em que o Snowflake começou a criar a instância de serviço. |
|
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¶
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 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;
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 |
+---------------+-------------+--------------+-------------+--------+------------------------------------------------------------------+----------------------+----------------------+