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> [ , ... ] ] ]
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 Durchsetzungsmodell mit Primärrolle und Sekundärrollen.

Nutzungshinweise

  • Spalten, die mit dem Präfix is_ beginnen, geben entweder Y (ja) oder N (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 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.

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 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.

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 | 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;
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 | 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                +
+------------------------------+-----------+----------+---------+-------------------+-------------------+------------------+---------+--------+------------+------------+--------------+-------------+-----------+--------------+-----------+-------+-------------------------------+-------------------------------+-------------------------------+--------------+-------------------------------------------------+---------------------------+-------------------------------------+------------------+---------+----------+--------+-----------+----------+----------------+--------------------------+-----------------+---------------------+