JOBS_BY_FOLDER 视图

INFORMATION_SCHEMA.JOBS_BY_FOLDER 视图包含有关当前项目的父文件夹中提交的所有作业(包括其下子文件夹中的作业)的实时元数据。

所需权限

如需查询 INFORMATION_SCHEMA.JOBS_BY_FOLDER 视图,您需要拥有父文件夹的 bigquery.jobs.listAll Identity and Access Management (IAM) 权限。以下每个预定义的 IAM 角色均可提供所需的权限:

  • Folder Admin
  • BigQuery Resource Admin

如需详细了解 BigQuery 权限,请参阅使用 IAM 进行访问权限控制

架构

底层数据按 creation_time 列进行分区,并按 project_iduser_email 进行聚簇。

INFORMATION_SCHEMA.JOBS_BY_FOLDER 视图具有如下架构:

列名 数据类型
creation_time TIMESTAMP (分区列)此作业的创建时间。分区基于此时间戳的世界协调时间 (UTC)。
project_id STRING (聚簇列)项目的 ID。
project_number INTEGER 项目编号。
folder_numbers REPEATED INTEGER 项目祖先实体中文件夹(这些文件夹从距离项目最近的叶级文件夹开始依次排列)的 Google 帐号和 ID 管理 (GAIA) ID。此列仅在 JOBS_BY_FOLDER 中填充。
user_email STRING (聚簇列)运行作业的用户的电子邮件地址或服务帐号。
job_id STRING 作业的 ID。例如 bquxjob_1234
job_type STRING 作业的类型。可以是 QUERYLOADEXTRACTCOPYnull。作业类型 null 表示内部作业,例如脚本作业语句评估或具体化视图刷新。
statement_type STRING 查询语句(如果有效的话)的类型。例如 SELECTINSERTUPDATEDELETESCRIPT。如需查看有效值的列表,请参阅 QueryStatementType
priority STRING 此作业的优先级。 有效值包括 INTERACTIVEBATCH
start_time TIMESTAMP 此作业的开始时间。
end_time TIMESTAMP 此作业的结束时间。
query STRING SQL 查询文本。注意:只有 JOBS_BY_PROJECT 视图具有 query 列。
state STRING 作业的运行状态。有效状态包括 PENDINGRUNNINGDONE
reservation_id STRING 分配给此作业的主要预留的名称(如果适用的话)。如果作业在已分配给预留的项目中运行,其采用以下格式:RESERVATION_ADMIN_PROJECT:RESERVATION_LOCATION.RESERVATION_NAME

在此输出中:

  • RESERVATION_ADMIN_PROJECT:管理预留的 Google Cloud 项目的名称
  • RESERVATION_LOCATION:预留的位置
  • RESERVATION_NAME:预留的名称
total_bytes_processed INTEGER 作业处理的字节总数。
total_slot_ms INTEGER 整个作业持续时间内的的槽毫秒数。
error_result RECORD 错误的详细信息(如有),为 ErrorProto
cache_hit BOOLEAN 查询此作业的查询结果是否来自缓存。
destination_table RECORD 结果的目标(如有)。
referenced_tables RECORD 作业引用的数组。 仅针对查询作业进行填充。
labels RECORD 作为 keyvalue 字符串应用于作业的标签数组。
timeline RECORD 作业的查询时间轴。包含查询执行情况的快照。
job_stages RECORD 作业的查询阶段
total_bytes_billed INTEGER 如果项目配置为使用按需价格,则此字段包含作业的总计费字节数。如果项目配置为使用固定价格,则您无需为字节付费,并且此字段仅供参考。
parent_job_id STRING 父级作业的 ID(如有)。
transaction_id STRING 此作业在其中运行的事务的 ID(如果有)。(预览版
session_info RECORD 运行此作业的会话的详细信息(如果有)。(预览版
bi_engine_statistics RECORD 如果项目配置为使用 BI Engine SQL 接口,则此字段包含 BiEngineStatistics。否则为 NULL
total_modified_partitions INTEGER 作业修改的分区总数。系统会针对 LOADQUERY 作业填充此字段。

数据保留

此视图包含当前正在运行的作业和过去 180 天的作业历史记录。

范围和语法

针对此视图的查询必须包含区域限定符。如果您未指定区域限定符,则系统会从所有区域检索元数据。下表说明了此视图的区域范围:

视图名称 资源范围 区域范围
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.JOBS_BY_FOLDER 包含指定项目的文件夹 REGION
替换以下内容:

  • 可选:PROJECT_ID:您的 Cloud 项目的 ID。如果未指定,则系统会使用默认项目。
  • REGION:任何数据集区域名称。例如 region-us

当您查询 INFORMATION_SCHEMA.JOBS_BY_FOLDER 以查找查询作业的汇总费用时,请排除 SCRIPT 语句类型,否则某些值会被重复计算。SCRIPT 行包含在此作业中执行的所有子作业的汇总值。