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_id 和 user_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	作业的类型。可以是 QUERY、LOAD、EXTRACT、COPY 或 null。作业类型 null 表示内部作业，例如脚本作业语句评估或具体化视图刷新。
statement_type	STRING	查询语句（如果有效的话）的类型。例如 SELECT、INSERT、UPDATE、DELETE 或 SCRIPT。如需查看有效值的列表，请参阅 QueryStatementType。
priority	STRING	此作业的优先级。 有效值包括 INTERACTIVE 和 BATCH。
start_time	TIMESTAMP	此作业的开始时间。
end_time	TIMESTAMP	此作业的结束时间。
query	STRING	SQL 查询文本。注意：只有 JOBS_BY_PROJECT 视图具有 query 列。
state	STRING	作业的运行状态。有效状态包括 PENDING、RUNNING、DONE。
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	作为 key 和 value 字符串应用于作业的标签数组。
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	作业修改的分区总数。系统会针对 LOAD 和 QUERY 作业填充此字段。

数据保留

此视图包含当前正在运行的作业和过去 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 行包含在此作业中执行的所有子作业的汇总值。