Referência de variáveis do sistema

O BigQuery suporta as seguintes variáveis do sistema para consultas com várias declarações ou em sessões. Pode usar variáveis do sistema para definir ou obter informações durante a execução de consultas, de forma semelhante às variáveis de linguagem processual definidas pelo utilizador.

Para compatibilidade com versões anteriores, as expressões usadas numa cláusula OPTIONS ou FOR SYSTEM TIME AS OF usam por predefinição o fuso horário America/Los_Angeles, enquanto todas as outras expressões de data/hora usam por predefinição o fuso horário UTC. Se @@time_zone tiver sido definido anteriormente na consulta com várias declarações, o fuso horário escolhido aplica-se a todas as expressões de data/hora, incluindo as cláusulas OPTIONS e FOR SYSTEM TIME AS OF.

Além das variáveis do sistema apresentadas anteriormente, pode usar variáveis do sistema EXCEPTIONdurante a execução de uma consulta com várias declarações. Para mais informações acerca das EXCEPTIONvariáveis do sistema, consulte a declaração de linguagem processual BEGIN...EXCEPTION.

Exemplos

Não cria variáveis do sistema, mas pode substituir o valor predefinido de algumas delas:

SET @@dataset_project_id = 'MyProject';

A seguinte consulta devolve o fuso horário predefinido:

SELECT @@time_zone AS default_time_zone;

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

Pode usar variáveis do sistema com consultas LDD e LMD. Por exemplo, seguem-se algumas formas de usar a variável do sistema @@time_zone ao criar e atualizar uma tabela:

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;

Existem alguns locais onde não é possível usar variáveis do sistema em consultas DDL e DML. Por exemplo, não pode usar uma variável do sistema como nome de projeto, conjunto de dados ou nome de tabela. A seguinte consulta produz um erro quando inclui a variável do sistema @@dataset_id num caminho da tabela:

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

Para ver mais exemplos de como pode usar variáveis do sistema em consultas com várias declarações, consulte o artigo Defina uma variável.

Para ver exemplos de como pode usar variáveis do sistema em sessões, consulte o exemplo de sessão.