Warehouses システム テーブルリファレンス
重要
このシステム テーブルは パブリック プレビュー にあります。 テーブルにアクセスするには、 system
カタログでスキーマを有効にすることが必要です。 詳細については、「システム テーブル スキーマを有効にする」を参照してください。
この記事では、ウェアハウス システム テーブルを使用して、ワークスペース内の SQL ウェアハウスを監視および管理する方法について説明します。 各行は、その時点での SQL ウェアハウスのプロパティのスナップショットです。 プロパティが変更されると、新しいスナップショットが作成されます。
倉庫システム テーブルは、 system.compute.warehouses
にあります。
Warehouses テーブル スキーマ
列名 | データ型 | 説明 | 例 |
---|---|---|---|
warehouse_id |
string | SQL ウェアハウスの ID。 | 123456789012345 |
workspace_id |
string | ウェアハウスがデプロイされているワークスペースの ID。 | 123456789012345 |
account_id |
string | Azure Databricks アカウントの ID。 | 7af234db-66d7-4db3-bbf0-956098224879 |
warehouse_name |
string | SQL ウェアハウスの名前。 | My Serverless Warehouse |
warehouse_type |
string | SQL ウェアハウスの種類。 有効な値は CLASSIC 、PRO 、SERVERLESS です。 |
SERVERLESS |
warehouse_channel |
string | SQL ウェアハウスのチャネル。 設定可能な値は CURRENT および PREVIEW です。 |
CURRENT |
warehouse_size |
string | SQL ウェアハウスのクラスター サイズ。 使用できる値は、 2X_SMALL 、 X_SMALL 、 SMALL 、 MEDIUM 、 LARGE 、 X_LARGE 、 2X_LARGE 、 3X_LARGE 、および 4X_LARGE です。 |
MEDIUM |
min_clusters |
int | 許可されるクラスターの最小数。 | 1 |
max_clusters |
int | 許可されるクラスターの最大数。 | 5 |
auto_stop_minutes |
int | 非アクティブのため SQL ウェアハウスが自動停止するまでの時間 (分)。 | 35 |
tags |
map | SQL ウェアハウスのタグ。 | {"budget":"research"} |
change_time |
timestamp | SQL ウェアハウス定義に対する変更のタイムスタンプ。 | 2023-07-20T19:13:09.504Z |
delete_time |
timestamp | SQL ウェアハウスが削除された日時のタイムスタンプ。 SQL ウェアハウスが削除されていない場合、値は null されます。 |
2023-07-20T19:13:09.504Z |
サンプル クエリ
次のサンプル クエリはテンプレートです。 組織にとって意味のある値をすべて代入します。 これらのクエリにアラートを追加して、ウェアハウスへの変更に関する情報を常に把握することもできます。 「アラートの作成」を参照してください。
ウェアハウスの動作についての分析情報を得るには、次のサンプル クエリを使います。
すべてのアクティブな倉庫の設定を特定する
このクエリは、現在アクティブなすべての倉庫の設定を識別します。
USE CATALOG `system`;
SELECT
warehouse_id,
warehouse_name,
warehouse_type,
warehouse_channel,
warehouse_size,
min_clusters,
max_clusters,
auto_stop_minutes,
tags,
change_time,
delete_time
FROM
system.compute.warehouses
QUALIFY
ROW_NUMBER() OVER (PARTITION BY warehouse_id ORDER BY change_time DESC) = 1
and delete_time is null;
今週作成された倉庫はどれですか?
このクエリは、過去 7 日間に作成された倉庫を識別します。
SELECT
warehouse_id,
warehouse_name,
warehouse_type,
warehouse_channel,
warehouse_size,
min_clusters,
max_clusters,
auto_stop_minutes,
tags,
change_time as datetime_created,
delete_time
FROM
system.compute.warehouses
QUALIFY
ROW_NUMBER() OVER (PARTITION BY warehouse_id ORDER BY change_time ASC) = 1
and change_time >= DATE_TRUNC('day', CURRENT_DATE) - INTERVAL 7 days
and delete_time is null;