fn_registry/python/functions/bigquery/bq_copy_table.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_copy_table	function	py	infra	1.0.0	impure	def bq_copy_table(client: BQClient, source_dataset: str, source_table: str, dest_dataset: str, dest_table: str, write_disposition: str = 'WRITE_EMPTY') -> dict	Copia una tabla BigQuery a otro dataset o tabla dentro del mismo proyecto usando copy_table del SDK. Espera la finalizacion del CopyJob.	bigquery gcp copy table google-cloud python pendiente-usar				false	error_go_core	google-cloud-bigquery	name desc client cliente BQClient autenticado contra el proyecto GCP name desc source_dataset ID del dataset de origen en BigQuery name desc source_table ID de la tabla de origen en BigQuery name desc dest_dataset ID del dataset de destino en BigQuery (puede ser el mismo que el origen) name desc dest_table ID de la tabla de destino; si no existe, BigQuery la crea automaticamente name desc write_disposition comportamiento si la tabla destino ya existe: WRITE_EMPTY falla, WRITE_APPEND agrega, WRITE_TRUNCATE sobreescribe	dict con {job_id: ID del CopyJob, status: DONE o FAILED}	false			python/functions/bigquery/queries.py

Ejemplo

from bigquery.client import bq_auth
from bigquery.queries import bq_copy_table

client = bq_auth("my-project")

# Copia de produccion a staging (falla si ya existe)
result = bq_copy_table(
    client,
    "production", "users",
    "staging",   "users_backup",
)
print(f"Copia completada: {result['status']} — job: {result['job_id']}")

# Copia sobreescribiendo destino
result = bq_copy_table(
    client,
    "raw", "events_2024",
    "processed", "events_latest",
    write_disposition="WRITE_TRUNCATE",
)

Notas

copy_table solo funciona dentro del mismo proyecto GCP. Para copiar entre proyectos, usar bq_export_to_gcs + bq_load_from_gcs.

Si la tabla destino no existe, BigQuery la crea con el schema de la tabla origen independientemente del write_disposition.

El CopyJob es asincrono; job.result() bloquea hasta completar. La copia no mueve datos fisicamente — BigQuery usa referencias de bloques internamente hasta que se modifica la copia.