Use parâmetros numa consulta personalizada

Os parâmetros permitem-lhe criar relatórios mais reativos e personalizáveis. Pode transmitir parâmetros numa origem de dados de volta para a consulta subjacente. Para usar um parâmetro na sua consulta personalizada, siga as diretrizes de sintaxe relevantes documentadas no artigo Executar consultas parametrizadas

Parâmetros padrão

Pode usar os seguintes parâmetros em qualquer consulta personalizada:

Parâmetro

Finalidade

@DS_START_DATE

Obtém o início do intervalo de datas do relatório.

@DS_END_DATE

Obtém o fim do intervalo de datas do relatório.

@DS_USER_EMAIL

Obtém o endereço de email do utilizador com sessão iniciada.

Para usar estes parâmetros, siga estes passos:

  1. Abaixo do editor de consultas, ative os parâmetros que quer usar.

  2. Na consulta, certifique-se de que usa letras maiúsculas para os nomes dos parâmetros.

Todos os valores dos parâmetros são transmitidos como strings. Para os processar como datas, números ou outros tipos de dados, certifique-se de que usa uma função de conversão adequada, como PARSE_DATE, PARSE_TIMESTAMP ou CAST.

Use parâmetros de data para transmitir intervalos de datas à consulta subjacente

Se o relatório incluir um controlo de intervalo de datas, os visitantes podem usá-lo para pedir datas de início e fim diferentes dos dados.

Use o parâmetro de email para fornecer acesso ao nível da linha aos dados

O parâmetro de email permite-lhe mostrar apenas os dados associados ao utilizador com sessão iniciada de um relatório, uma origem de dados ou uma exploração. Esse utilizador tem de ter sessão iniciada numa Conta Google e tem de consentir em fornecer o respetivo endereço de email ao Looker Studio. Se o visitante não der o seu consentimento, todos os gráficos no relatório baseados nesta origem de dados apresentam um erro de autorização.

Parâmetros personalizados

Pode usar quaisquer parâmetros que criar na interface do utilizador do Looker Studio na sua consulta personalizada.

Crie um parâmetro na página de associação

  1. Abaixo do editor de consultas personalizadas, clique em +ADICIONAR PARÂMETRO.
  2. Configure as opções de parâmetros.
  3. Clique em OK.

Oculte parâmetros personalizados na origem de dados

Por predefinição, os parâmetros personalizados podem ser modificados nos relatórios. Para impedir que os editores de relatórios alterem o valor de um parâmetro, pode ocultar o parâmetro.

  1. À direita do parâmetro, clique em Mais opções .
  2. Clique em Ocultar.

Saiba como permitir parâmetros de origens de dados em relatórios.

Use um parâmetro numa consulta personalizada

No corpo da sua consulta personalizada, substitua um valor codificado por um identificador que comece com o caráter @. Por exemplo: @param_name.

Exemplos de parâmetros

Exemplo de parâmetro personalizado:

SELECT word FROM `TABLE` WHERE corpus = @corpus;

Use uma string com contains e um número:

SELECT * FROM `bigquery-public-data.baseball.games_post_wide`
WHERE REGEXP_CONTAINS(gameId, @s)
AND attendance > @attendance LIMIT 100;

Use um parâmetro de string de seleção múltipla. Tenha em atenção a utilização de UNNEST para reduzir a lista de valores:

SELECT * from user.users as user WHERE display_name in UNNEST(@name);

Exemplo de parâmetro de data (a data está no formato padrão):

SELECT creation_date, age, display_name from user.users as user
WHERE creation_date > PARSE_DATE('%Y%m%d', @DS_START_DATE)
AND creation_date < PARSE_DATE('%Y%m%d', @DS_END_DATE);

Exemplo de parâmetro de data (a data é uma indicação de tempo Unix em microssegundos):

SELECT creation_date, age, display_name from user.users as use
WHERE creation_date > UNIX_MICROS(PARSE_TIMESTAMP('%Y%m%d', @DS_START_DATE)
AND creation_date < UNIX_MICROS(PARSE_TIMESTAMP('%Y%m%d', @DS_END_DATE)

Exemplo de parâmetro de email:

SELECT * FROM Sales WHERE sales-rep-email = @DS_USER_EMAIL;