数据库元数据视图
在本节中,我们将介绍各种数据库元数据视图,以便您更好地了解和查询您的数据。这些视图提供了有关数据库、表、列、视图、用户、角色和作业历史等详细信息。通过这些视图,您可以轻松地管理和监控您的数据。
SCHEMAS 视图
SCHEMAS 视图提供了有关数据库的详细信息,包括 WORKSPACE 名称、SCHEMA 名称、创建者、类型等。
字段详细信息
COLUMN NAME | DATA TYPE | 描述 |
---|---|---|
CATALOG_NAME | STRING | 当前 WORKSPACE 的名称 |
SCHEMA_NAME | STRING | 数据库的名字 |
SCHEMA_CREATOR | STRING | 数据库的所有者的帐号名字 |
TYPE | STRING | 枚举值:EXTERNAL(外部)、INTERNAL(内部) |
COMMENT | STRING | 创建数据库时的注释信息 |
CREATE_TIME | TIMESTAMP | 数据库创建时间 |
LAST_MODIFY_TIME | TIMESTAMP | 数据库修改时间 |
PROPERTIES | MAP | 创建时指定的 PROPERTIES,保留字段 |
TABLES 视图
TABLES 视图展示了当前 WORKSPACE 下的每个表的详细信息。
字段详细信息
COLUMN NAME | DATA TYPE | 描述 |
---|---|---|
TABLE_CATALOG | STRING | 当前 WORKSPACE 的名称 |
TABLE_SCHEMA | STRING | 当前 TABLE 所属的 SCHEMA |
TABLE_NAME | STRING | 表名字 |
TABLE_TYPE | STRING | 枚举值:EXTERNAL(外部表)、VIEW(视图)、MATERIALIZED VIEW(物化视图)、BASE TABLE(标准表)、SNAPSHOT(快照表) |
ROW_COUNT | BIGINT | 表中的条数(对于 VIEW 显示为 NULL,MATERIALIZED VIEW 显示对应条数) |
BYTES | BIGINT | 表的大小(对于 VIEW 显示为 NULL,MATERIALIZED VIEW 显示对应大小) |
CREATE_TIME | TIMESTAMP | 表创建时间 |
LAST_MODIFY_TIME | TIMESTAMP | 表修改时间 |
TABLE_CREATOR | STRING | 表的所有者的帐号名字 |
IS_PARTITIONED | BOOLEAN | 是否是分区表(对于 VIEW 显示为 NULL) |
IS_CLUSTERED | BOOLEAN | 是否是分桶表(对于 VIEW 显示为 NULL) |
COMMENT | STRING | 表注释信息 |
DATA_LIFECYCLE | BIGINT | 生命周期(单位为天) |
PROPERTIES | MAP | 创建时指定的 PROPERTIES,保留字段 |
COLUMNS 视图
COLUMNS 视图展示了表中每个字段的详细信息。
字段详细信息
COLUMN NAME | DATA TYPE | 描述 |
---|---|---|
TABLE_CATALOG | STRING | 当前 WORKSPACE 的名称 |
TABLE_SCHEMA | STRING | 当前 TABLE 所属的 SCHEMA |
TABLE_NAME | STRING | 表名字 |
COLUMN_NAME | STRING | 字段的名字 |
COLUMN_DEFAULT | STRING | 字段默认值 |
IS_NULLABLE | BOOLEAN | 是否可以为 NULL |
DATA_TYPE | STRING | 字段类型 |
CREATE_TIME | TIMESTAMP_LTZ | 表的创建时间 |
IS_CLUSTERING_COLUMN | BOOLEAN | 是否是 CLUSTER 字段 |
IS_PRIMARY_KEY | BOOLEAN | 是否是主键 |
COMMENT | STRING | 字段的注释信息 |
VIEWS 视图
VIEWS 视图展示了当前 WORKSPACE 下的所有视图及其详细信息。
字段详细信息
COLUMN NAME | DATA TYPE | DESCRIPTION |
---|---|---|
TABLE_CATALOG | STRING | 当前WORKSPACE的名称 |
TABLE_SCHEMA | STRING | 当前VIEW所属的SCHEMA |
TABLE_NAME | STRING | 视图名字 |
TABLE_CREATOR | STRING | 视图所有者的帐号名字 |
VIEW_DEFINITION | STRING | 创建视图的语句 |
CREATE_TIME | TIMESTAMP | 视图创建时间 |
LAST_MODIFY_TIME | TIMESTAMP | 视图修改时间 |
COMMENT | STRING | 视图的注释信息 |
USERS视图
每个用户显示一行,包含当前WORKSPACE的所有用户
COLUMN NAME | DATA TYPE | DESCRIPTION |
---|---|---|
WORKSPACE_NAME | STRING | 当前空间的名字 |
USER_NAME | STRING | 用户名称 |
ROLE_NAME | STRING | 当前用户拥有的角色,多个角色使用逗号分隔 |
CREATE_TIME | TIMESTAMP | 用户加入时间 |
STRING | 用户邮箱 | |
TELEPHONE | STRING | 用户电话 |
COMMENT | STRING | 描述用户信息 |
PROPERTIES | MAP | 创建时指定的PROPERTIES,保留字段 |
ROLES视图
COLUMN NAME | DATA TYPE | DESCRIPTION |
---|---|---|
WORKSPACE_NAME | STRING | 当前空间的名字 |
ROLE_NAME | STRING | 空间下的所有角色 |
USER_NAMES | STRING | 被授予该角色的用户名称,多个用户使用逗号分开 |
CREATE_TIME | TIMESTAMP | 视图创建时间 |
COMMENT | STRING | 描述角色信息 |
PROPERTIES | MAP | 创建时指定的PROPERTIES,保留字段 |
JOB_HISTORY视图
COLUMN NAME | DATA TYPE | DESCRIPTION |
---|---|---|
WORKSPACE_NAME | STRING | 运行JOB所在的空间 |
JOB_ID | STRING | 作业ID |
JOB_NAME | STRING | 作业名称 |
JOB_CREATOR | STRING | 运行作业的用户 |
STATUS | STRING | SCHEDULE, PROCESS, SUCCEEDED, FAILED, CANCELLED |
CRU | DECIMAL | 任务消耗的计算资源 |
ERROR_MESSAGE | STRING | 如果运行出错会有此信息 |
JOB_TYPE | STRING | 作业类型 COPY SQL DATALAKE(文件操作命令) |
JOB_TEXT | STRING | 执行JOB的语句 |
QUERY_TAG | STRING | 用户设置的TAG,用于标识QUERY |
START_TIME | TIMESTAMP | JOB运行开始时间 |
END_TIME | TIMESTAMP | JOB运行结束时间 |
EXECUTION_TIME | DOUBLE | 执行时间,单位为秒,精确到毫秒 |
INPUT_BYTES | BIGINT | 实际扫描的数据量。 |
OUTPUT_BYTES | BIGINT | 输出字节数。 |
INPUT_OBJECTS | STRING | 输入的表名 |
OUTPUT_OBJECTS | STRING | 输出的表名 |
CLIENT_INFO | STRING | 客户端信息,来自于JDBC、客户端、WEB页面 |
VIRTUAL_CLUSTER | STRING | 使用的计算资源 |
ROW_PRODUCED | BIGINT | 处理的总记录数,输入的数据 |
ROW_INSERTED | BIGINT | 如果是插入行为应该有值 |
ROW_UPDATED | BIGINT | 如果是更新行为应该有值 |
ROW_DELETED | BIGINT | 如果是删除行为应该有值 |
JOB_CONFIG | STRING | 提交作业时设置的参数信息 |
CACHE_HIT | BIGINT | 从缓存中读取的数据 |
JOB_PRIORITY | STRING | 作业优先级 |
INPUT_TABLES | STRING | 输入的表名 |
OUTPUT_TABLES | STRING | 输出的表名 |
物化视图刷新历史
COLUMN_NAME | DATA_TYPE | DESCRIPTION |
---|---|---|
WORKSPACE_NAME | STIRNG | 项目空间名字 |
SCHEMA_NAME | STRING | SCHEMA名字 |
MATERIALIZED_VIEW_NAME | STRING | 物化视图名字 |
CRU | DECIMAL | 刷新物化视图使用的计费 |
VIRTUAL_CLUSTER_NAME | STRING | 物化视图名字,自动刷新会有此信息 |
STATUS | STRING | PENDING\RUNNING\FINISHED\FAILED |
SCHEDULED_START_TIME | TIMESTAMP_LTZ | 计划刷新时间 |
START_TIME | TIMESTAMP_LTZ | 物化视图开始时间 |
END_TIME | TIMESTAMP_LTZ | 物化视图结束时间 |
ERROR_CODE | STRING | |
ERROR_MESSAGE | STRING | 刷新失败的信息,如果失败则会在这里有 |
AUTOMV_REFRESH_HISTORY刷新视图
COLUMN_NAME | DATA_TYPE | DESCRIPTION |
---|---|---|
WORKSPACE_NAME | STIRNG | 项目空间名字SYS |
SCHEMA_NAME | STRING | SCHEMA名字,AUTOMV所在的SCHEMA |
MATERIALIZED_VIEW_NAME | STRING | 物化视图名字 |
CRU | DECIMAL | 刷新物化视图使用的计费 |
STATUS | STRING | PROCESS:正在刷新。 SUCCEEDED:刷新成功完成。 FAILED:执行期间刷新失败。 CANCELLED:刷新在执行前被取消。 |
MV_PROCESS_TYPE | STRING | BUILD:构建MV。REFRESH:刷新 |
START_TIME | TIMESTAMP_LTZ | 物化视图开始时间 |
END_TIME | TIMESTAMP_LTZ | 物化视图结束时间 |
BUILD_FROM_WORKSPACE | STRING | 构建MV对应的源表空间 |
JOB_ID | SRING | 构建MV的作业ID |
ERROR_MESSAGE | STRING | 刷新失败的信息,如果失败则会在这里有 |
VOLUMES视图
column_name | data_type | description |
---|---|---|
VOLUME_CATALOG | STRING | 所属 Workspace 名称 |
VOLUME_SCHEMA | STRING | 所属 Schema 名称 |
VOLUME_NAME | STRING | Volume 名称 |
VOLUME_URL | STRING | Volume 绑定的URL |
VOLUME_REGION | STRING | Volume 所属区域 |
VOLUME_TYPE | STRING | Volume 类型(internal指创建volumn时不用指定第三方云厂商地址,或者 external) |
VOLUME_CREATOR | STRING | Volume 的 owner |
CONNECTION_NAME | STRING | 引用的connection名称 |
COMMENT | STRING | 注释 |
PROPERTIES | map<string,string> | |
CREATE_TIME | TIMESTAMP | 创建时间 |
LAST_MODIFY_TIME | TIMESTAMP | 修改时间 |
CONNECTIONS视图
column_name | data type | description |
---|---|---|
WORKSPACE_NAME | STRING | 对象所在的空间 |
CONNECTION_NAME | STRING | 连接对象名称 |
CONNECTION_KIND | STRING | 枚举值支持的connection种类,STORAGE CONNECTION、 API CONNECTION |
TYPE | STRING | 指定连接数据源的类型 storage connection支持 FILE_SYSTEM api connection支持 CLOUD_FUNCTION |
PROVIDER | STRING | TYPE 为 FILE_SYSTEM 时为 OSS / COS TYPE 为 CLOUD_FUNCTION 时为 aliyun / tencent |
REGION | STRING | connection 连接的region,比如 ap-shanghai / cn-beijing |
SOURCE_CREATOR | STRING | 创建者 |
CREATE_TIME | TIMESTAMP | 创建时间 |
LAST_MODIFY_TIME | TIMESTAMP | 上次修改时间 |
COMMENT | STRING | 注释信息 |
PROPERTIES | map<string,string> |
联系我们