SHOW SERVICE INSTANCES IN SERVICE

Liste les instances d’un service.

La sortie de commande offre une visibilité sur la mise à l’échelle automatique et les mises à niveau progressives en affichant le statut de chaque instance de service individuelle.

Voir aussi :

Aperçu de Snowpark Container Services, CREATE SERVICE, SHOW SERVICES, SHOW SERVICE CONTAINERS IN SERVICE

Syntaxe

SHOW SERVICE INSTANCES IN SERVICE <name>
Copy

Paramètres

name

Spécifie l’identificateur du service dont les instances doivent être listées.

Les noms entre guillemets pour les caractères spéciaux ou les noms sensibles à la casse ne sont pas pris en charge.

Sortie

La sortie de la commande fournit les propriétés et les métadonnées des instances de service dans les colonnes suivantes :

Colonne

Description

database_name

Base de données dans laquelle le service est créé.

schema_name

Schéma dans lequel le service est créé.

service_name

Nom du service.

instance_id

ID de l’instance de service (il s’agit de l’index de l’instance de service à partir de 0).

status

L’une des valeurs suivantes, qui indique le statut actuel de l’instance de service :

  • PENDING : l’instance de service est actuellement en cours de déploiement et n’est pas encore prête à répondre aux requêtes.

  • READY : tous les conteneurs de l’instance de service sont prêts ; l’instance de service est prête à répondre aux requêtes.

  • FAILED : au moins un conteneur de l’instance de service s’est terminé avec un échec.

  • TERMINATING : l’instance de service est en cours de terminaison et sera supprimée une fois le processus terminé.

  • SUCCEEDED : le service est un service de tâche et tous les conteneurs de l’instance de service se sont terminés correctement.

spec_digest

L’identificateur unique et immuable qui représente le contenu de la spécification de service.

creation_time

L’heure à laquelle Snowflake a commencé à créer l’instance de service.

start_time

L’heure à laquelle Snowflake a reconnu que l’instance de service est en cours d’exécution sur un nœud.

Exigences en matière de contrôle d’accès

Un rôle utilisé pour exécuter cette commande SQL doit avoir les privilèges suivants définis au minimum ainsi :

Privilège

Objet

Remarques

N’importe lequel de ces privilèges : OWNERSHIP ou MONITOR

Service

Notez que l’exploitation d’un objet dans un schéma requiert également le privilège USAGE sur la base de données et le schéma parents.

Pour obtenir des instructions sur la création d’un rôle personnalisé avec un ensemble spécifique de privilèges, voir Création de rôles personnalisés.

Pour des informations générales sur les rôles et les privilèges accordés pour effectuer des actions SQL sur des objets sécurisables, voir Aperçu du contrôle d’accès.

Notes sur l’utilisation

  • Pour post-traiter la sortie de cette commande, vous pouvez utiliser la fonction RESULT_SCAN, qui traite la sortie comme une table qui peut être interrogée.

Exemples

L’exemple suivant liste les instances du service echo_service dans la base de données et le schéma actuels pour la session :

SHOW SERVICE INSTANCES IN SERVICE echo_service;
Copy

Exemple de sortie :

+---------------+-------------+--------------+-------------+--------+------------------------------------------------------------------+----------------------+----------------------+
| 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 |
+---------------+-------------+--------------+-------------+--------+------------------------------------------------------------------+----------------------+----------------------+
Langage: Français