DESCRIBE APPLICATION¶

Zeigt Informationen zu einem Anwendungsobjekt an.

DESCRIBE kann mit DESC abgekürzt werden.

Siehe auch:: ALTER APPLICATION PACKAGE, CREATE APPLICATION PACKAGE, DROP APPLICATION PACKAGE, SHOW APPLICATION PACKAGES,

Syntax¶

DESC[RIBE] APPLICATION <name>

Copy

Parameter¶

name: Gibt den Bezeichner des zu beschreibenden Anwendungsobjekts an.

Ausgabe¶

Der Befehl zeigt die Eigenschaften eines Anwendungsobjekts in den folgenden Spalten an:

Spalte	Beschreibung
`property`	Name der Eigenschaft des Anwendungsobjekts. Diese Spalte kann die in der folgenden Tabelle aufgeführten Eigenschaften enthalten.
`value`	Wert, der der Eigenschaft des Anwendungsobjekts zugewiesen ist.

Die Spalte property kann die folgenden Eigenschaften eines Anwendungsobjekts enthalten:

Eigenschaft	Beschreibung
`name`	Der Name des Anwendungsobjekts.
`source_organization`	Der Name der Organisation des Kontos, das das Anwendungspaket enthält, das zum Erstellen des Anwendungsobjekts verwendet wurde.
`source_account`	Das Konto des Anwendungspakets, das zum Erstellen des Anwendungsobjekts verwendet wurde.
`source_type`	Die zum Erstellen der Anwendung verwendete Quelle. Gültige Werte sind `APP_PACKAGE` und `LISTING`.
`source`	Der Name des Anwendungspakets oder des Freigabeangebots, das zum Erstellen des Anwendungsobjekts verwendet wurde.
`version`	Die Bezeichnung der Version des Anwendungsobjekts.
`version_label`	Die Versionsbezeichnung des Anwendungsobjekts. Dieses Label ist für den Verbraucher sichtbar, wenn dieser eine Snowflake Native App installiert.
`patch`	Die Patchnummer des Anwendungsobjekts.
`created_on`	Der Zeitstempel für den Zeitpunkt, an dem das Anwendungsobjekt erstellt wurde.
`last_upgraded_on`	Der Zeitstempel für den Zeitpunkt der letzten Aktualisierung des Anwendungsobjekts.
`share_events_with_provider`	Gibt an, ob Protokollierung und Ereignisfreigabe für das Anwendungsobjekt aktiviert sind.
`authorize_telemetry_event_sharing`	Der Status des Flags `AUTHORIZE_TELEMETRY_EVENT_SHARING`.
`log_level`	Der vom Anbieter in der Manifestdatei definierte Protokolliergrad.
`trace_level`	Die vom Anbieter in der Manifestdatei definierte Ablaufverfolgung.
`effective_log_level`	Der für die App aktivierte Protokolliergrad.
`effective_trace_level`	Die für die App aktivierte Ablaufverfolgung.
`debug_mode`	Gibt an, ob die Anwendung im Debug-Modus erstellt wurde.
`upgrade_state`	Der aktuelle Status der Hintergrundinstallation oder des Upgrades des Anwendungsobjekts. Gültige Werte: `INSTALLING`: Das Anwendungsobjekt wird gerade erstellt. `INSTALL_FAILED`: Das Erstellen des Anwendungsobjekts ist fehlgeschlagen. Das Anwendungsobjekt bleibt so lange im Status `INSTALL_FAILED`, bis es gelöscht wird. In der Spalte `UPGRADE_FAILURE_REASON` des Befehls DESCRIBE APPLICATION finden Sie Informationen darüber, warum die Installation oder das Upgrade fehlgeschlagen ist. `COMPLETE`: Das Setup-Skript wurde erfolgreich abgeschlossen, und das Anwendungsobjekt wurde erstellt oder aktualisiert. `QUEUED`: Das Anwendungsobjekt befindet sich in der Warteschlange für ein Upgrade. `UPGRADING`: Das Anwendungsobjekt wird gerade aktualisiert. `FAILED`: Alle Upgrade-Versuche sind fehlgeschlagen sind. Der Grund für den Fehler ist in der Spalte `UPGRADE_FAILURE_REASON` aufgeführt, falls vorhanden. Die Instanz verbleibt so lange im Status `FAILED`, bis eine Release-Richtlinie aktualisiert wird, die auf eine andere Version verweist als diejenige, auf die das Upgrade gemäß der Definition in der Spalte `TARGET_UPGRADE_VERSION` abzielte. `QUEUED_RETRY`: Ein oder mehrere Upgrade-Versuche der Instanz sind fehlgeschlagen. Der Grund für den Fehler wird in der Spalte `UPGRADE_FAILURE_REASON` angegeben: Die Instanz befindet sich in der Warteschlange für einen weiteren Upgrade-Versuch. `DISABLED`: Das Anwendungsobjekt und seine Upgrades wurden deaktiviert. In diesem Status ist die Instanz für den Zugriff durch die Verbraucher gesperrt, sie wird nicht für Upgrades berücksichtigt, und sie blockiert nicht das Löschen der Version des Anwendungspakets. Der Grund für den Fehler ist in der Spalte `UPGRADE_FAILURE_REASON` aufgeführt, falls vorhanden.
`upgrade_target_version`	Die Bezeichnung der Version, auf die das Anwendungsobjekt aktualisiert wird.
`upgrade_target_patch`	Der Patch, auf den das Anwendungsobjekt aktualisiert wird.
`upgrade_attempt`	Gibt an, ob ein Upgrade des Anwendungsobjekts versucht wurde.
`upgrade_task_id`	Die interne Aufgaben-ID für den Upgrade-Versuch.
`upgrade_started_on`	Der Zeitstempel für den Zeitpunkt, an dem das Upgrade des Anwendungsobjekts initiiert wurde.
`upgrade_attempted_on`	Der Zeitstempel für den letzten Installations- oder Wiederholungsversuch der Anwendung.
`upgrade_failure_type`	Der Grund für ein fehlgeschlagenes Upgrade. Mögliche Werte sind: `VERSION_SETUP`: Gibt an, dass bei der Ausführung des Setup-Skripts für die App ein Fehler aufgetreten ist. Dies kann vorkommen, wenn das Setup-Skript einen Syntaxfehler enthält, leer ist usw. Wenn dieser Fehler auftritt, wird eine E-Mail-Benachrichtigung an den Anbieter gesendet. `INTERNAL`: Gibt einen internen Snowflake-Fehler an, z. B. wenn ein erforderliches Objekt nicht antwortet oder nicht gefunden werden kann.
`upgrade_failure_reason`	Der Grund für das Scheitern des Upgrades, falls zutreffend.
`previous_version`	Die Bezeichnung der vorherigen Version des installierten Anwendungsobjekts.
`previous_patch`	Die Nummer des vorherigen Patches des installierten Anwendungsobjekts.
`previous_version_state`	Der Status der vorherigen Version des Anwendungsobjekts.
`comment`	Text, der Informationen zum Anwendungsobjekt enthält.

Nutzungshinweise¶

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

Beispiele¶

Beschreiben der Eigenschaften eines Anwendungsobjekts:

DESC APPLICATION hello_snowflake_app;

Copy

+------------------------------------+-------------------------------+
| property                           | value                         |
|------------------------------------+-------------------------------|
| name                               | hello_snowflake_app           |
| source_organization                | my_organization               |
| source_account                     | provider_account              |
| source_type                        | APPLICATION PACKAGE           |
| source                             | hello_snowflake_package       |
| version                            | v1_0                          |
| version_label                      | NULL                          |
| patch                              | 0                             |
| created_on                         | 2024-05-25 08:30:41.520 -0700 |
| last_upgraded_on                   |                               |
| share_events_with_provider         | FALSE                         |
| authorize_telemetry_event_sharing  | FALSE                         |
| log_level                          | OFF                           |
| trace_level                        | OFF                           |
| debug_mode                         | FALSE                         |
| upgrade_state                      | COMPLETE                      |
| upgrade_target_version             | NULL                          |
| upgrade_target_patch               | 0                             |
| upgrade_attempt                    | NULL                          |
| upgrade_task_id                    | NULL                          |
| upgrade_started_on                 |                               |
| upgrade_attempted_on               |                               |
| upgrade_failure_type               | NULL                          |
| upgrade_failure_reason             | NULL                          |
| previous_version                   | NULL                          |
| previous_patch                     | 0                             |
| previous_version_state             | COMPLETE                      |
| comment                            |                               |
+------------------------------------+-------------------------------+