As funções nativas ficam desativadas por padrão. Para ter acesso a elas, consulte a seção Como ativar funções nativas.
Com a função NATIVE_DIMENSION
, é possível escrever SQL direto 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
- Exemplo de uso
- Sintaxe
- Exemplos de NATIVE_DIMENSION
- Limites de NATIVE_DIMENSION
- Recursos relacionados
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.
A função NATIVE_DIMENSION
só pode ser usada com uma fonte de dados do Google BigQuery em que a integração nativa do BigQuery no Looker Studio esteja ativada.
Seguindo estas etapas, você pode ativar as funções nativas de fontes de dados do Google BigQuery que sejam suas:
- Ative a integração nativa do BigQuery no Looker Studio.
- No Looker Studio, edite a fonte de dados.
- No canto superior direito do editor da fonte de dados, clique em Funções nativas.
- Na caixa de diálogo Funções nativas, selecione Ativado.
- 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
Sintaxe
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.
NATIVE_DIMENSION tipos
Você pode escolher entre os seguintes tipos:
Tipo | Dados esperados | Exemplos de relatório |
---|---|---|
|
Zero ou mais números, letras, caracteres ou símbolos. |
|
BOOL |
Um valor lógico. |
|
DOUBLE |
Um número de ponto flutuante. | 1,234.56 |
INT64 |
Um número inteiro. | 1,234 |
DATE |
Uma data do calendário. |
|
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 |
|
O Looker Studio vai apresentar um erro se a expressão retornar um tipo de dados não compatível, como ARRAY, STRUCT ou JSON.
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 trazer 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
Origens de dados com suporte
A função NATIVE_DIMENSION
só pode ser usada com uma fonte de dados do Google BigQuery em que a integração nativa do BigQuery no Looker Studio esteja ativada.
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.
Dados do tipo 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. Por exemplo:
NATIVE_DIMENSION("CAST({expression} AS DATETIME)", "DATETIME")