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.
`restricted_callers_rights`	Zeigt an, dass eingeschränkte Aufruferrechte für die App aktiviert wurden. Weitere Informationen dazu finden Sie unter Gewährung von beschränkten Aufruferrechten für eine ausführbare Datei in einer App.
`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.
`metric_level`	Die vom Anbieter in der Manifestdatei definierte metrische Ebene.
`auditlog_level`	Der vom Anbieter in der Manifestdatei definierte Audit-Protokolliergrad.
`effective_log_level`	Der für die App aktivierte Protokolliergrad.
`effective_trace_level`	Der aktuell für die App konfigurierte Protokolliergrad.
`effective_metric_level`	Die aktuell für die App konfigurierte metrische Ebene.
`effective_auditlog_level`	Der aktuell für die App konfigurierte Audit-Protokolliergrad.
`debug_mode`	Gibt an, ob die App im Debug-Modus erstellt wurde.
`disable_application_redaction`	Zeigt an, ob die Ausblendung von Anbieterdaten deaktiviert wurde.
`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 App.
`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.
`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_in_maintenance_window`	Wenn `TRUE` zeigt dies an, dass der Anbieter die App für ein Upgrade während eines Snowpark Container Services-Wartungsfensters geplant hat. Dieses Feature befindet sich derzeit in der Vorschau.
`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.
`disablement_reasons`	Ein Array mit den Gründen, warum die App deaktiviert wurde. Weitere Informationen dazu finden Sie unter Gründe, warum eine App deaktiviert werden kann.
`release_channel_name`	Die Art des Release-Kanals. Gültige Werte: `QA`, `ALPHA`, `DEFAULT`. Weitere Informationen dazu finden Sie unter Veröffentlichen einer App über Release-Kanäle.

Nutzungshinweise¶

Um die Ausgabe dieses Befehls nachzubearbeiten, können Sie den Befehl Pipe-Operator (->>) oder RESULT_SCAN-Funktion verwenden Beide Konstrukte behandeln die Ausgabe als Resultset, das Sie abfragen können.

Die Namen der Ausgabespalten für diesen Befehl werden in Kleinbuchstaben generiert. Wenn Sie ein Resultset dieses Befehls mit dem Pipe-Operator oder der RESULT_SCAN-Funktion verbrauchen, verwenden Sie Bezeichner mit doppelten Anführungszeichen für die Spaltennamen in der Abfrage, um sicherzustellen, dass sie mit den Spaltennamen in der gescannten Ausgabe übereinstimmen. Wenn der Name einer Ausgabespalte beispielsweise type lautet, dann geben Sie "type" für den Bezeichner an.

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