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.

instance_id

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

container_name

Nom du conteneur.

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

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 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 | instance_id | container_name | status | message | image_name                                                                                                                | image_digest                                                            | restart_count | start_time           |
|---------------+-------------+--------------+-------------+----------------+--------+---------+---------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------+---------------+----------------------|
| TUTORIAL_DB   | DATA_SCHEMA | ECHO_SERVICE | 0           | echo           | READY  | Running | orgname-acctname.registry.snowflakecomputing.com/tutorial_db/data_schema/tutorial_repository/my_echo_service_image:latest | sha256:060d2dd3dc1da647b5bdbfd3b86251d80e955c5dcd9a6a19a8593aa0a1627676 |             0 | 2024-08-08T18:34:24Z |
+---------------+-------------+--------------+-------------+----------------+--------+---------+---------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------+---------------+----------------------+
Langage: Français