NATIVE_DIMENSION

Devolve o resultado de uma expressão SQL do BigQuery conforme avaliado pelo conjunto de dados subjacente.

A função NATIVE_DIMENSION permite-lhe escrever SQL diretamente num campo do Looker Studio. Isto é útil para funções que não estão incluídas na lista de funções, mas que a sua base de dados suporta.

Ativar funções nativas

As funções nativas estão desativadas por predefinição e são geridas ao nível da origem de dados.

Se for proprietário de uma origem de dados do BigQuery, pode ativar as funções nativas para a origem de dados seguindo estes passos:

  1. No Looker Studio, edite a origem de dados.
  2. Na parte superior direita do editor de origens de dados, clique em Funções nativas.
  3. Na caixa de diálogo Funções nativas, selecione Ativadas.
  4. Clique em Guardar.

Se desativar as funções nativas, nenhum utilizador pode criar campos com funções nativas. Além disso, todos os gráficos existentes que façam referência a campos com funções nativas vão apresentar um erro.

Exemplos de utilização

NATIVE_DIMENSION("JSON_VALUE('{"name": "Dana"}','$.name')","STRING")

Sintaxe

NATIVE_DIMENSION( expression, type )

Parâmetros

expression: uma expressão a ser avaliada pelo conjunto de dados subjacente. Pode ser qualquer SQL do BigQuery válido que se encontre numa única coluna de uma declaração SELECT. A expressão não pode incluir agregações.

type: um literal de tipo de dados. Consulte a secção seguinte para ver os tipos que esta função suporta.

NATIVE_DIMENSION tipos

Pode selecionar a partir dos seguintes tipos:

Tipo Dados esperados Exemplos de relatórios
STRING Zero ou mais letras, números, carateres ou símbolos.

A1B2C3

BOOL

Um valor lógico.

true

false

DOUBLE Um número de vírgula flutuante. 1,234.56
INT64 Um número inteiro. 1,234
DATE Uma data do calendário.

2020-09-21

DATETIME Uma data do calendário com a hora. 2020-09-21 12:35 PM
GEOGRAPHY

Uma coleção de pontos e polígonos que correspondem ao tipo de dados geográficos do BigQuery .

Apenas são suportadas as funções do BigQuery POINT e POLYGON .

POINT(32 210)

POLYGON((0 0, 2 2, 2 0, 0 0), (2 2, 3 4, 2 4, 2 2))

Se a sua expressão devolver um tipo de dados de data/hora, como o tipo TIMESTAMP do BigQuery, use a função CAST para o converter num tipo DATETIME. Por exemplo:

NATIVE_DIMENSION("CAST({ expression } AS DATETIME)", "DATETIME")

Exemplos de NATIVE_DIMENSION

Funções JSON em SQL

Suponha que os seus dados incluem um campo users_ages_json cujos valores estão formatados como payloads JSON. Um valor de linha de exemplo deste campo pode ter o seguinte aspeto:

{"name": "Jakob", "age": "26"}

Use a função NATIVE_DIMENSION para obter a idade de users_ages_json, usando a função JSON_VALUE do BigQuery:

NATIVE_DIMENSION("JSON_VALUE(user_ages_json, '$.age')","INT64")

Para este valor de linha de exemplo, a função NATIVE_DIMENSION devolveria a idade 26 como um número inteiro.

Limites da função NATIVE_DIMENSION

Quem pode usar funções nativas

Se as funções nativas estiverem ativadas, os proprietários e os editores da origem de dados podem criar campos com funções nativas na origem de dados.

Os visualizadores da origem de dados podem usar campos com funções nativas em gráficos. No entanto, os visualizadores não podem criar novos campos com funções nativas nem editar campos com funções nativas.

Campos agregados

Não pode incluir campos agregados no parâmetro expression.

Funções de janela

Não pode incluir nenhuma função de janela no parâmetro expression.

Misturas

Não pode criar um campo com a função NATIVE_DIMENSION numa origem de dados combinada.

No entanto, pode criar um campo com esta função antes de combinar e, em seguida, usar esse campo numa combinação.

Tipos de dados TIMESTAMP

Se a sua expressão devolver um tipo de dados de data/hora, como o tipo TIMESTAMP do BigQuery, use a função CAST para o converter num tipo DATETIME. Por exemplo:

NATIVE_DIMENSION("CAST({expression} AS DATETIME)", "DATETIME")