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> [ , ... ] ] ]
Copy

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 oder quiescing 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 Wert APPLICATION. . 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%';
Copy
+---------------+-----------+--------------------+---------+-------------------+-------------------+------------------+---------+--------+------------+------------+--------------+-------------+-----------+--------------+-----------+-------+-------------------------------+-------------------------------+-------------------------------+--------------+---------+---------------------------+-------------------------------------+------------------+---------+----------+--------+-----------+----------+----------------+------------------+--------------------+
| 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;
Copy
+------------------------------+-----------+----------+---------+-------------------+-------------------+------------------+---------+--------+------------+------------+--------------+-------------+-----------+--------------+-----------+-------+-------------------------------+-------------------------------+-------------------------------+--------------+-------------------------------------------------+---------------------------+-------------------------------------+------------------+---------+----------+--------+-----------+----------+----------------+-----------------+---------------------+
| 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();
Copy
+------------------------------+-----------+--------------------+---------+
| 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  |
+------------------------------+-----------+--------------------+---------+