JOBS_BY_USER 视图

INFORMATION_SCHEMA.JOBS_BY_USER 视图包含有关当前用户在当前项目中提交的 BigQuery 作业的近乎实时元数据。

所需角色

如需获得查询 INFORMATION_SCHEMA.JOBS_BY_USER 视图所需的权限，请让您的管理员为您授予项目的 BigQuery User (roles/bigquery.user) IAM 角色。如需详细了解如何授予角色，请参阅管理对项目、文件夹和组织的访问权限。

此预定义角色可提供 bigquery.jobs.list 权限，查询 INFORMATION_SCHEMA.JOBS_BY_USER 视图需要该权限。

您也可以使用自定义角色或其他预定义角色来获取此权限。

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

架构

底层数据按 creation_time 列进行分区，并按 project_id 和 user_email 进行聚簇。

INFORMATION_SCHEMA.JOBS_BY_USER 视图具有如下架构：

列名 数据类型 值
bi_engine_statistics RECORD 如果项目配置为使用 BI Engine，则此字段包含 BiEngineStatistics。否则为 NULL。
cache_hit BOOLEAN 查询此作业的查询结果是否来自缓存。 如果您有多查询语句作业，则父查询的 cache_hit 为 NULL。
creation_time TIMESTAMP （分区列）此作业的创建时间。分区基于相应时间戳的世界协调时间 (UTC)。
destination_table RECORD 结果的目标表（如有）。
dml_statistics RECORD 如果作业是具有 DML 语句的查询，则值是包含以下字段的记录：
  • inserted_row_count：已插入的行数。
  • deleted_row_count：已删除的行数。
  • updated_row_count：已更新的行数。
对于所有其他作业，值为 NULL。
INFORMATION_SCHEMA.JOBS_BY_USER 和 INFORMATION_SCHEMA.JOBS_BY_PROJECT 视图中存在此列。
end_time TIMESTAMP 此作业的结束时间（从纪元开始计算，以毫秒为单位）。此字段表示作业进入 DONE 状态的时间。
error_result RECORD 作为 ErrorProto 对象的任何错误的详细信息。
job_creation_reason.code STRING 指定创建作业的大致原因。
可能的值包括：
  • REQUESTED：已请求创建作业。
  • LONG_RUNNING：查询请求运行超出 QueryRequest 中的 timeoutMs 字段指定的系统定义超时时间。因此，查询被视为为其创建作业的长时间运行的操作。
  • LARGE_RESULTS：查询结果无法放入内嵌响应。
  • OTHER：系统已确定查询需要作为作业执行。
job_id STRING 作业的 ID（如果已创建作业）。否则，该值是使用可选作业创建模式的查询的 ID。例如 bquxjob_1234。
job_stages RECORD 作业的查询阶段。

注意：对于从具有行级访问权限政策的表中读取的查询，此列的值为空。如需了解详情，请参阅 BigQuery 中行级安全性的最佳实践。
job_type STRING 作业的类型。可以是 QUERY、LOAD、EXTRACT、COPY 或 NULL。NULL 值表示后台作业。
labels RECORD 作为键值对应用于作业的标签数组。
parent_job_id STRING 父级作业的 ID（如有）。
priority STRING 此作业的优先级。 有效值包括 INTERACTIVE 和 BATCH。
project_id STRING （聚簇列）项目的 ID。
project_number INTEGER 项目编号。
query STRING SQL 查询文本。只有 JOBS_BY_PROJECT 视图具有查询列。
referenced_tables RECORD 作业引用的表数组。仅针对非缓存命中的查询作业进行填充。
reservation_id STRING 分配给此作业的主要预留的名称，格式为 RESERVATION_ADMIN_PROJECT:RESERVATION_LOCATION.RESERVATION_NAME。
在此输出中：
  • RESERVATION_ADMIN_PROJECT：管理预留的 Google Cloud 项目的名称
  • RESERVATION_LOCATION：预留的位置
  • RESERVATION_NAME：预留的名称
edition STRING 与分配给此作业的预留关联的版本。如需详细了解版本，请参阅 BigQuery 版本简介。
session_info RECORD 此作业在其中运行的会话的详细信息（如果有）。
start_time TIMESTAMP 此作业的开始时间（从纪元开始计算，以毫秒为单位）。此字段表示作业从 PENDING 状态转换为 RUNNING 或 DONE 的时间。
state STRING 作业的运行状态。有效状态包括 PENDING、RUNNING 和 DONE。
statement_type STRING 查询语句的类型。例如 DELETE、INSERT、SCRIPT、SELECT 或 UPDATE。如需查看有效值的列表，请参阅 QueryStatementType。
timeline RECORD 作业的查询时间轴。包含查询执行情况的快照。
total_bytes_billed INTEGER 如果项目配置为使用按需价格，则此字段包含作业的总计费字节数。如果项目配置为使用固定价格，则您无需为字节付费，并且此字段仅供参考。

注意：对于从具有行级访问权限政策的表中读取的查询，此列的值为空。如需了解详情，请参阅 BigQuery 中行级安全性的最佳实践。
total_bytes_processed INTEGER

作业处理的字节总数。

注意：对于从具有行级访问权限政策的表中读取的查询，此列的值为空。如需了解详情，请参阅 BigQuery 中行级安全性的最佳实践。
total_modified_partitions INTEGER 作业修改的分区总数。系统会针对 LOAD 和 QUERY 作业填充此字段。
total_slot_ms INTEGER 作业在其整个时间段内处于 RUNNING 状态（包括重试）的槽毫秒数。
total_services_sku_slot_ms INTEGER 在外部服务上运行并按服务 SKU 计费的作业的总槽毫秒数。此字段仅针对有外部服务费用的作业进行填充，并且是结算方式为 "SERVICES_SKU" 的费用的总用量。
transaction_id STRING 此作业在其中运行的事务的 ID（如果有）。（预览版）
user_email STRING （聚簇列）运行作业的用户的电子邮件地址或服务账号。
query_info.resource_warning STRING 查询处理期间的资源用量超出系统内部阈值时出现的警告消息。
成功的查询作业会填充 resource_warning 字段。借助 resource_warning，您可以获得更多数据点来优化查询，并使用 query_hashes 对等效的一组查询的性能趋势设置监控。
query_info.query_hashes.normalized_literals STRING 包含查询的哈希值。normalized_literals 是一个十六进制 STRING 哈希值，忽略注释、参数值、UDF 和字面量。如果底层视图发生更改，或者查询隐式引用列（例如 SELECT *）且表架构发生更改，则哈希值会不同。
系统会对非缓存命中的成功 GoogleSQL 查询显示此字段。
query_info.performance_insights RECORD 作业的性能数据分析。
query_info.optimization_details STRUCT 作业的基于历史记录的优化。 只有 JOBS_BY_PROJECT 视图具有此列。
transferred_bytes INTEGER 跨云查询（例如 BigQuery Omni 跨云转移作业）转移的总字节数。
materialized_view_statistics RECORD 查询作业中考虑的具体化视图的统计信息。（预览版）
metadata_cache_statistics RECORD 查询作业中引用的表的元数据列索引使用情况统计信息。
search_statistics RECORD 搜索查询的统计信息。
query_dialect STRING 此字段将于 2025 年 5 月某个时间提供。用于作业的查询方言。有效值包括：
  • GOOGLE_SQL：请求作业使用 GoogleSQL。
  • LEGACY_SQL：请求作业使用 LegacySQL。
  • DEFAULT_LEGACY_SQL：作业请求中未指定查询方言。BigQuery 使用了 LegacySQL 的默认值。
  • DEFAULT_GOOGLE_SQL：作业请求中未指定查询方言。BigQuery 使用了 GoogleSQL 的默认值。

此字段仅针对查询作业进行填充。查询方言的默认选择可以通过配置设置进行控制。
continuous BOOLEAN 作业是否为持续查询。
continuous_query_info.output_watermark TIMESTAMP 表示持续查询已成功处理数据的进度。
vector_search_statistics RECORD 向量搜索查询的统计信息。

数据保留

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

范围和语法

针对此视图的查询必须包含区域限定符。下表说明了此视图的区域范围：

视图名称 资源范围 区域范围
[PROJECT_ID.]`region-REGION`.INFORMATION_SCHEMA.JOBS_BY_USER 当前用户在指定项目中提交的作业。 REGION
请替换以下内容：
  • 可选：PROJECT_ID：您的 Google Cloud 项目的 ID。如果未指定，则使用默认项目。
  • REGION：任何数据集区域名称。 例如 `region-us`。