倉儲系統數據表參考

重要

此系統資料表處於公開預覽狀態。 若要存取資料表，必須在system目錄啟用結構描述。 如需詳細資訊，請參閱啟用系統資料表結構描述。

在本文中，您將瞭解如何使用倉儲系統數據表來監視和管理工作區中的 SQL 倉儲。 每個數據列都是目前 SQL 倉儲屬性的快照集。 屬性變更時會建立新的快照集。

倉儲系統資料表位於 system.compute.warehouses。

倉儲數據表架構

資料行名稱	資料類型	描述	範例
warehouse_id	字串	SQL 倉儲的標識碼。	123456789012345
workspace_id	字串	部署倉儲之工作區的標識碼。	123456789012345
account_id	字串	Azure Databricks 帳戶的識別碼。	7af234db-66d7-4db3-bbf0-956098224879
warehouse_name	字串	SQL 倉儲的名稱。	My Serverless Warehouse
warehouse_type	字串	SQL 倉儲的類型。 可能的值是 CLASSIC、PRO、SERVERLESS。	SERVERLESS
warehouse_channel	字串	SQL 倉儲的通道。 可能的值是 CURRENT 和 PREVIEW。	CURRENT
warehouse_size	字串	SQL 倉儲的叢集大小。 可能的值為 、、、、SMALL2X_LARGEMEDIUMX_LARGELARGE、、 3X_LARGE和 。4X_LARGEX_SMALL2X_SMALL	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;

本周建立了哪些倉庫？

此查詢會識別過去七天內建立的倉儲。

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;