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>
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 |
---|---|
|
Base de données dans laquelle le service est créé. |
|
Schéma dans lequel le service est créé. |
|
Nom du service. |
|
L’une des valeurs suivantes, qui indique le statut actuel du service :
La valeur de cette colonne est la même que celle de la colonne |
|
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. |
|
L’une des valeurs suivantes, qui indique le statut actuel de l’instance de service :
Notez que pour une instance de service donnée, identifiée par la colonne |
|
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. |
|
Statut du conteneur de service. Les valeurs de statut actuellement prises en charge incluent ce qui suit :
|
|
Précisions supplémentaires sur le statut. Par exemple, lorsque le statut est FAILED, Snowflake peut fournir des informations supplémentaires. |
|
Nom de l’image utilisée pour créer le service. |
|
L’identificateur unique et immuable représentant le contenu de l’image. |
|
Nombre de fois où Snowflake a redémarré le conteneur. |
|
Date et heure auxquelles le conteneur a démarré. |
|
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 :
|
|
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;
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 |
+---------------+-------------+--------------+----------------+-------------+-----------------+----------------+--------+---------+----------------------------------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------+---------------+----------------------+----------------+-------------------+