Referencia de procedimientos del sistema

BigQuery admite los siguientes procedimientos del sistema, que se pueden usar de forma similar a los procedimientos almacenados creados por los usuarios.

BQ.ABORT_SESSION

Sintaxis

CALL BQ.ABORT_SESSION([session_id]);

Descripción

Finaliza tu sesión actual.

También puede especificar el ID de sesión, que le permite finalizar una sesión si el procedimiento del sistema no se llama desde esa sesión.

Para obtener más información, consulta Finalizar sesiones.

BQ.JOBS.CANCEL

Sintaxis

CALL BQ.JOBS.CANCEL(job);

Descripción

Cancela una tarea en ejecución.

Especifica el trabajo como una cadena con el formato '[project_id.]job_id'. Si ejecutas este procedimiento del sistema desde un proyecto diferente al de la tarea, debes incluir el ID del proyecto. Debes ejecutar el procedimiento en la misma ubicación que el trabajo.

Para obtener más información, consulta Cancelar un trabajo.

BQ.REFRESH_EXTERNAL_METADATA_CACHE

Sintaxis

CALL BQ.REFRESH_EXTERNAL_METADATA_CACHE(table_name [, [subdirectory_uri, …]]);

Descripción

Actualiza la caché de metadatos de una tabla de BigLake o de una tabla de objetos. Este procedimiento falla si lo ejecutas en una tabla que tiene el modo de almacenamiento en caché de metadatos definido como AUTOMATIC.

Para ejecutar este procedimiento del sistema, necesitas los permisos bigquery.tables.update y bigquery.tables.updateData.

Especifica el nombre de la tabla como una cadena con el formato '[project_id.]dataset.table'. Si ejecutas este procedimiento del sistema desde un proyecto diferente al de la tabla, debes incluir el ID del proyecto.

En el caso de las tablas de BigLake, puedes especificar de forma opcional una o varias subcarpetas del directorio de datos de la tabla en Cloud Storage con el formato 'gs://table_data_directory/subdirectory/.../'. De esta forma, solo se actualizan los metadatos de la tabla de esos subdirectorios y se evita el procesamiento innecesario de metadatos.

Ejemplos

Para actualizar todos los metadatos de una tabla, sigue estos pasos:

CALL BQ.REFRESH_EXTERNAL_METADATA_CACHE('myproject.test_db.test_table')

Para actualizar de forma selectiva los metadatos de una tabla de BigLake, sigue estos pasos:

CALL BQ.REFRESH_EXTERNAL_METADATA_CACHE('myproject.test_db.test_table', ['gs://source/uri/sub/path/d1/*', 'gs://source/uri/sub/path/d2/*'])

Limitación

• No se admite la actualización de la caché de metadatos de las tablas a las que hacen referencia los conjuntos de datos vinculados a través de conjuntos de datos externos.
• La actualización de la caché de metadatos no debe usarse en una transacción de varias instrucciones.

BQ.REFRESH_MATERIALIZED_VIEW

Sintaxis

CALL BQ.REFRESH_MATERIALIZED_VIEW(view_name);

Descripción

Actualiza una vista materializada.

Especifica el nombre de la vista materializada como una cadena con el formato '[project_id.]dataset.table'. Si ejecutas este procedimiento del sistema desde un proyecto distinto de la vista materializada, debes incluir el ID del proyecto.

Para obtener más información, consulta Actualización manual.