次の方法で共有


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 ウェアハウスの種類。 有効な値は CLASSICPROSERVERLESS です。 SERVERLESS
warehouse_channel string SQL ウェアハウスのチャネル。 設定可能な値は CURRENT および PREVIEW です。 CURRENT
warehouse_size string SQL ウェアハウスのクラスター サイズ。 使用できる値は、 2X_SMALLX_SMALLSMALLMEDIUMLARGEX_LARGE2X_LARGE3X_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;