NATIVE_DIMENSION

As funções nativas ficam desativadas por padrão. Consulte a seção Como ativar funções nativas neste artigo para saber como ativar funções nativas.

Com a função NATIVE_DIMENSION, é possível escrever SQL diretamente em um campo do Looker Studio. Isso é útil para funções que não estão incluídas na lista de funções, mas que são aceitas pelo seu banco de dados.

Como ativar funções nativas

As funções nativas ficam desativadas por padrão e são gerenciadas no nível da fonte de dados.

Se você é proprietário de uma fonte de dados do Google BigQuery, siga estas etapas para ativar as funções nativas:

  1. No Looker Studio, edite a fonte de dados.
  2. No canto superior direito do editor da fonte de dados, clique em Funções nativas.
  3. Na caixa de diálogo Funções nativas, selecione Ativado.
  4. Clique em Salvar.

Se você desativar as funções nativas, nenhum usuário poderá criar campos com elas. Além disso, os gráficos que fazem referência a campos com funções nativas vão mostrar um erro.

Exemplo de uso

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. Pode ser qualquer SQL válido do Google BigQuery que entraria em uma única coluna de uma instrução SELECT. A expressão não pode incluir agregações.

type: um literal de tipo de dados. Consulte a seção a seguir para conhecer os tipos compatíveis com essa função.

Tipos NATIVE_DIMENSION

Você pode escolher entre os seguintes tipos:

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

A1B2C3

BOOL

Um valor lógico.

true

false

DOUBLE Um número de ponto 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 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 as funções POINT e POLYGON do BigQuery são aceitas.

POINT(32 210)

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

Se a expressão retornar um tipo de dados de carimbo de data/hora, como TIMESTAMP do BigQuery, use a função CAST para fazer a conversão para um tipo DATETIME. Exemplo:

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

Exemplos de NATIVE_DIMENSION

Funções JSON no SQL

Suponha que seus dados tenham um campo users_ages_json com valores formatados como payloads do JSON. Um valor de linha desse campo pode ser semelhante ao seguinte exemplo:

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

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

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

Para o valor da linha desse exemplo, a função NATIVE_DIMENSION retornaria a idade 26 como um número inteiro.

Limites de NATIVE_DIMENSION

Quem pode usar funções nativas

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

Os leitores da fonte de dados podem usar campos com funções nativas nos gráficos. Mas eles não podem criar novos campos usando funções nativas, nem podem editar nenhum campo usando funções nativas.

Campos agregados

Não é possível incluir campos agregados no parâmetro expression.

Funções de janela

Não é possível incluir funções de janela no parâmetro expression.

Combinações

Não é possível criar um campo com a função NATIVE_DIMENSION em uma fonte de dados combinada.

No entanto, é possível criar um campo com essa função antes da combinação e usar esse campo em uma combinação.

Tipos de dados TIMESTAMP

Se a expressão retornar um tipo de dados de carimbo de data/hora, como TIMESTAMP do BigQuery, use a função CAST para fazer a conversão para um tipo DATETIME. Exemplo:

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