SHOW WAREHOUSES¶
Listet alle virtuellen 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 Autorisierung durch Primärrolle und Sekundärrollen.
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.
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.
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.
Zur Weiterverarbeitung der Ausgabe dieses Befehls können Sie die Funktion RESULT_SCAN verwenden, die die Ausgabe wie eine abfragbare Tabelle behandelt. Sie können auch den Pipe-Operator verwenden, um die Ausgabe dieses Befehls abzufragen.
Der Befehl gibt maximal zehntausend Datensätze für den angegebenen Objekttyp zurück, entsprechend den Zugriffsrechten für die zur Ausführung des Befehls verwendete Rolle. Datensätze, die die Grenze von zehntausend Datensätzen überschreiten, werden nicht zurückgegeben, selbst wenn ein Filter angewendet wurde.
Um Ergebnisse anzuzeigen, für die mehr als zehntausend Datensätze existieren, fragen Sie die entsprechende Ansicht (sofern vorhanden) in Snowflake Information Schema ab.
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 | 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 | 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 | 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 | 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 | 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 | 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 | 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 | 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 | 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 | ROLE | NULL +
+------------------------------+-----------+----------+---------+-------------------+-------------------+------------------+---------+--------+------------+------------+--------------+-------------+-----------+--------------+-----------+-------+-------------------------------+-------------------------------+-------------------------------+--------------+-------------------------------------------------+---------------------------+-------------------------------------+------------------+---------+----------+--------+-----------+----------+----------------+-----------------+---------------------+
Zeigen Sie bestimmte Details über Warehouses an, indem Sie Daten aus der vollständigen Ausgabe von SHOW WAREHOUSES filtern und neu anordnen. Diese gespeicherte Prozedur führt einen SHOW WAREHOUSES-Befehl aus und ruft dann die Funktion RESULT_SCAN auf, um das Resultset des letzten SQL-Befehls zu filtern und zu transformieren. Sie können diese Technik verwenden, um verschiedene Arten von Berichten zu erstellen, wenn Sie nicht die gesamte Ausgabe eines SHOW-Befehls benötigen.
CREATE OR REPLACE PROCEDURE started_and_suspended_warehouses()
RETURNS TABLE(name VARCHAR, status VARCHAR, type VARCHAR, size VARCHAR)
LANGUAGE SQL
AS
$$
DECLARE
res RESULTSET;
BEGIN
SHOW WAREHOUSES;
res := (SELECT "name" name, "state" state, "type" type, "size" size
FROM TABLE(RESULT_SCAN(LAST_QUERY_ID(-1)))
WHERE "state" IN ('STARTED','SUSPENDED')
ORDER BY "state", "name");
RETURN TABLE(res);
END;
$$
;
CALL started_and_suspended_warehouses();
+------------------------------+-----------+--------------------+---------+
| NAME | STATUS | TYPE | SIZE |
|------------------------------+-----------+--------------------+---------|
| COMPUTE_WH | STARTED | STANDARD | X-Small |
| DEFAULT_SIZE | SUSPENDED | STANDARD | Small |
| DEFAULT_SIZE_2 | SUSPENDED | STANDARD | X-Small |
| MEDIUM | SUSPENDED | SNOWPARK-OPTIMIZED | Medium |
| PRIV_WH | SUSPENDED | STANDARD | X-Small |
| SYSTEM$STREAMLIT_NOTEBOOK_WH | SUSPENDED | STANDARD | X-Small |
| XSMALL | SUSPENDED | STANDARD | Medium |
+------------------------------+-----------+--------------------+---------+