Referencia de procedimientos del sistema

BigQuery es compatible con los siguientes procedimientos del sistema, que se pueden usar de manera similar a los procedimientos almacenados creados por el usuario.

BQ.ABORT_SESSION

Sintaxis

CALL BQ.ABORT_SESSION([session_id]);

Descripción

Finaliza tu sesión actual.

De manera opcional, puedes especificar el ID de sesión, que te permite finalizar una sesión si no se llama al procedimiento del sistema desde esa sesión.

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

BQ.JOBS.CANCEL

Sintaxis

CALL BQ.JOBS.CANCEL(job);

Descripción

Cancela un trabajo en ejecución.

Especifica el trabajo como una string con el formato '[project_id.]job_id'. Si ejecutas este procedimiento del sistema desde un proyecto diferente al del trabajo, 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 Cancela 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 una tabla de objetos. Este procedimiento falla si lo ejecutas en una tabla que tiene el modo de almacenamiento en caché de metadatos configurado 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.

Para las tablas de BigLake, puedes especificar de forma opcional uno o más subdirectorios del directorio de datos de la tabla en Cloud Storage en el formato 'gs://table_data_directory/subdirectory/.../'. Esto te permite actualizar solo los metadatos de la tabla de esos subdirectorios y, por lo tanto, evitar el procesamiento innecesario de metadatos.

Ejemplos

Para actualizar todos los metadatos de una tabla, haz lo siguiente:

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

Para actualizar los metadatos de una tabla de BigLake de forma selectiva, 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

La actualización de la caché de metadatos no es compatible con las tablas a las que hacen referencia los conjuntos de datos vinculados en conjuntos de datos externos.

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 string con el formato '[project_id.]dataset.table'. Si ejecutas este procedimiento del sistema desde un proyecto diferente al de la vista materializada, debes incluir el ID del proyecto.

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