通过

仓库系统表参考

  • 项目

重要

此系统表为公共预览版。 若要访问表，必须在 system 目录中启用架构。 有关详细信息，请参阅启用系统表架构。

本文介绍如何使用仓库系统表监视和管理工作区中的 SQL 仓库。 每行都是该时刻 SQL 仓库属性的快照。 属性更改时会创建新的快照。

仓库系统表位于 system.compute.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、 X_LARGESMALLLARGE2X_LARGEMEDIUM3X_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 仓库时的时间戳。 该值是 null 如果未删除 SQL 仓库。 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;