SHOW WAREHOUSES¶
Listet alle Warehouses in Ihrem Konto auf, für die Sie Zugriffsrechte haben.
- Siehe auch:
ALTER WAREHOUSE, CREATE WAREHOUSE, DESCRIBE WAREHOUSE, DROP WAREHOUSE
Syntax¶
SHOW WAREHOUSES
[ LIKE '<pattern>' ]
[ WITH PRIVILEGES <objectPrivilege> [ , <objectPrivilege> [ , ... ] ] ]
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).
WITH PRIVILEGES object_privilege [ , object_privilege [ , ... ] ]
Schränkt optional Zeilen auf Objekte ein, für die die aktive Rolle des aktuellen Benutzers alle in der Liste angegebenen Berechtigungen auf das Objekt erhalten hat.
Wenn eine CREATE <Objekt>-Berechtigung in der Liste der Berechtigungen enthalten ist, schließt der Befehl Objekte aus, für die Sekundärrollen Berechtigungen erhalten haben. Das liegt daran, dass nur die Hauptrolle die Autorisierung hat, Objekte zu erstellen. Weitere Informationen dazu finden Sie unter Durchsetzungsmodell mit Primärrolle und Sekundärrollen.
Nutzungshinweise¶
Spalten, die mit dem Präfix
is_
beginnen, geben entwederY
(ja) oderN
(nein) zurück.Für die Ausführung des Befehls ist kein aktives Warehouse erforderlich.
Der Befehl gibt maximal 10.000 Datensätze für den angegebenen Objekttyp zurück, wie durch die Zugriffsrechte für die Rolle vorgegeben, die zur Ausführung des Befehls verwendet wird. Datensätze, die über dem Limit von 10.000 liegen, werden nicht zurückgegeben, selbst wenn ein Filter angewendet wird.
Um Ergebnisse anzuzeigen, für die mehr als 10.000 Datensätze existieren, fragen Sie die entsprechende Ansicht (falls vorhanden) in der Datei Snowflake Information Schema ab.
Um die Ausgabe dieses Befehls nachzubearbeiten, können Sie die Funktion RESULT_SCAN verwenden, die die Ausgabe wie eine abfragbare Tabelle behandelt.
Ausgabe¶
Die Spalten in der Ausgabe enthalten die folgenden Informationen: Für Konten, bei denen das Feature Abfragebeschleunigungsdienst aktiviert ist, enthält die Ausgabe die zusätzliche Informationen.
Spalte
Beschreibung
name
Name des Warehouses.
state
Ob das Warehouse:
aktiv/in Betrieb (
STARTED
), inaktiv (SUSPENDED
), oder in der Größenanpassung (RESIZING
) ist
type
Warehouse-Typ STANDARD und SNOWPARK-OPTIMIZED sind die einzigen derzeit unterstützten Typen.
size
Größe des Warehouses (X-Small, Small, Medium, Large, X-Large usw.)
min_cluster_count
Minimale Anzahl von Clustern für das (Multi-Cluster-)Warehouse (immer 1 für Einzel-Cluster-Warehouses).
max_cluster_count
Maximale Anzahl von Clustern für das (Multi-Cluster-)Warehouse (immer 1 für Einzel-Cluster-Warehouses).
started_clusters
Anzahl der aktuell gestarteten Cluster.
running
Anzahl der SQL-Anweisungen, die vom Warehouse ausgeführt werden.
queued
Anzahl der SQL-Anweisungen, die sich für das Warehouse in der Warteschlange befinden.
is_default
Gibt an, ob das Warehouse der Standard für den aktuellen Benutzer ist.
is_current
Ob das Warehouse für die Sitzung verwendet wird.
Es kann jeweils nur ein Warehouse für eine Sitzung verwendet werden. Verwenden Sie den Befehl USE WAREHOUSE, um das Warehouse für eine Sitzung anzugeben oder zu ändern.
auto_suspend
Zeitraum der Inaktivität in Sekunden, nach dem ein laufendes Warehouse automatisch angehalten wird und keine Credits mehr verbraucht.
Ein Wert von
null
bedeutet, dass das Warehouse nie automatisch angehalten wird.
auto_resume
Ob das Warehouse, wenn es angehalten wurde, automatisch fortgesetzt wird, wenn eine Abfrage an das Warehouse gesendet wird.
available
Prozentsatz der bereitgestellten und verfügbaren Computeressourcen des Warehouses.
provisioning
Prozentsatz der Computeressourcen des Warehouses, die gerade bereitgestellt werden.
quiescing
Prozentsatz der Computeressourcen des Warehouses, die SQL-Anweisungen ausführen, jedoch nach Abschluss der Abfragen heruntergefahren werden.
other
Prozentsatz der Computeressourcen des Warehouses, die sich in einem anderen Status als
available
,provisioning
oderquiescing
befinden.
created_on
Datum und Uhrzeit der Erstellung des Warehouses.
resumed_on
Datum und Uhrzeit, zu denen das Warehouse zuletzt gestartet oder neu gestartet wurde.
updated_on
Datum und Uhrzeit der letzten Aktualisierung des Warehouses, einschließlich der Änderung der Eigenschaften des Warehouses oder des Zustands (
STARTED
,SUSPENDED
,RESIZING
) des Warehouses.
owner
Rolle, die Eigentümer des Warehouses ist.
comment
Kommentar zum Warehouse.
enable_query_acceleration
Ob der Query Acceleration Service für das Warehouse aktiviert ist.
query_acceleration_max_scale_factor
Maximaler Skalierungsfaktor für den Abfragebeschleunigungsdienst.
resource_monitor
ID des Ressourcenmonitors, der dem Warehouse explizit zugeordnet ist; steuert die monatliche Credit-Nutzung für das Warehouse.
actives
,pendings
,failed
,suspended
,uuid
Diese fünf Spalten sind für den internen Gebrauch bestimmt und werden in einem zukünftigen Release entfernt.
scaling_policy
Richtlinie, die bestimmt, wann zusätzliche Cluster (in einem Warehouse mit mehreren Clustern) automatisch gestartet und heruntergefahren werden.
budget
Name des Budgets, wenn das Objekt durch ein Budget überwacht wird. Andernfalls NULL.
owner_role_type
Der Typ der Rolle, die Eigentümer des Objekts ist, zum Beispiel
ROLE
. . Wenn eine Snowflake Native App Eigentümer des Objekts ist, ist der WertAPPLICATION
. . Wenn Sie das Objekt löschen, gibt Snowflake den Wert NULL zurück, da ein gelöschtes Objekt keine Eigentümerrolle hat.
resource_constraint
Wenn Typ
SNOWPARK-OPTIMIZED
ist, ist eine der folgenden Optionen verfügbar:
MEMORY_1X
,MEMORY_1X_x86
,MEMORY_16X
,MEMORY_16X_x86
,MEMORY_64X
,MEMORY_64X_x86
.Ansonsten
NULL
.
Weitere Informationen zu den Eigenschaften, die für ein Warehouse angegeben werden können, finden Sie unter CREATE WAREHOUSE.
Beispiele¶
Anzeigen der Warehouses, deren Name mit test
beginnt und für die Sie über Berechtigungen zum Anzeigen verfügen:
SHOW WAREHOUSES LIKE 'test%';
+---------------+-----------+--------------------+---------+-------------------+-------------------+------------------+---------+--------+------------+------------+--------------+-------------+-----------+--------------+-----------+-------+-------------------------------+-------------------------------+-------------------------------+--------------+---------+---------------------------+-------------------------------------+------------------+---------+----------+--------+-----------+----------+----------------+----------+-----------------+---------------------+
| name | state | type | size | min_cluster_count | max_cluster_count | started_clusters | running | queued | is_default | is_current | auto_suspend | auto_resume | available | provisioning | quiescing | other | created_on | resumed_on | updated_on | owner | comment | enable_query_acceleration | query_acceleration_max_scale_factor | resource_monitor | actives | pendings | failed | suspended | uuid | scaling_policy | budget | owner_role_type | resource_constraint |
|---------------+-----------+--------------------+---------+-------------------+-------------------+------------------+---------+--------+------------+------------+--------------+-------------+-----------+--------------+-----------+-------+-------------------------------+-------------------------------+-------------------------------+--------------+---------+---------------------------+-------------------------------------+------------------+---------+----------+--------+-----------+----------+----------------+----------|-----------------|---------------------+
| TEST1 | SUSPENDED | STANDARD | Medium | 1 | 1 | 0 | 0 | 0 | N | N | 600 | true | | | | | 2023-01-27 14:57:07.768 -0800 | 2023-05-10 16:17:49.258 -0700 | 2023-05-10 16:17:49.258 -0700 | MY_ROLE | | true | 8 | null | 0 | 0 | 0 | 4 | 76064 | STANDARD | NULL | ROLE | NULL +
| TEST2 | SUSPENDED | STANDARD | X-Small | 1 | 1 | 0 | 0 | 0 | N | N | 600 | true | | | | | 2023-01-27 14:57:07.953 -0800 | 1969-12-31 16:00:00.000 -0800 | 2023-01-27 14:57:08.356 -0800 | MY_ROLE | | true | 16 | MYTEST_RM | 0 | 0 | 0 | 1 | 76116 | STANDARD | MYBUDGET | ROLE | NULL +
| TEST3 | SUSPENDED | STANDARD | Small | 1 | 1 | 0 | 0 | 0 | N | N | 600 | true | | | | | 2023-08-08 10:26:45.534 -0700 | 2023-08-08 10:26:45.681 -0700 | 2023-08-08 10:26:45.681 -0700 | MY_ROLE | | false | 8 | null | 0 | 0 | 0 | 2 | 19464517 | STANDARD | NULL | ROLE | NULL +
| TEST4 | RESUMING | SNOWPARK-OPTIMIZED | Large | 1 | 1 | 0 | 0 | 0 | N | Y | 600 | true | | | | | 2023-09-21 17:29:58.165 -0700 | 2023-09-21 17:29:58.165 -0700 | 2023-09-21 17:29:58.207 -0700 | MY_ROLE | | false | 8 | null | 0 | 0 | 0 | 0 | 19464585 | STANDARD | NULL | ROLE | MEMORY_16X_X86 +
+---------------+-----------+--------------------+---------+-------------------+-------------------+------------------+---------+--------+------------+------------+--------------+-------------+-----------+--------------+-----------+-------+-------------------------------+-------------------------------+-------------------------------+--------------+---------+---------------------------+-------------------------------------+------------------+---------+----------+--------+-----------+----------+----------------+----------+-----------------+---------------------+
Zeigen Sie die Warehouses an, für die Sie die Berechtigungen MODIFY und OPERATE haben:
SHOW WAREHOUSES WITH PRIVILEGES MODIFY, OPERATE;
+------------------------------+-----------+----------+---------+-------------------+-------------------+------------------+---------+--------+------------+------------+--------------+-------------+-----------+--------------+-----------+-------+-------------------------------+-------------------------------+-------------------------------+--------------+-------------------------------------------------+---------------------------+-------------------------------------+------------------+---------+----------+--------+-----------+----------+----------------+--------------------------+-----------------+---------------------+
| name | state | type | size | min_cluster_count | max_cluster_count | started_clusters | running | queued | is_default | is_current | auto_suspend | auto_resume | available | provisioning | quiescing | other | created_on | resumed_on | updated_on | owner | comment | enable_query_acceleration | query_acceleration_max_scale_factor | resource_monitor | actives | pendings | failed | suspended | uuid | scaling_policy | budget | owner_role_type |
|------------------------------+-----------+----------+---------+-------------------+-------------------+------------------+---------+--------+------------+------------+--------------+-------------+-----------+--------------+-----------+-------+-------------------------------+-------------------------------+-------------------------------+--------------+-------------------------------------------------+---------------------------+-------------------------------------+------------------+---------+----------+--------+-----------+----------+----------------+--------------------------+-----------------+---------------------+
| TEST_WH | SUSPENDED | STANDARD | X-Small | 1 | 1 | 0 | 0 | 0 | Y | Y | 600 | true | | | | | 2023-01-27 14:57:07.768 -0800 | 2024-07-30 13:39:24.118 -0700 | 2024-07-30 13:39:24.118 -0700 | TEST_ROLE | | true | 32 | TEST_RM | 0 | 0 | 0 | 1 | 76056 | STANDARD | KATS_RENAMED_TEST_BUDGET | ROLE | NULL +
| SNOWPARK_DEMO | SUSPENDED | STANDARD | X-Large | 1 | 1 | 0 | 0 | 0 | N | N | 600 | true | | | | | 2023-01-27 14:57:07.903 -0800 | 2023-04-10 11:47:03.146 -0700 | 2023-04-10 11:47:03.146 -0700 | ACCOUNTADMIN | Created by straut for Snowpark quickstart | false | 8 | null | 0 | 0 | 0 | 16 | 76104 | STANDARD | NULL | ROLE | NULL +
| TASTY_DEV_WH | SUSPENDED | STANDARD | X-Small | 1 | 1 | 0 | 0 | 0 | N | N | 60 | true | | | | | 2023-10-25 16:25:43.681 -0700 | 2023-10-25 16:25:43.681 -0700 | 2023-10-25 16:25:43.711 -0700 | SYSADMIN | developer warehouse for tasty bytes | false | 8 | null | 0 | 0 | 0 | 1 | 19464633 | STANDARD | NULL | ROLE | NULL +
| TB_DOCS_WH | SUSPENDED | STANDARD | X-Small | 1 | 1 | 0 | 0 | 0 | N | N | 60 | true | | | | | 2024-07-24 15:02:32.172 -0700 | 2024-07-24 15:33:30.502 -0700 | 2024-07-24 15:33:30.502 -0700 | SYSADMIN | developer warehouse for tasty bytes | false | 8 | null | 0 | 0 | 0 | 1 | 19465097 | STANDARD | NULL | ROLE | NULL +
+------------------------------+-----------+----------+---------+-------------------+-------------------+------------------+---------+--------+------------+------------+--------------+-------------+-----------+--------------+-----------+-------+-------------------------------+-------------------------------+-------------------------------+--------------+-------------------------------------------------+---------------------------+-------------------------------------+------------------+---------+----------+--------+-----------+----------+----------------+--------------------------+-----------------+---------------------+