DESCRIBE APPLICATION¶

Zeigt Informationen über eine Snowflake Native App 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 der zu beschreibenden Anwendung an.

Ausgabe¶

Der Befehl zeigt die Eigenschaften einer Anwendung in den folgenden Spalten an:

Spalte	Beschreibung
`property`	Der Name der Eigenschaft der Anwendung. Diese Spalte kann die in der folgenden Tabelle aufgeführten Eigenschaften enthalten.
`value`	Der Wert, der der Eigenschaft der Anwendung zugewiesen wurde.

Die Spalte property kann die folgenden Eigenschaften einer Anwendung enthalten:

Eigenschaft	Beschreibung
`name`	Der Name der Anwendung.
`source_organization`	Der Name der Organisation des Kontos, das das Anwendungspaket enthält, das zum Erstellen der Anwendung verwendet wurde.
`source_account`	Das Konto des Anwendungspakets, das zum Erstellen der Anwendung 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 der Anwendung verwendet wurde.
`version`	Der Bezeichner der Version der Anwendung.
`version_label`	Die Versionsbezeichnung der Anwendung. Dieses Label ist für den Verbraucher sichtbar, wenn dieser eine Snowflake Native App installiert.
`patch`	Die Patchnummer der Anwendung.
`created_on`	Der Zeitstempel, an dem die Anwendung erstellt wurde.
`last_upgraded_on`	Der Zeitstempel für den Zeitpunkt der letzten Aktualisierung der Anwendung.
`share_events_with_provider`	Gibt an, ob Protokollierung und Ereignisfreigabe für die Anwendung 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_after`	Gibt an, dass der Anbieter den Beginn eines Upgrades zu diesem Zeitpunkt geplant hat. Die Anwendung kann jedoch auch vor diesem Datum und dieser Uhrzeit aktualisiert werden. Weitere Informationen dazu finden Sie unter Manuelles Upgrade einer App.
`upgrade_state`	Der aktuelle Status der Hintergrundinstallation oder des Upgrades der Anwendung. 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`	Der Bezeichner der Version, auf die die Anwendung aktualisiert wird.
`upgrade_target_patch`	Der Patch, auf den die Anwendung aktualisiert wird.
`upgrade_attempt`	Gibt an, ob ein Upgrade der Anwendung 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`	Der Bezeichner der vorherigen Version der Anwendung.
`previous_patch`	Die Nummer des vorherigen Patches der installierten Anwendung.
`previous_version_state`	Der Status der vorherigen Version der Anwendung.
`comment`	Text, der Informationen über die Anwendung liefert.

Nutzungshinweise¶

Zur Weiterverarbeitung der Ausgabe dieses Befehls können Sie die Funktion RESULT_SCAN verwenden, die die Ausgabe wie eine abfragbare Tabelle behandelt. Sie können auch den Pipe-Operator verwenden, um die Ausgabe dieses Befehls abzufragen.

Beispiele¶

Beschreiben Sie die Eigenschaften einer Anwendung:

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