Referencia de variables de sistema

BigQuery admite las siguientes variables de sistema para consultas de varias declaraciones o dentro de sesiones. Puedes usar variables de sistema para configurar o recuperar información durante la ejecución de la consulta, de manera similar a las variables de lenguaje de procedimiento definidas por el usuario.

Nombre	Tipo	Lectura y escritura o solo lectura	Descripción
@@current_job_id	STRING	Solo lectura	ID de tarea del trabajo que se está ejecutando actualmente. En el contexto de una consulta de varias instrucciones, esto muestra el trabajo responsable de la instrucción actual, no toda la consulta de varias instrucciones.
@@dataset_id	STRING	Escritura y lectura	ID del conjunto de datos predeterminado en el proyecto actual. Este ID se usa cuando no se especifica un conjunto de datos para un proyecto en la consulta. Puedes usar la declaración SET para asignar @@dataset_id a otro ID de conjunto de datos en el proyecto actual. Las variables del sistema @@dataset_project_id y @@dataset_id se pueden configurar y usar juntas.
@@dataset_project_id	STRING	Escritura y lectura	ID del proyecto predeterminado que se usa cuando no se especifica uno para un conjunto de datos usado en la consulta. Si @@dataset_project_id no está configurado o si se configura como NULL, se usa el proyecto que ejecuta la consulta (@@project_id). Puedes usar la declaración SET para asignar @@dataset_project_id a otro ID de proyecto. Las variables del sistema @@dataset_project_id y @@dataset_id se pueden configurar y usar juntas.
@@last_job_id	STRING	Solo lectura	ID del trabajo más reciente que se ejecuta en la consulta actual de varias instrucciones, sin incluir el actual. Si la consulta de varias instrucciones contiene instrucciones CALL, este trabajo puede haberse originado en un procedimiento diferente.
@@location	STRING	Escritura y lectura	Es la ubicación en la que se ejecutará la consulta. @@location solo se puede establecer como un literal de cadena con una ubicación válida. Una instrucción SET @@location debe ser la primera instrucción en una consulta. Se produce un error si hay una discrepancia entre @@location y otro parámetro de configuración de ubicación para la búsqueda. Puedes mejorar la latencia de las consultas que establecen @@location con el modo opcional de creación de trabajos. Puedes usar la variable del sistema @@location dentro de las UDF de SQL y las funciones de tabla.
@@project_id	STRING	Solo lectura	ID del proyecto que se usó para ejecutar la consulta actual. En el contexto de un procedimiento, @@project_id se refiere al proyecto que ejecuta la consulta de varias instrucciones, no al proyecto que posee el procedimiento.
@@query_label	STRING	Escritura y lectura	Etiqueta de consulta que se asociará a los trabajos de consulta en la sesión o consulta actual de varias instrucciones. Si se configura en una consulta, todos los trabajos de consulta posteriores en la secuencia de comandos o la sesión tendrán esta etiqueta. Si no se establece en una consulta, el valor de esta variable de sistema es NULL. Para ver un ejemplo de cómo configurar esta variable de sistema, consulta Asocia trabajos en una sesión con una etiqueta.
@@reservation	STRING	Escritura y lectura	[Vista previa]. Especifica la reserva en la que se ejecuta el trabajo. Debe tener el siguiente formato: projects/project_id/locations/location/reservations/reservation_id. La ubicación de la reserva debe coincidir con la ubicación en la que se ejecuta la consulta.
@@row_count	INT64	Solo lectura	Si se usa en una consulta de varias instrucciones y la instrucción anterior es DML, especifica la cantidad de filas modificadas, insertadas o borradas como resultado de esa declaración DML. Si la instrucción anterior es MERGE, @@row_count representa la cantidad total combinada de filas insertadas, quitadas y borradas. Este valor es NULL si no está en una consulta de varias instrucciones.
@@script.bytes_billed	INT64	Solo lectura	Total de bytes facturados hasta el momento en el trabajo de consulta de varias declaraciones que se ejecuta en la actualidad. Este valor es NULL si no está en el trabajo.
@@script.bytes_processed	INT64	Solo lectura	Total de bytes procesados hasta el momento en el trabajo de consulta de varias instrucciones que se ejecuta en la actualidad. Este valor es NULL si no está en el trabajo.
@@script.creation_time	TIMESTAMP	Solo lectura	Hora de creación del trabajo de consulta de varias declaraciones que se ejecuta. Este valor es NULL si no está en el trabajo.
@@script.job_id	STRING	Solo lectura	ID de tarea del trabajo de consulta de varias instrucciones que se está ejecutando. Este valor es NULL si no está en el trabajo.
@@script.num_child_jobs	INT64	Solo lectura	Cantidad de trabajos secundarios completados en la actualidad. Este valor es NULL si no está en el trabajo.
@@script.slot_ms	INT64	Solo lectura	Cantidad de milisegundos de ranura que la secuencia de comandos utilizó hasta el momento. Este valor es NULL si no está en el trabajo.
@@session_id	INT64	Solo lectura	ID de la sesión con la que está asociada la consulta actual.
@@time_zone	STRING	Escritura y lectura	La zona horaria predeterminada que se debe usar en funciones de SQL que dependen de esta cuando no se especifica una zona horaria como argumento. @@time_zone se puede modificar mediante una declaración SET a cualquier nombre de zona horaria válido. Al inicio de cada secuencia de comandos, @@time_zone comienza como “UTC”.

Para la retrocompatibilidad, de forma predeterminada, se establecen las expresiones utilizadas en una cláusul OPTIONS o FOR SYSTEM TIME AS OF en la zona horaria America/Los_Angeles, mientras que todas las demás expresiones de fecha y hora se establecen de forma predeterminada en la zona horaria UTC. Si @@time_zone se configuró antes en la consulta de varias instrucciones, la zona horaria elegida se aplicará a todas las expresiones de fecha y hora, incluidas las cláusulas OPTIONS y FOR SYSTEM TIME AS OF.

Además de las variables del sistema que se mostraron anteriormente, puedes usar las variables del sistema EXCEPTION durante la ejecución de una consulta de varias instrucciones. Para obtener más información sobre las variables del sistema EXCEPTION, consulta la instrucción de lenguaje de procedimiento BEGIN...EXCEPTION.

Ejemplos

No creas variables del sistema, pero puedes anular el valor predeterminado para algunas de estas, como lo siguiente:

SET @@dataset_project_id = 'MyProject';

La siguiente consulta muestra la zona horaria predeterminada:

SELECT @@time_zone AS default_time_zone;

+-------------------+
| default_time_zone |
+-------------------+
| UTC               |
+-------------------+

Puedes usar variables de sistema con consultas DDL y DML. Por ejemplo, estas son algunas formas de usar la variable del sistema @@time_zone cuando creas y actualizas una tabla:

BEGIN
  CREATE TEMP TABLE MyTempTable
  AS SELECT @@time_zone AS default_time_zone;
END;

CREATE OR REPLACE TABLE MyDataset.MyTable(default_time_zone STRING)
  OPTIONS (description = @@time_zone);

UPDATE MyDataset.MyTable
SET default_time_zone = @@time_zone
WHERE TRUE;

Existen algunos lugares en los que las variables de sistema no se pueden usar en las consultas DDL y DML. Por ejemplo, no puedes usar una variable del sistema como nombre de proyecto, conjunto de datos o nombre de tabla. La siguiente consulta produce un error cuando incluyes la variable del sistema @@dataset_id en una ruta de tabla:

BEGIN
  CREATE TEMP TABLE @@dataset_id.MyTempTable (id STRING);
END;

Para ver más ejemplos de cómo puedes usar las variables del sistema en consultas de varias declaraciones, consulta Configura una variable.

Para ver ejemplos sobre cómo puedes usar las variables del sistema en las sesiones, consulta Sesión de ejemplo.