SHOW APPLICATIONS¶
Listet die Anwendungsobjekte auf, für die Sie in Ihrem gesamten Konto im Snowflake Native App Framework Zugriffsrechte haben.
Die Ausgabe gibt Metadaten und Eigenschaften für das Anwendungsobjekt zurück, lexikografisch nach Namen geordnet. Dies muss beachtet werden, wenn Sie die Ergebnisse mit den bereitgestellten Filtern filtern möchten.
Syntax¶
SHOW APPLICATIONS [ LIKE '<pattern>' ]
[ STARTS WITH '<name_string>' ]
[ LIMIT <rows> [ FROM '<name_string>' ] ];
Parameter¶
LIKE 'pattern'Filtert optional die Befehlsausgabe nach dem Objektnamen. Der Filter verwendet einen Musterabgleich ohne Berücksichtigung der Groß-/Kleinschreibung, aber mit Unterstützung von SQL-Platzhalterzeichen (
%und_).Die folgenden Muster geben beispielsweise die gleichen Ergebnisse zurück:
... LIKE '%testing%' ...... LIKE '%TESTING%' .... Standard: Kein Wert (die Ausgabe wird nicht gefiltert).
STARTS WITH 'name_string'Filtert die Befehlsausgabe optional anhand der Zeichen, die am Anfang des Objektnamens angezeigt werden. Die Zeichenfolge muss in einfache Anführungszeichen gesetzt werden, wobei zwischen Groß-/Kleinschreibung unterschieden wird.
Die folgenden Zeichenfolgen geben beispielsweise unterschiedliche Ergebnisse zurück:
... STARTS WITH 'B' ...... STARTS WITH 'b' .... Standard: Kein Wert (die Ausgabe wird nicht gefiltert)
LIMIT rows [ FROM 'name_string' ]Schränkt optional die maximale Anzahl der zurückgegebenen Zeilen ein und ermöglicht gleichzeitig die „Paginierung“ der Ergebnisse. Die tatsächliche Anzahl der zurückgegebenen Zeilen kann geringer sein als das angegebene Limit. Beispielsweise ist die Anzahl der vorhandenen Objekte geringer als das angegebene Limit.
Die optionale Unterklausel
FROM 'name_string'dient als „Cursor“ für die Ergebnisse. Dies ermöglicht das Abrufen der angegebenen Anzahl von Zeilen nach der ersten Zeile, deren Objektname mit der angegebenen Zeichenfolge übereinstimmt:Die Zeichenfolge muss in einfache Anführungszeichen gesetzt werden, wobei zwischen Groß-/Kleinschreibung unterschieden wird.
Die Zeichenfolge muss nicht den vollständigen Datenbanknamen enthalten. Partielle Namen werden unterstützt.
Standard: Kein Wert (die Ausgabe wird nicht begrenzt)
Bemerkung
Bei SHOW-Befehlen, die sowohl die
FROM 'name_string'- als auch dieSTARTS WITH 'name_string'-Klausel unterstützen, können Sie diese beiden Klauseln in derselben Anweisung kombinieren. Beide Bedingungen müssen jedoch erfüllt sein, da sie sich sonst gegenseitig aufheben und keine Ergebnisse zurückgegeben werden.Außerdem werden Objekte in lexikographischer Reihenfolge nach Namen zurückgegeben. Daher gibt
FROM 'name_string'nur Zeilen mit einem höheren lexikografischen Wert zurück als die vonSTARTS WITH 'name_string'zurückgegebenen Zeilen.Beispiel:
... STARTS WITH 'A' LIMIT ... FROM 'B'würde keine Ergebnisse zurückgeben.... STARTS WITH 'B' LIMIT ... FROM 'A'würde keine Ergebnisse zurückgeben.... STARTS WITH 'A' LIMIT ... FROM 'AB'würde Ergebnisse zurückgeben (wenn Zeilen mit den Eingabezeichenfolgen übereinstimmen).
Ausgabe¶
Die Befehlsausgabe enthält Eigenschaften und Metadaten des Anwendungsobjekts in den folgenden Spalten:
Spalte |
Beschreibung |
|---|---|
|
Datum und Uhrzeit der Erstellung des Anwendungsobjekts. |
|
Der Name des Anwendungsobjekts. |
|
Gibt an, ob sich das Anwendungsobjekt im Standard-Namespace des Benutzers befindet. |
|
Gibt an, ob sich das Anwendungsobjekt im aktuellen Sitzungskontext befindet. |
|
Gibt die Quelle des Anwendungsobjekts an. Gültige Werte:
|
|
Der Name des Anwendungspakets oder des Freigabeangebots, das zum Erstellen des Anwendungsobjekts verwendet wurde. |
|
Die zum Erstellen des Anwendungsobjekts verwendete Rolle. |
|
Text, der Informationen zum Anwendungsobjekt enthält. |
|
Bezeichner der Version, die zum Erstellen des Anwendungsobjekts verwendet wurde. |
|
Die Versionsbezeichnung des Anwendungsobjekts. Dieses Label ist für den Verbraucher sichtbar, wenn dieser eine Snowflake Native App installiert. |
|
Patchnummer, die zum Erstellen des Anwendungsobjekts verwendet wurde. |
|
Bei einem Anwendungsobjekt ist dieses Feld immer leer. |
|
Die Aufbewahrungsdauer des Anwendungsobjekts. |
|
Der aktuelle Status der Hintergrundinstallation oder des Upgrades des Anwendungsobjekts. Gültige Werte:
|
Beispiele¶
SHOW APPLICATIONS;
+-------------------------------+------------------------+------------+------------+---------------------+----------------------------+---------------+---------+---------------------+-----------------+-------+---------+----------------+
| created_on | name | is_default | is_current | source_type | source | owner | comment | version | label | patch | options | retention_time |
|-------------------------------+------------------------+------------+------------+---------------------+----------------------------+---------------+---------+---------------------+-----------------+-------+---------+----------------|
| 2023-02-03 10:14:09.828 -0800 | hello_snowflake_app | N | Y | APPLICATION PACKAGE | hello_snowflake_package | PROVIDER_ROLE | | v1 | Version v1 | 0 | | 1 |
| 2023-03-22 16:12:40.373 -0700 | PRODUCTION_APP | Y | Y | APPLICATION PACKAGE | hello_snowflake_package | PROVIDER_ROLE | | v2 | Version v2 | 0 | | 1 |
+-------------------------------+------------------------+------------+------------+---------------------+----------------------------+---------------+---------+---------------------+-----------------+-------+---------+----------------+