SHOW APPLICATIONS¶
Lists the Snowflake Native Apps that you have access privileges for across your entire account.
The output returns metadata and properties for the app, ordered lexicographically by name. This is important to note if you want to filter the results using the provided filters.
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¶
The command output provides app properties and metadata in the following columns:
Spalte |
Beschreibung |
|---|---|
|
Date and time when the app was created. |
|
The name of the app. |
|
Specifies whether the app is in the default namespace for the user. |
|
Specifies whether the app is in the current session context. |
|
Specifies the source of the app. The following values are valid:
|
|
The name of the application package or listing used to create the app. |
|
The role used to create the app. |
|
Text that provides information about the app. |
|
The version identifier used to create the app. |
|
The version label of the app. This label is visible to consumers when they install an app. |
|
The patch number used to create the app. |
|
For an app, this field is always empty. |
|
The retention time of the app. |
|
The current state of the background installation or upgrade of the app. The following values are valid:
|
|
Der Grund, warum die App deaktiviert wurde. Weitere Informationen dazu finden Sie unter Deaktivierte Apps. |
|
The timestamp when the app was last upgraded. |
|
Der Name des Release-Kanals, der zur Erstellung der App verwendet wurde. Wenn die App nicht aus einem Release-Kanal erstellt wurde, ist der Wert dieser Eigenschaft |
Nutzungshinweise¶
Für die Ausführung des Befehls ist kein aktives Warehouse erforderlich.
Der Befehl gibt nur Objekte zurück, für die der aktuellen Rolle des aktuellen Benutzers mindestens ein Zugriffsrecht zugewiesen wurde.
Das Zugriffsrecht MANAGE GRANTS gibt seinem Eigentümer implizit die Möglichkeit, jedes Objekt im Konto anzuzeigen. Standardmäßig haben nur der Kontoadministrator (Benutzer mit der Rolle ACCOUNTADMIN) und der Systemadministrator (Benutzer mit der Rolle SECURITYADMIN) die Berechtigung MANAGE GRANTS.
Um die Ausgabe dieses Befehls nachzubearbeiten, können Sie den Befehl Pipe-Operator (
->>) oder die 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
typelautet, geben Sie"type"für den Bezeichner an.
Beispiele¶
SHOW APPLICATIONS;
+-------------------------------+------------------------+------------+------------+---------------------+----------------------------+---------------+---------+---------------------+-----------------+-------+---------+----------------+---------------+-----------+
| created_on | name | is_default | is_current | source_type | source | owner | comment | version | label | patch | options | retention_time | upgrade_state | type |
|-------------------------------+------------------------+------------+------------+---------------------+----------------------------+---------------+---------+---------------------+-----------------+-------+---------+----------------|---------------+-----------+
| 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 | COMPLETE | NATIVE |
| 2023-03-22 16:12:40.373 -0700 | PRODUCTION_APP | Y | Y | APPLICATION PACKAGE | hello_snowflake_package | PROVIDER_ROLE | | v2 | Version v2 | 0 | | 1 | COMPLETE | NATIVE |
+-------------------------------+------------------------+------------+------------+---------------------+----------------------------+---------------+---------+---------------------+-----------------+-------+---------+----------------+---------------+-----------+