DESCRIBE APPLICATION

Zeigt Informationen zu einem Anwendungsobjekt an, das mit dem Snowflake Native App Framework erstellt wurde.

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 stellt die Eigenschaften eines Anwendungsobjekts in den folgenden Spalten bereit:

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.

log_level

Der für das Anwendungsobjekt festgelegte Protokolliergrad.

trace_level

Die für das Anwendungsobjekt festgelegte Ablaufverfolgungsebene.

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. Der Grund für den Fehler ist in der Spalte UPGRADE_FAILURE_REASON aufgeführt, falls vorhanden.

  • 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 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 Zeitpunkt, an dem das Anwendungsobjekt zuletzt aktualisiert wurde.

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.

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                 | 2023-05-25 08:30:41.520 -0700 |
| last_upgraded_on           |                               |
| share_events_with_provider | 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_reason     | NULL                          |
| previous_version           | NULL                          |
| previous_patch             | 0                             |
| previous_version_state     | COMPLETE                      |
+----------------------------+-------------------------------+