SHOW SERVICE CONTAINERS IN SERVICE

Listet die Container in allen Instanzen eines Diensten auf.

Wenn Snowflake Probleme bei der Ausführung eines oder mehrerer Ihrer Dienstcontainer hat, können Sie mit diesem Befehl den Status der einzelnen Container anzeigen. Ähnlich verhält es sich bei einem fortlaufenden Upgrade: Es zeigt die Version Ihres Servicecodes an, der in jedem Container läuft.

Siehe auch:

Übersicht zu Snowpark Container Services, CREATE SERVICE, SHOW SERVICES, SHOW SERVICE INSTANCES IN SERVICE

Syntax

SHOW SERVICE CONTAINERS IN SERVICE <name>
Copy

Parameter

name

Gibt den Bezeichner für den Dienst an, dessen Container aufgeführt werden sollen.

In Anführungszeichen gesetzte Namen für Sonderzeichen oder Namen, bei denen die Groß-/Kleinschreibung beachtet wird, werden nicht unterstützt.

Ausgabe

Die Ausgabe des Befehls liefert Eigenschaften und Metadaten der Dienstcontainer in den folgenden Spalten:

Spalte

Beschreibung

database_name

Datenbank, in der der Dienst erstellt wird.

schema_name

Schema, in dem der Dienst erstellt wird.

service_name

Name des Dienstes.

instance_id

ID der Dienstinstanz (dies ist der Index der Dienstinstanz, beginnend bei 0).

container_name

Name des Containers.

status

Status des Dienstcontainers. Folgende Statuswerte werden derzeit unterstützt:

  • PENDING: Der Container wird gerade bereitgestellt.

  • READY: Der Container wurde gestartet und der Bereitschaftstest hat den Status HTTP 200 OK zurückgegeben.

  • DONE: Der Container wurde mit einem Exitcode von 0 verlassen.

  • FAILED: Der Container wurde mit einem Nicht-Null-Exitcode beendet (Exitcode 0 bedeutet Erfolg).

  • UNKNOWN: Snowflake konnte den Container-Status nicht abrufen. Support kontaktieren

message

Zusätzliche Klarstellung zum Status Wenn der Status z. B. FAILED lautet, kann Snowflake zusätzliche Informationen liefern.

image_name

Imagename, mit dem der Dienst erstellt wurde

image_digest

Der eindeutige und unveränderliche Bezeichner, die den Bildinhalt darstellt.

restart_count

Häufigkeit, mit der Snowflake den Dienst neu gestartet hat.

start_time

Datum und Uhrzeit des Starts des Containers

Anforderungen an die Zugriffssteuerung

Eine Rolle, die zur Ausführung dieses SQL-Befehls verwendet wird, muss mindestens die folgenden Berechtigungen haben:

Berechtigung

Objekt

Anmerkungen

Jede dieser Berechtigungen: OWNERSHIP oder MONITOR

Dienst

Beachten Sie, dass für die Bearbeitung eines Objekts in einem Schema auch die Berechtigung USAGE für die übergeordnete Datenbank und das Schema erforderlich ist.

Eine Anleitung zum Erstellen einer kundenspezifischen Rolle mit einer bestimmten Gruppe von Berechtigungen finden Sie unter Erstellen von kundenspezifischen Rollen.

Allgemeine Informationen zu Rollen und Berechtigungen zur Durchführung von SQL-Aktionen auf sicherungsfähigen Objekten finden Sie unter Übersicht zur Zugriffssteuerung.

Nutzungshinweise

  • Um die Ausgabe dieses Befehls nachzubearbeiten, können Sie die Funktion RESULT_SCAN verwenden, die die Ausgabe wie eine abfragbare Tabelle behandelt.

Beispiele

Das folgende Beispiel listet die Container des Dienstes echo_service in der aktuellen Datenbank und im aktuellen Schema für die Sitzung auf:

SHOW SERVICE CONTAINERS IN SERVICE echo_service;
Copy

Beispielausgabe:

+---------------+-------------+--------------+-------------+----------------+--------+---------+---------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------+---------------+----------------------+
| 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 |
+---------------+-------------+--------------+-------------+----------------+--------+---------+---------------------------------------------------------------------------------------------------------------------------+-------------------------------------------------------------------------+---------------+----------------------+
Sprache: Deutsch