NATIVE_DIMENSION

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

Com a função NATIVE_DIMENSION, é possível escrever SQL direto em um campo do Data 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ê for proprietário de uma fonte de dados do BigQuery, siga estas etapas para ativar as funções nativas:

  1. No Data 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 usando essas funções. 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 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 conferir os tipos aceitos por essa função.

Tipos de NATIVE_DIMENSION

Você pode selecionar um dos seguintes tipos:

Tipo Dados esperados Exemplos de relatório
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 .

Somente 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 o tipo TIMESTAMP do BigQuery, use a função CAST para convertê-lo em um tipo DATETIME. Exemplo:

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

Exemplos de NATIVE_DIMENSION

Funções JSON em 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 recuperar 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 NATIVE_DIMENSION função 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 em gráficos. No entanto, eles não podem criar novos campos usando funções nativas nem editar campos 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 expression parâmetro.

Combinações

Não é possível criar um campo com a NATIVE_DIMENSION função 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.

Dados do tipo TIMESTAMP

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

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