ウェアハウス システムテーブル reference

プレビュー

このシステムテーブルは パブリック プレビュー段階です。 テーブルにアクセスするには、 system カタログでスキーマを有効にする必要があります。 詳細については、「 システムテーブル スキーマを有効にする」を参照してください。

この記事では、ウェアハウス システムテーブルを使用して、ワークスペース内の SQLウェアハウスを監視および管理する方法について説明します。 各行は、その時点での SQLウェアハウスプロパティのスナップショットです。 プロパティが変更されると、新しいスナップショットが作成されます。

ウェアハウス システムテーブルは system.compute.warehousesにあります。

ウェアハウス テーブル スキーマ

列名

データ型

説明

例

warehouse_id

string

SQLウェアハウスの ID。

123456789012345

workspace_id

string

倉庫が配置されているワークスペースのID。

123456789012345

account_id

string

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

マップ

SQLウェアハウスのタグ.

{"budget":"research"}

change_time

タイムスタンプ

SQLウェアハウス定義に対する変更のタイムスタンプ。

2023-07-20T19:13:09.504Z

delete_time

タイムスタンプ

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;