SHOW SERVICE CONTAINERS IN SERVICE

Liste les conteneurs dans toutes les instances d’un service.

Si Snowflake rencontre des problèmes lors de l’exécution d’un ou plusieurs de vos conteneurs de service, cette commande offre une visibilité sur le statut des conteneurs individuels. De même, lors d’une mise à niveau progressive, elle affiche la version de votre code de service exécutée dans chaque conteneur.

Voir aussi :

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

Syntaxe

SHOW SERVICE CONTAINERS IN SERVICE <name>
Copy

Paramètres

name

Spécifie l’identificateur du service dont les conteneurs doivent être listés.

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

service_status

L’une des valeurs suivantes, qui indique le statut actuel du service :

  • PENDING

  • RUNNING

  • FAILED

  • DONE

  • SUSPENDING

  • SUSPENDED

  • DELETING

  • DELETED

  • INTERNAL_ERROR

La valeur de cette colonne est la même que celle de la colonne status dans la sortie de DESCRIBE SERVICE.

instance_id

ID de l’instance de service (il s’agit de l’index de l’instance de service à partir de 0). Lorsqu’aucune instance de service n’est en cours d’exécution (c’est-à-dire lorsque le service est soit SUSPENDED, soit PENDING), instance_id et instance_status sont renvoyés comme NULL. En outre, les champs relatifs aux conteneurs dans la sortie sont également renvoyés comme NULL.

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

Notez que pour une instance de service donnée, identifiée par la colonne instance_id, la valeur de la colonne instance_status correspond à la valeur de la colonne status dans la sortie de la commande SHOW SERVICE INSTANCES IN SERVICE.

container_name

Nom du conteneur. Si aucun conteneur n’est en cours d’exécution (c’est-à-dire si le service est à l’état SUSPENDED ou PENDING), le nom de conteneur est renvoyé comme NULL et toutes les valeurs des champs spécifiques au conteneur sont également NULL.

status

Statut du conteneur de service. Les valeurs de statut actuellement prises en charge incluent ce qui suit :

  • PENDING : le conteneur est actuellement en cours de déploiement.

  • READY : le conteneur a démarré et la sonde de préparation a renvoyé le statut HTTP 200 OK.

  • DONE : le conteneur a quitté avec un code de sortie 0.

  • FAILED : le conteneur a quitté avec un code de sortie différent de zéro (le code de sortie 0 indique la réussite).

  • UNKNOWN : Snowflake n’a pas pu extrait le statut du conteneur. Contacter le support.

message

Précisions supplémentaires sur le statut. Par exemple, lorsque le statut est FAILED, Snowflake peut fournir des informations supplémentaires.

image_name

Nom de l’image utilisée pour créer le service.

image_digest

L’identificateur unique et immuable représentant le contenu de l’image.

restart_count

Nombre de fois où Snowflake a redémarré le conteneur.

start_time

Date et heure auxquelles le conteneur a démarré.

last_exit_code

Indique le code de sortie lors de la dernière sortie du conteneur. Pour les conteneurs de service, Snowflake redémarre le conteneur s’il se ferme prématurément. Le code de sortie est représenté sous la forme d’une valeur entière :

  • NULL : le conteneur est actuellement en cours d’exécution et n’a jamais été fermé.

  • 0 : la dernière sortie du conteneur a réussi.

  • Valeur différente de zéro : le conteneur a rencontré une défaillance.

last_restart_time

Fournit l’horodatage du redémarrage le plus récent du conteneur par Snowflake. Une valeur NULL indique que le conteneur n’a jamais redémarré.

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

Un rôle utilisé pour exécuter cette opération doit au minimum disposer des privilèges suivants :

Privilège

Objet

Remarques

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

Service

Le privilège USAGE relatif à la base de données et au schéma parents est exigé pour effectuer des opérations sur tout objet d’un schéma.

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

  • La commande ne nécessite pas l’exécution d’un entrepôt en cours d’exécution.

  • La commande ne renvoie que les objets pour lesquels le rôle actuel de l’utilisateur s’est vu accorder au moins un privilège d’accès.

  • Le privilège d’accès MANAGE GRANTS permet implicitement à son titulaire de voir tous les objets du compte. Par défaut, seuls l’administrateur du compte (utilisateurs avec le rôle ACCOUNTADMIN) et l’administrateur de sécurité (utilisateurs avec le rôle SECURITYADMIN) ont le privilège MANAGE GRANTS.

  • Pour post-traiter la sortie de cette commande, vous pouvez utiliser la fonction RESULT_SCAN qui traite la sortie sous forme de table à interroger. Vous pouvez également utiliser l”opérateur de canal pour interroger la sortie de cette commande.

  • La commande renvoie un maximum de dix mille enregistrements pour le type d’objet spécifié, conformément aux privilèges d’accès du rôle utilisé pour exécuter la commande. Aucun enregistrement au-delà de la limite de dix mille enregistrements n’est renvoyé, même si un filtre a été appliqué.

    Pour afficher les résultats pour lesquels il existe plus de dix mille enregistrements, interrogez la vue correspondante (le cas échéant) dans Schéma d’information de Snowflake.

Exemples

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

SHOW SERVICE CONTAINERS IN SERVICE echo_service;
Copy

Exemple de sortie :

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