Information Schema（实例级）

实例级 Information Schema 存储整个实例的元数据，包含所有工作空间的对象信息、用户权限、计费用量等。通过

sys.information_schema.<视图名>

sys.information_schema.<视图名>

访问。

-- 示例：查看实例下所有工作空间 SELECT workspace_name, create_time FROM sys.information_schema.workspaces; -- 示例：查看实例下所有 Schema（跨工作空间） SELECT catalog_name, schema_name, type FROM sys.information_schema.schemas;

WORKSPACES

记录实例下所有工作空间的信息。

字段	类型	说明
`workspace_id` workspace_id	BIGINT	工作空间 ID
`workspace_name` workspace_name	STRING	工作空间名称
`workspace_creator` workspace_creator	STRING	创建者账号名
`workspace_creator_id` workspace_creator_id	BIGINT	创建者账号 ID
`create_time` create_time	TIMESTAMP_LTZ	创建时间
`last_modify_time` last_modify_time	TIMESTAMP_LTZ	最后修改时间
`delete_time` delete_time	TIMESTAMP_LTZ	删除时间（未删除为 NULL）
`comment` comment	STRING	注释
`properties` properties	MAP<STRING,STRING>	创建时设置的属性

SCHEMAS

记录实例下所有工作空间中的 Schema 信息。

字段	类型	说明
`catalog_name` catalog_name	STRING	所属工作空间名称
`schema_id` schema_id	BIGINT	Schema ID
`schema_name` schema_name	STRING	Schema 名称
`type` type	STRING	Schema 类型，如 `MANAGED` MANAGED 、 `SHARED` SHARED 、 `EXTERNAL` EXTERNAL
`schema_creator` schema_creator	STRING	创建者账号名
`schema_creator_id` schema_creator_id	BIGINT	创建者账号 ID
`create_time` create_time	TIMESTAMP_LTZ	创建时间
`last_modify_time` last_modify_time	TIMESTAMP_LTZ	最后修改时间
`delete_time` delete_time	TIMESTAMP_LTZ	删除时间（未删除为 NULL）
`comment` comment	STRING	注释
`properties` properties	MAP<STRING,STRING>	创建时设置的属性

TABLES

记录实例下所有工作空间中的表信息。

字段	类型	说明
`table_catalog` table_catalog	STRING	所属工作空间名称
`table_catalog_id` table_catalog_id	BIGINT	所属工作空间 ID
`table_schema` table_schema	STRING	所属 Schema 名称
`table_schema_id` table_schema_id	BIGINT	所属 Schema ID
`table_name` table_name	STRING	表名称
`table_id` table_id	BIGINT	表 ID
`table_creator` table_creator	STRING	创建者账号名
`table_creator_id` table_creator_id	BIGINT	创建者账号 ID
`table_type` table_type	STRING	表类型，如 `MANAGED_TABLE` MANAGED_TABLE 、 `DYNAMIC_TABLE` DYNAMIC_TABLE 、 `MATERIALIZED_VIEW` MATERIALIZED_VIEW 、 `VIRTUAL_VIEW` VIRTUAL_VIEW 、 `SEMANTIC_VIEW` SEMANTIC_VIEW 、 `EXTERNAL_TABLE` EXTERNAL_TABLE
`row_count` row_count	BIGINT	行数（VIEW 为 NULL）
`bytes` bytes	BIGINT	数据大小（字节，VIEW 为 NULL）
`create_time` create_time	TIMESTAMP_LTZ	创建时间
`last_modify_time` last_modify_time	TIMESTAMP_LTZ	最后修改时间
`delete_time` delete_time	TIMESTAMP_LTZ	删除时间（未删除为 NULL）
`is_partitioned` is_partitioned	BOOLEAN	是否分区表
`is_clustered` is_clustered	BOOLEAN	是否分桶表
`comment` comment	STRING	注释
`properties` properties	MAP<STRING,STRING>	创建时设置的属性
`data_lifecycle` data_lifecycle	INT	数据生命周期（天），NULL 表示未设置

COLUMNS

记录实例下所有表的字段信息。

字段	类型	说明
`table_catalog` table_catalog	STRING	所属工作空间名称
`table_catalog_id` table_catalog_id	BIGINT	所属工作空间 ID
`table_schema` table_schema	STRING	所属 Schema 名称
`table_schema_id` table_schema_id	BIGINT	所属 Schema ID
`table_name` table_name	STRING	所属表名称
`table_id` table_id	BIGINT	所属表 ID
`column_name` column_name	STRING	字段名称
`column_id` column_id	INT	字段 ID
`column_default` column_default	BOOLEAN	默认值
`is_nullable` is_nullable	BOOLEAN NOT NULL	是否允许 NULL
`data_type` data_type	STRING	字段类型
`comment` comment	STRING	字段注释
`is_primary_key` is_primary_key	BOOLEAN NOT NULL	是否主键
`is_clustering_column` is_clustering_column	BOOLEAN NOT NULL	是否分桶列
`create_time` create_time	TIMESTAMP_LTZ	创建时间
`delete_time` delete_time	TIMESTAMP_LTZ	删除时间（未删除为 NULL）

VIEWS

记录实例下所有视图（普通视图）的信息。

字段	类型	说明
`table_catalog` table_catalog	STRING	所属工作空间名称
`table_catalog_id` table_catalog_id	BIGINT	所属工作空间 ID
`table_schema` table_schema	STRING	所属 Schema 名称
`table_schema_id` table_schema_id	BIGINT	所属 Schema ID
`table_name` table_name	STRING	视图名称
`table_id` table_id	BIGINT	视图 ID
`table_creator` table_creator	STRING	创建者账号名
`table_creator_id` table_creator_id	BIGINT	创建者账号 ID
`view_definition` view_definition	STRING	创建视图的 SQL 定义
`create_time` create_time	TIMESTAMP_LTZ	创建时间
`last_modify_time` last_modify_time	TIMESTAMP_LTZ	最后修改时间
`delete_time` delete_time	TIMESTAMP_LTZ	删除时间（未删除为 NULL）
`comment` comment	STRING	注释

USERS

记录实例下所有工作空间的用户信息。

字段	类型	说明
`workspace_id` workspace_id	BIGINT	所属工作空间 ID
`workspace_name` workspace_name	STRING	所属工作空间名称
`user_id` user_id	BIGINT	用户 ID
`user_name` user_name	STRING	用户账号名
`role_names` role_names	STRING	用户拥有的角色，多个角色以逗号分隔
`create_time` create_time	TIMESTAMP_LTZ	用户加入工作空间的时间
`email` email	STRING	用户邮箱
`telphone` telphone	STRING	用户电话
`comment` comment	STRING	注释
`properties` properties	MAP<STRING,STRING>	创建时设置的属性
`delete_time` delete_time	TIMESTAMP_LTZ	移除时间（未移除为 NULL）

ROLES

记录实例下所有工作空间的角色信息。

字段	类型	说明
`workspace_id` workspace_id	BIGINT	所属工作空间 ID
`workspace_name` workspace_name	STRING	所属工作空间名称
`role_name` role_name	STRING	角色名称
`role_id` role_id	BIGINT	角色 ID
`user_names` user_names	STRING	被授予该角色的用户名，多个用逗号分隔
`user_ids` user_ids	STRING	被授予该角色的用户 ID，多个用逗号分隔
`comment` comment	STRING	注释
`properties` properties	MAP<STRING,STRING>	创建时设置的属性
`delete_time` delete_time	TIMESTAMP_LTZ	删除时间（未删除为 NULL）

CONNECTIONS

记录实例下所有工作空间的连接对象信息。

字段	类型	说明
`workspace_name` workspace_name	STRING	所属工作空间名称
`workspace_id` workspace_id	BIGINT	所属工作空间 ID
`connection_name` connection_name	STRING	连接名称
`connection_id` connection_id	BIGINT	连接 ID
`connection_kind` connection_kind	STRING	连接类型，如 `STORAGE_CONNECTION` STORAGE_CONNECTION 、 `STORAGE` STORAGE 、 `CATALOG` CATALOG 、 `API` API
`type` type	STRING	数据源类型，如 `FILE_SYSTEM` FILE_SYSTEM 、 `CLOUD_FUNCTION` CLOUD_FUNCTION 、 `OSS` OSS 、 `KAFKA` KAFKA 、 `MESSAGE_QUEUE` MESSAGE_QUEUE 、 `DATABRICKS_UNITY_CATALOG` DATABRICKS_UNITY_CATALOG
`provider` provider	STRING	云厂商，如 `OSS` OSS 、 `COS` COS 、 `S3` S3 、 `aliyun` aliyun 、 `tencent` tencent
`region` region	STRING	连接所在区域，如 `cn-shanghai` cn-shanghai 、 `ap-beijing` ap-beijing
`source_creator` source_creator	STRING	创建者账号名
`create_time` create_time	TIMESTAMP_LTZ	创建时间
`last_modify_time` last_modify_time	TIMESTAMP_LTZ	最后修改时间
`delete_time` delete_time	TIMESTAMP_LTZ	删除时间（未删除为 NULL）
`comment` comment	STRING	注释
`properties` properties	MAP<STRING,STRING>	创建时设置的属性

VOLUMES

记录实例下所有工作空间的 Volume 信息。

字段	类型	说明
`volume_catalog` volume_catalog	STRING	所属工作空间名称
`volume_catalog_id` volume_catalog_id	BIGINT	所属工作空间 ID
`volume_schema` volume_schema	STRING	所属 Schema 名称
`volume_schema_id` volume_schema_id	BIGINT	所属 Schema ID
`volume_name` volume_name	STRING	Volume 名称
`volume_id` volume_id	BIGINT	Volume ID
`volume_url` volume_url	STRING	挂载路径（内部 Volume 为空）
`volume_region` volume_region	STRING	Volume 所在区域
`volume_type` volume_type	STRING	Volume 类型，如 `MANAGED` MANAGED （内部）或 `EXTERNAL` EXTERNAL （外部）
`volume_creator` volume_creator	STRING	创建者账号名
`connection_name` connection_name	STRING	引用的 Connection 名称（内部 Volume 为空）
`connection_id` connection_id	BIGINT	引用的 Connection ID
`comment` comment	STRING	注释
`properties` properties	MAP<STRING,STRING>	创建时设置的属性
`create_time` create_time	TIMESTAMP_LTZ	创建时间
`last_modify_time` last_modify_time	TIMESTAMP_LTZ	最后修改时间
`delete_time` delete_time	TIMESTAMP_LTZ	删除时间（未删除为 NULL）

JOB_HISTORY

记录实例下所有作业的执行历史。

字段	类型	说明
`workspace_name` workspace_name	STRING	作业所在工作空间名称
`workspace_id` workspace_id	BIGINT	作业所在工作空间 ID
`job_id` job_id	STRING	作业 ID
`job_name` job_name	STRING	作业名称
`job_creator` job_creator	STRING	提交作业的用户账号名
`job_creator_id` job_creator_id	BIGINT	提交作业的用户 ID
`status` status	STRING	作业状态，如 `SUCCEED` SUCCEED 、 `FAILED` FAILED 、 `CANCELLED` CANCELLED
`cru` cru	DOUBLE	消耗的计算资源（CRU·时）
`error_message` error_message	STRING	失败时的错误信息
`job_type` job_type	STRING	作业类型，如 `SQL_JOB` SQL_JOB 、 `COMPACTION_JOB` COMPACTION_JOB
`job_sub_type` job_sub_type	STRING	作业子类型
`job_text` job_text	STRING	执行的 SQL 文本
`start_time` start_time	TIMESTAMP_LTZ	开始时间
`end_time` end_time	TIMESTAMP_LTZ	结束时间
`execution_time` execution_time	DOUBLE	执行时长（秒，精确到毫秒）
`input_bytes` input_bytes	BIGINT	实际扫描的数据量（字节）
`output_bytes` output_bytes	BIGINT	输出数据量（字节）
`input_objects` input_objects	STRING	输入对象名称
`output_objects` output_objects	STRING	输出对象名称
`input_tables` input_tables	STRING	输入表名称
`output_tables` output_tables	STRING	输出表名称
`cache_hit` cache_hit	BIGINT	从缓存中读取的数据量（字节）
`rows_produced` rows_produced	BIGINT	处理的总行数
`rows_inserted` rows_inserted	BIGINT	插入行数
`rows_updated` rows_updated	BIGINT	更新行数
`rows_deleted` rows_deleted	BIGINT	删除行数
`virtual_cluster` virtual_cluster	STRING	使用的计算集群名称
`virtual_cluster_id` virtual_cluster_id	BIGINT	使用的计算集群 ID
`job_config` job_config	STRING	提交时设置的参数
`job_priority` job_priority	STRING NOT NULL	作业优先级
`query_tag` query_tag	STRING	用户设置的查询标签
`client_info` client_info	STRING	客户端信息（来源于 JDBC、CLI、Web 等）
`pt_date` pt_date	STRING	分区日期，用于按日过滤

MATERIALIZED_VIEW_REFRESH_HISTORY

记录物化视图的刷新历史。

字段	类型	说明
`workspace_id` workspace_id	BIGINT	所属工作空间 ID
`workspace_name` workspace_name	STRING	所属工作空间名称
`schema_id` schema_id	BIGINT	所属 Schema ID
`schema_name` schema_name	STRING	所属 Schema 名称
`materialized_view_id` materialized_view_id	BIGINT	物化视图 ID
`materialized_view_name` materialized_view_name	STRING	物化视图名称
`cru` cru	DOUBLE	刷新消耗的计算资源（CRU·时）
`virtual_cluster_id` virtual_cluster_id	BIGINT	使用的计算集群 ID
`virtual_cluster_name` virtual_cluster_name	STRING	使用的计算集群名称
`status` status	STRING	刷新状态，如 `SUCCEED` SUCCEED 、 `FAILED` FAILED
`scheduled_start_time` scheduled_start_time	TIMESTAMP_LTZ	计划刷新时间
`start_time` start_time	TIMESTAMP_LTZ	实际开始时间
`end_time` end_time	TIMESTAMP_LTZ	结束时间
`error_code` error_code	STRING	错误码
`error_message` error_message	STRING	失败时的错误信息
`pt_date` pt_date	DATE	分区日期，用于按日过滤

AUTOMV_REFRESH_HISTORY

记录 Auto Materialized View 的刷新历史。

字段	类型	说明
`workspace_name` workspace_name	STRING	所属工作空间名称
`schema_name` schema_name	STRING	所属 Schema 名称
`materialized_view_name` materialized_view_name	STRING	物化视图名称
`cru` cru	DOUBLE	刷新消耗的计算资源（CRU·时）
`status` status	STRING	`PROCESSING` PROCESSING 、 `SUCCEEDED` SUCCEEDED 、 `FAILED` FAILED 、 `CANCELLED` CANCELLED
`mv_process_type` mv_process_type	STRING NOT NULL	`BUILD` BUILD （首次构建）或 `REFRESH` REFRESH （增量刷新）
`start_time` start_time	TIMESTAMP_LTZ	开始时间
`end_time` end_time	TIMESTAMP_LTZ	结束时间
`build_from_workspace` build_from_workspace	STRING	源表所在工作空间名称
`build_from_workspace_id` build_from_workspace_id	BIGINT	源表所在工作空间 ID
`job_id` job_id	STRING	对应的作业 ID
`error_message` error_message	STRING	失败时的错误信息
`pt_date` pt_date	STRING	分区日期，用于按日过滤

OBJECT_PRIVILEGES

记录实例下所有对象的权限授予信息。

字段	类型	说明
`grantee` grantee	STRING	被授权者名称（用户名或角色名）
`grantor` grantor	STRING	授权者名称
`granted_to` granted_to	STRING NOT NULL	被授权者类型，如 `user` user 、 `role` role
`object_catalog` object_catalog	STRING	对象所在工作空间名称
`object_schema` object_schema	STRING	对象所在 Schema 名称
`object_name` object_name	STRING	对象名称
`object_type` object_type	STRING	对象类型，如 `TABLE` TABLE 、 `SCHEMA` SCHEMA 、 `VIRTUAL_CLUSTER` VIRTUAL_CLUSTER 、 `FUNCTION` FUNCTION 、 `INDEX` INDEX 等
`sub_object_type` sub_object_type	STRING	子对象类型
`privilege_type` privilege_type	STRING	权限类型，如 `["AT_ALL"]` ["AT_ALL"] 、 `["SELECT"]` ["SELECT"] 等（JSON 数组格式）
`is_grantable` is_grantable	BOOLEAN	是否可转授
`authorization_time` authorization_time	TIMESTAMP_LTZ	授权时间

INSTANCE_USAGE

记录实例的计算资源用量和费用明细，按天聚合。

字段	类型	说明
`account_id` account_id	BIGINT	账号 ID
`account_name` account_name	STRING	账号名称
`instance_id` instance_id	BIGINT	实例 ID
`region_name` region_name	STRING NOT NULL	实例所在区域，如 `阿里云-华东2（上海）` 阿里云-华东2（上海）
`sku_category` sku_category	STRING	计费类别，如 `compute` compute 、 `storage` storage 、 `network` network
`sku_name` sku_name	VARCHAR(255)	计费项名称，如 `作业缓存存储` 作业缓存存储
`workspace_id` workspace_id	BIGINT	工作空间 ID
`workspace_name` workspace_name	STRING	工作空间名称
`measurement_start` measurement_start	STRING	计量周期开始时间
`measurement_end` measurement_end	STRING	计量周期结束时间
`measurements_unit` measurements_unit	VARCHAR(50)	计量单位，如 `yuan/GiB/day` yuan/GiB/day 、 `yuan/CRU/hour` yuan/CRU/hour
`measurements_consumption` measurements_consumption	DOUBLE	实际用量
`price_rate` price_rate	DECIMAL(13,7)	单价
`amount` amount	DOUBLE	费用金额（元）
`discount_rate` discount_rate	DOUBLE NOT NULL	折扣率
`total_after_discount` total_after_discount	DOUBLE	折后费用（元）

常见

sku_name

sku_name

包括

AP类型计算集群

AP类型计算集群

、

GP类型计算集群

GP类型计算集群

、

任务调度

任务调度

、

数据集成

数据集成

、

流式集成

流式集成

。其中

measurements_consumption

measurements_consumption

表示对应周期消耗的 CRU 量，

amount

amount

为原始金额，

total_after_discount

total_after_discount

为折后金额。

STORAGE_METERING

记录实例的存储用量和费用明细，字段结构与

INSTANCE_USAGE

INSTANCE_USAGE

相同，专门用于存储类计费项的查询。

字段	类型	说明
`account_id` account_id	BIGINT	账号 ID
`account_name` account_name	STRING	账号名称
`instance_id` instance_id	BIGINT	实例 ID
`region_name` region_name	STRING NOT NULL	实例所在区域
`sku_category` sku_category	STRING	计费类别
`sku_name` sku_name	VARCHAR(255)	计费项名称
`workspace_id` workspace_id	BIGINT	工作空间 ID
`workspace_name` workspace_name	STRING	工作空间名称
`measurement_start` measurement_start	STRING	计量周期开始时间
`measurement_end` measurement_end	STRING	计量周期结束时间
`measurements_unit` measurements_unit	VARCHAR(50)	计量单位
`measurements_consumption` measurements_consumption	DOUBLE	实际用量
`price_rate` price_rate	DECIMAL(13,7)	单价
`amount` amount	DOUBLE	费用金额（元）
`discount_rate` discount_rate	DOUBLE NOT NULL	折扣率
`total_after_discount` total_after_discount	DOUBLE	折后费用（元）

常见

sku_category

sku_category

包括

storage

storage

和

network

network

。常见

sku_name

sku_name

包括

托管存储容量

托管存储容量

、

多版本未删除存储

多版本未删除存储

、

数据查询Internet数据传输

数据查询Internet数据传输

。

联系我们