fn_registry/python/functions/bigquery/bq_get_job.md

name, kind, lang, domain, version, purity, signature, description, tags, uses_functions, uses_types, returns, returns_optional, error_type, imports, params, output, tested, tests, test_file_path, file_path

name	kind	lang	domain	version	purity	signature	description	tags	uses_functions	uses_types	returns	returns_optional	error_type	imports	params	output	tested	tests	test_file_path	file_path
bq_get_job	function	py	infra	1.0.0	impure	def bq_get_job(client: BQClient, job_id: str) -> dict	Obtiene detalles completos de un job por su ID incluyendo estado, bytes procesados y errores. Incluye campos adicionales respecto a bq_list_jobs: destination_table, query y lista de errores.	bigquery gcp job get google-cloud python				false	error_go_core	google-cloud-bigquery	name desc client cliente autenticado de BigQuery obtenido con bq_auth name desc job_id ID del job a consultar (formato: 'proyecto:region.job_id' o solo 'job_id')	dict con campos: job_id, job_type, state, created, started, ended, user_email, bytes_processed, error, y opcionalmente destination_table, query, errors	false			python/functions/bigquery/jobs.py

Ejemplo

from bigquery.client import bq_auth
from bigquery.jobs import bq_get_job

client = bq_auth("my-project")

job = bq_get_job(client, "job_abc123")
print(job["state"], job["bytes_processed"])

# Inspeccionar query SQL del job
if job.get("query"):
    print("SQL:", job["query"][:200])

# Ver errores detallados
if job["error"]:
    print("Error principal:", job["error"])
    for err in job.get("errors", []):
        print(" -", err)

Notas

Lanza google.api_core.exceptions.NotFound si el job_id no existe en el proyecto.

A diferencia de bq_list_jobs, este metodo retorna campos adicionales cuando estan disponibles:

• destination_table: tabla destino (solo en query/load jobs con destino explicito)
• query: texto SQL del job (solo en query jobs)
• errors: lista completa de errores (cada uno como dict con reason, message, location)

Los campos created, started y ended se serializan como strings ISO 8601.