Como adicionar campos personalizados

Ao analisar dados no Looker, talvez você precise de campos que não estão definidos no seu modelo de dados, como calcular uma métrica em tempo real, categorizar valores em grupos personalizados ou filtrar uma agregação para um cenário específico. Em vez de esperar que um desenvolvedor do LookML atualize o modelo, você pode criar campos personalizados diretamente na Análise para adaptar sua análise.

Com os campos personalizados, é possível criar dimensões e medições ad hoc que geram SQL e são executadas diretamente no banco de dados, assim como os campos definidos no LookML.

Para criar e usar campos personalizados, você precisa ter a permissão create_custom_fields.

Dependendo das suas metas de análise, é possível criar vários tipos de campos personalizados:

Os campos personalizados são diferentes dos campos definidos pelo LookML e dos cálculos de tabela

Entender as diferenças entre campos personalizados, campos definidos pelo LookML e cálculos de tabela ajuda a escolher a abordagem certa para sua análise.

As diferenças entre os campos personalizados e os definidos pelo LookML incluem:

  • É possível criar campos personalizados em uma Análise sem escrever LookML ou precisar de permissões de desenvolvedor.
  • Os campos personalizados não são compatíveis com detalhamento.
  • Os campos personalizados permanecem na seção Campos personalizados do painel Configurar (ou seletor de campo nas Análises clássicas) apenas para usuários com permissão para criá-los.

As diferenças entre os campos personalizados e os cálculos de tabela incluem:

  • Os campos personalizados geram SQL que é executado no banco de dados, de forma semelhante aos campos definidos pelo LookML. Os cálculos de tabela são executados nos resultados da consulta depois que os dados são recuperados do banco de dados.
  • Os campos personalizados não dependem dos dados mostrados na tabela de dados, e você pode usá-los para filtrar ou dinamizar os resultados da consulta.

Como visualizar e usar campos personalizados

A capacidade de ver campos personalizados e como você pode interagir com eles será diferente dependendo de você ter permissão para criá-los ou não.

Como visualizar campos personalizados

Se você tiver a permissão create_custom_fields, poderá ver e editar qualquer campo que apareça na visualização Campos personalizados no painel Configurar (ou na seção Campos personalizados do seletor de campos nas Análises clássicas).

Se você não tiver a permissão create_custom_fields, a seção ou visualização Campos personalizados não será mostrada.

No entanto, se você incluir um campo personalizado em uma Análise, um Look ou um bloco de dashboard, todos os usuários com quem você compartilhar esse conteúdo poderão ver o campo personalizado, mesmo que não tenham permissão para criar campos personalizados. Se você estiver compartilhando esse conteúdo compartilhando o URL de uma Análise, o URL precisará incluir o parâmetro qid (como instance_name.looker.com/explore/ec/order_items?qid=lEPPueGN7cHkozOEZVDQbO). Os usuários que não têm permissão para criar campos personalizados verão apenas o título do campo, não a descrição. Por isso, é importante nomear os campos com precisão se você for usá-los em consultas compartilhadas com esses usuários.

Como usar campos personalizados

Se você tiver a permissão create_custom_fields, poderá editar e usar qualquer campo que apareça na visualização Campos personalizados no painel Configurar (ou na seção Campos personalizados do seletor de campos nas Análises clássicas). É possível interagir com eles quase exatamente como você faria com qualquer outra métrica ou dimensão, incluindo filtro de inclusão, adição a visualizações e (para dimensões personalizadas) uso para dinamizar resultados. Uma exceção é que não é possível usar campos personalizados para criar filtros de painel do criador de conteúdo.

Somente os usuários com permissão para criar campos personalizados podem adicioná-los a consultas em Análises, Looks ou blocos de painel. No entanto, se um usuário selecionar Analisar a partir daqui em um Look compartilhado ou em um bloco de painel que inclua um campo personalizado, ele poderá criar uma nova consulta usando esse campo, mesmo que não tenha a capacidade de criar campos personalizados.

Tipos de campos personalizados

É possível criar e personalizar vários tipos de campos personalizados, dependendo do tipo ou dos tipos de campo base do LookML. As tabelas a seguir descrevem os tipos de campos personalizados que podem ser criados com base no tipo de campo do LookML:

Tipos de campos personalizados para dimensões

É possível criar vários tipos de campos personalizados com base nas dimensões no seletor de campos de uma Análise, dependendo do tipo ou dos tipos de campo base do LookML. A tabela a seguir descreve os tipos de campos personalizados compatíveis com cada tipo de dimensão.

S = Funciona com o tipo de dados string

N = funciona com o tipo de dados number e medições numéricas

T = Funciona com o tipo de dados tier

ZC = funciona com o tipo de dados zipcode

YN = Funciona com o tipo de dados yesno

DI = Funciona com o tipo de dados distance

DU = Funciona com o tipo de dados duration

TS = Funciona com a maioria dos tipos de dados de carimbo de data/hora *

ID = funciona com a maioria dos tipos de dados de data inteira *

SD = Funciona com a maioria dos tipos de dados de data de string *

L = Funciona com o tipo de dados location

Cada tipo de campo personalizado que você pode criar com base em uma dimensão se enquadra em uma das seguintes categorias:

  • Agregado: os campos agregados são tipos de medições que realizam agregações, como soma e média. As medições agregadas só podem fazer referência a dimensões, não a outras medições.
  • Não agregados: os campos não agregados são dimensões que podem ser agrupadas por em uma consulta de Análise.
Nome do campo personalizado Categoria Descrição Compatibilidade de tipo de campo do LookML
Contagem distinta Agregar Cria uma medição count_distinct que calcula o número de valores distintos para uma dimensão selecionada. S N T ZC YN DI DU TS ID SD L
Soma Agregar Cria uma medição sum que soma os valores de uma dimensão selecionada. N DI DU ID
Média Agregar Cria uma métrica average que calcula a média dos valores de uma dimensão selecionada. N DI DU ID
Mín. Agregar Cria uma medição min que encontra o menor valor de uma dimensão selecionada. N DI DU ID
Máx. Agregar Cria uma medição max que encontra o maior valor de uma dimensão selecionada. N DI DU ID
Mediana Agregar Cria uma medida median que encontra o valor médio para os valores de uma dimensão selecionada. N DI DU ID
Lista de valores exclusivos Agregar Cria uma medição list que gera uma lista dos valores distintos de uma dimensão selecionada. S T ZC YN SD L
Agrupamento Não agregada Cria agrupamentos ou níveis que separam os valores de uma dimensão numérica selecionada em um conjunto personalizado de intervalos de números. N DI DU ID
Grupo Não agregada Cria um grupo que permite agrupar os resultados de uma dimensão selecionada em rótulos personalizados. S N T ZC YN DI DU TS ID SD L
*Observação sobre dados de data e hora: o Looker interpreta alguns períodos e tipos baseados em tempo como tipos de dados diferentes quando você cria campos personalizados, e isso pode afetar os tipos de campos personalizados disponíveis para esses períodos e campos baseados em tempo. Por exemplo, o Looker interpreta o período hour_of_day como um tipo de dados number e, portanto, tem opções de campo personalizado disponíveis para outros campos type: number. Para informações mais específicas, consulte a seção Como os campos personalizados interpretam os tipos de dados de data e hora nesta página.

Tipos de campos personalizados para medições

É possível criar apenas um tipo de campo personalizado, uma medida filtrada, com base nas medidas no seletor de campos de uma Análise, dependendo do tipo de medida base do LookML. A tabela a seguir descreve os campos do LookML em que é possível adicionar um filtro aos tipos de medição.

LI = funciona com o tipo de medida list

DT = funciona com o tipo de medida date

YN = funciona com o tipo de medida yesno

N = funciona com tipos de medida numérica *

Nome do campo personalizado Descrição Compatibilidade de tipo de campo do LookML
Filtrar medida Adiciona uma condição de filtro a uma métrica para limitar os valores incluídos na agregação dela. LI DT YN N
* Para informações mais específicas sobre os tipos de medições que o Looker interpreta como numéricas ao usar campos personalizados, consulte a seção Como os campos personalizados interpretam medições numéricas nesta página.

Como os campos personalizados interpretam os tipos de dados de data e hora

O Looker interpreta alguns períodos e tipos baseados em tempo como tipos de dados diferentes quando você cria campos personalizados, o que afeta o tipo de campos personalizados que podem ser criados para um determinado campo de data ou hora. Os campos personalizados categorizam os campos de data e hora das seguintes maneiras:

Essas categorias são compatíveis com diferentes tipos de campos personalizados, conforme indicado na tabela Tipos de campos personalizados para dimensões.

Tipos de dados de data e carimbo de data/hora

Os campos personalizados tratam os seguintes tipos de dados de tempo do LookML como tipos de dados de carimbo de data/hora:

Tipos de dados de data inteira

Os campos personalizados tratam os seguintes tipos de dados de data e hora do LookML como tipos de data inteiros:

Tipos de dados de data de string

Os campos personalizados tratam os seguintes tipos de dados de data e hora do LookML como tipos de dados de string:

Como os campos personalizados interpretam as medidas numéricas

Os campos personalizados tratam os seguintes tipos de medida como tipos numéricos:

Esses tipos de medição são compatíveis com o tipo de campo personalizado de medição filtrada, conforme indicado na tabela Tipos de campos personalizados para medições.

Criar uma medição personalizada com base em uma dimensão

Os métodos para criar uma medição personalizada com base em uma dimensão variam de acordo com o uso da interface padrão da Análise ou da interface clássica da Análise.

Criar uma medição personalizada na interface padrão da Análise

Nas Análises, os usuários com a permissão create_custom_fields podem criar uma medição personalizada de uma das seguintes maneiras:

  • Você pode usar o painel "Configurar":

    1. No painel Configurar, na guia Todos os campos ou Campos em uso, mantenha o ponteiro sobre a dimensão que você quer usar para criar a medição personalizada.
    2. Selecione o menu Mais da dimensão.
    3. Selecione uma função agregada (como Contagem distinta, Soma, Média, Mín. ou Máx.).

  • Use a tabela de dados no painel "Dados": na tabela de dados, selecione a coluna de dados da dimensão, o menu Mais e uma função de agregação.

  • Você pode usar o botão "+ Adicionar":

    1. Na seção Campos personalizados do painel Configurar, selecione + Adicionar e escolha Medição personalizada.
    2. Na caixa de diálogo Criar medição personalizada, selecione um campo para medir, escolha um tipo de medição e defina uma medição personalizada com filtros, formatos e descrições personalizados.

O terceiro método do botão + Adicionar permite personalizar o campo personalizado durante a criação, como renomear, adicionar uma descrição opcional ou selecionar um formato diferente do padrão.

A nova medição personalizada vai aparecer automaticamente na tabela de dados e na visualização Campos personalizados no painel Configurar. Como acontece com outros campos, é possível adicionar ou remover um campo personalizado de uma consulta selecionando o nome dele. Você também pode selecionar o botão Filtrar para usá-lo como um filtro em uma consulta.

Como criar uma medição personalizada em Análises clássicas

Nas Análises clássicas, é possível criar uma medição personalizada com base em uma dimensão de uma das seguintes maneiras:

O segundo método permite personalizar o campo personalizado durante a criação, como renomear, adicionar uma descrição opcional ou selecionar um formato diferente do padrão.

Usando o menu de três pontos Mais da dimensão

Em muitos casos, é possível usar esta técnica de atalho:

  1. Abra a visualização do seletor de campo que contém a dimensão que você quer medir.
  2. Selecione o menu Maisde três pontos da dimensão.
  3. Selecione Agregar para mostrar as opções de criação de uma medição personalizada. As funções sugeridas variam de acordo com o tipo de dimensão escolhida (como número, string ou data). Selecione uma função.

Expanda a seção Campos personalizados no seletor de campos para ver o novo campo.

Como acontece com outros campos, é possível adicionar ou remover um campo personalizado de uma consulta selecionando o nome dele. Você também pode passar o cursor sobre o campo para conferir outras opções disponíveis, incluindo selecionar o ícone Filtrar para usá-lo como filtro em uma consulta. Também é possível editar o campo, se necessário.

Como usar a seção Campos personalizados do seletor de campos

Para definir um formato ou um filtro para a medição personalizada que está sendo criada, comece com o botão Adicionar na seção Campos personalizados:

  1. Selecione Adicionar na seção Campos personalizados do seletor de campo.
  2. Selecione o tipo de campo que você quer criar. Este exemplo usa uma medição personalizada.
  3. Selecione um campo para medir no menu suspenso Campo para medir, selecione o tipo de medida nas opções do menu suspenso Tipo de medida e especifique um nome no campo Nome. O nome aparece no seletor de campos e na tabela de dados.
  4. Se quiser adicionar uma condição de filtro, selecione um campo no menu suspenso Nome do filtro na guia Filtros. É possível adicionar ou remover condições de filtro usando os botões de adição e subtração Adicionar e Remover do Valor do filtro.
    • Você também pode selecionar a seta ao lado de Filtro personalizado para criar uma expressão de filtro personalizado usando qualquer função e operador do Looker que possa ser usado em filtros personalizados. O editor de expressões do Looker vai sugerir nomes de campos e mostrar ajuda de sintaxe para as funções que você usar. Os campos que são usados em uma Análise e qualificados para uso com o tipo de campo que você está criando são marcados com um círculo preto. Consulte a seção Adicionar um filtro personalizado a uma medição personalizada nesta página para mais detalhes sobre como adicionar filtros a medições.
  5. Na guia Detalhes do campo, é possível especificar um formato na seção Formato e adicionar uma descrição opcional de até 255 caracteres na caixa Descrição para dar a outros usuários mais detalhes sobre o campo personalizado, incluindo o uso pretendido.
  6. Selecione Salvar.

O seletor de campo vai mostrar a nova medição personalizada na seção Campos personalizados.

Como acontece com outros campos, é possível selecionar o nome de um campo personalizado para mostrá-lo em uma consulta. Você também pode selecionar o botão Filtrar para usá-lo como um filtro em uma consulta.

Agrupamento personalizado

O tipo de campo personalizado Grupo permite criar grupos personalizados ad hoc para dimensões sem precisar usar funções lógicas em expressões do Looker ou desenvolver a lógica CASE WHEN em parâmetros sql ou campos type: case.

Isso é útil quando você quer atribuir rótulos ou nomes de categorias fixos a valores que correspondem a condições específicas, por exemplo, agrupando estados ou países específicos em regiões ou custos de pedido em categorias.

Para criar um grupo, siga estas etapas:

  1. Abra a visualização que contém a dimensão para a qual você quer criar grupos personalizados.

  2. É possível abrir o menu Agrupar por de várias maneiras:

    • Na interface padrão da Análise, selecione o menu Mais da dimensão no painel Configurar (ou o menu Mais da coluna de dados no painel Dados) e, em seguida, selecione Grupo.
    • Nas Análises clássicas, selecione o menu Mais com três pontos da dimensão no seletor de campo (ou o menu de engrenagem da dimensão na tabela de dados) e selecione Grupo.

    O menu "Agrupar por" para a dimensão "Estado".

  3. Especifique um rótulo para o primeiro grupo de valores no campo Nome do grupo. Este exemplo ilustra como criar um grupo de estados para a região do Noroeste do Pacífico dos Estados Unidos usando a dimensão Estado, que é refletida pelo Nome do grupo "Noroeste do Pacífico".

  4. Selecione o botão de condição atual na seção Valor do grupo, que por padrão é é qualquer valor, para personalizar as condições que você quer aplicar ao grupo.

  5. Selecione a condição e insira ou selecione um ou mais valores. Nesse caso, uma das condições aplicadas é Estado é Oregon. É possível adicionar ou remover condições usando os botões de mais e menos Adicionar e Remover. Para salvar, clique fora da condição de filtro ou use a tecla Esc.

    • Quando disponíveis, as sugestões de valor aparecem em uma lista suspensa, indicada por uma seta para baixo na caixa de entrada de valor, para que os usuários selecionem ou pesquisem. As sugestões estão mais disponíveis para campos de type: string.
    • O Looker aplica automaticamente condições SQL, como a lógica AND ou OR, quando várias condições são criadas, com base nos tipos de campo, condições e valores que você especifica.
    • Se você estiver editando um grupo personalizado, considere mudar o nome para refletir as condições atualizadas.

    Um usuário mantém o ponteiro sobre o botão "Adicionar" (sinal de adição) ao lado do valor do grupo, e a caixa de seleção "Agrupar valores restantes" é marcada.

  6. Para incluir mais grupos nessa dimensão, passe o cursor sobre o grupo atual e selecione o botão de adição Adicionar. Para remover grupos, selecione o botão de subtração Remover. Para editar um grupo, selecione a condição dele, que, neste caso, é Oregon, Idaho ou Washington. O Looker aplica automaticamente condições SQL, como a lógica AND ou OR, quando várias condições são criadas, com base nos tipos de campo, condições e valores que você especifica.

  7. Outra opção é marcar a caixa de seleção Agrupar valores restantes para criar uma categoria e agrupar todos os outros valores que não atendem a nenhuma condição de grupo. Neste exemplo, qualquer estado que não seja Oregon, Idaho ou Washington será agrupado em um rótulo chamado Outros. Outro é o nome padrão, mas você pode personalizá-lo no campo Nome do grupo, conforme necessário.

    • Se você estiver editando um grupo personalizado e quiser remover o agrupamento de todos os outros valores, desmarque a caixa de seleção Agrupar valores restantes para remover esse grupo.

    O texto "Grupos de estados" é inserido no campo "Nome do campo", e a descrição "Estados por região" é inserida no campo "Descrição".

  8. Especifique um nome no campo Nome do campo. O nome aparece no seletor de campos e na tabela de dados.

  9. Selecione + Adicionar descrição para abrir a caixa Descrição e adicione uma descrição opcional de até 255 caracteres para dar mais informações sobre o grupo personalizado aos outros usuários.

    • Se você estiver editando um grupo personalizado e houver uma descrição, a caixa Descrição vai aparecer automaticamente.

  10. Selecione Salvar e Executar para executar a Análise novamente.

O novo campo vai aparecer na tabela de dados e mostrar rótulos para todos os estados: "Noroeste do Pacífico" para Oregon, Washington e Idaho, e "Outros" para todos os demais estados.

Você pode usar o novo grupo para gerar novos insights sobre seus dados. Por exemplo, compare quantos pedidos foram feitos por usuários na região do noroeste do Pacífico com os de usuários que moram em outras regiões dos Estados Unidos.

O novo campo vai aparecer na seção Campos personalizados do seletor de campos.

Como acontece com outros campos, é possível adicionar ou remover um campo personalizado de uma consulta clicando no nome dele. Você também pode passar o cursor sobre o campo para conferir mais opções disponíveis, incluindo selecionar o ícone Filtrar para usá-lo como filtro em uma consulta. Também é possível editar o grupo personalizado conforme necessário.

Agrupamento personalizado

O tipo de campo personalizado Agrupamento permite criar agrupamentos ou níveis personalizados ad hoc para dimensões de tipo numérico e dimensões personalizadas sem precisar usar funções lógicas em expressões do Looker ou desenvolver campos LookML type: tier.

Isso é útil quando você quer agrupar valores rapidamente em intervalos de números inteiros para ajustar a granularidade dos dados.

Os campos personalizados de agrupamento aparecem no estilo de notação de nível classic.

Para criar uma lixeira, siga estas etapas:

  1. Abra a visualização que contém a dimensão para a qual você quer criar as categorias personalizadas.

  2. Você pode abrir o menu Lixeira de várias maneiras:

    • Na interface padrão da Análise, selecione o menu Mais da dimensão no painel Configurar (ou o menu Mais da coluna de dados no painel Dados) e selecione Agrupar.
    • Nas Análises clássicas, selecione o menu Mais representado por três pontos no seletor de campo (ou o menu de engrenagem da dimensão na tabela de dados) e selecione Agrupar.

  3. Outra opção é selecionar Receber informações do campo para saber mais sobre os valores da dimensão para a qual você está criando agrupamentos por classes personalizados, incluindo os valores mínimo e máximo e o intervalo de valores da dimensão. Com essas informações, fica mais fácil escolher como especificar os agrupamentos de valores.

  4. Selecione um tipo de agrupamento na seção Tipo de agrupamento.

    • Selecione Tamanho igual para agrupar valores numéricos em intervalos de números inteiros iguais. Por exemplo, níveis de valores que variam de 0 a 10, 10 a 20 e 20 a 30.
    • Selecione Tamanho personalizado para criar tamanhos de agrupamentos personalizados de intervalos de números inteiros variados. Por exemplo, níveis de valores que variam de 0 a 15, 15 a 75 e 75 a 100.

  5. Personalize os tamanhos e intervalos dos agrupamentos.

    • Se o Tipo de agrupamento selecionado for Tamanho igual, insira os valores nos campos Tamanho do agrupamento por classes, Valor mínimo e Valor máximo. O exemplo anterior mostra especificações de intervalos de 10, variando de 0 a 100. Os agrupamentos são criados automaticamente para valores nos dados que estão fora dos intervalos especificados.
    • Se o Tipo de agrupamento selecionado for Tamanho personalizado, organize os pontos de interrupção de nível em ordem crescente na caixa Pontos de interrupção do agrupamento por classes, separados por vírgulas ou novas linhas.

  6. Especifique um nome no campo Nome do campo. O nome aparece no seletor de campos e na tabela de dados.

  7. Selecione + Adicionar descrição para abrir a caixa Descrição e adicionar uma descrição opcional de até 255 caracteres para dar mais informações aos outros usuários sobre o agrupamento personalizado.

    • Se você estiver editando um agrupamento personalizado que já tem uma descrição, a caixa Descrição vai aparecer automaticamente.

  8. Selecione Salvar e Executar para executar a Análise novamente.

O novo campo vai aparecer na tabela de dados e mostrar os níveis de valores dependendo de onde eles se encaixam nas categorias especificadas.

Você pode usar o novo agrupamento para gerar novos insights sobre seus dados. Por exemplo, em um agrupamento personalizado com base em uma dimensão de Custo, é possível comparar o número de pedidos que contêm itens com preços em intervalos de custo específicos.

O novo campo vai aparecer na seção Campos personalizados do seletor de campos.

Como acontece com outros campos, é possível adicionar ou remover um campo personalizado de uma consulta clicando no nome dele. Você também pode passar o cursor sobre o campo para revelar mais opções disponíveis para ele. Por exemplo, é possível selecionar o ícone Filtro do campo para usá-lo como um filtro em uma consulta. Também é possível editar o intervalo personalizado conforme necessário.

adicionar um filtro a uma medição personalizada

Aplicar filtros às medições personalizadas permite que uma medição limite os dados, como incluir apenas pedidos de determinadas regiões. É possível adicionar um filtro personalizado a uma medição personalizada ao criar ou editar uma medição personalizada. Para adicionar um filtro a uma medição personalizada:

  1. Crie ou edite uma medição personalizada de uma das seguintes maneiras:
    • No painel Configurar (ou no seletor de campo nas Análises clássicas), selecione Adicionar e Medição personalizada para criar uma nova medição personalizada.
    • Na interface padrão da Análise, selecione o menu Mais da medição personalizada no painel Configurar (ou o menu Mais da coluna de dados no painel Dados) e selecione Editar.
    • Nas Análises clássicas, selecione o menu Mais representado por três pontos da medição personalizada no seletor de campo (ou o menu de engrenagem da dimensão na tabela de dados) e selecione Editar.
  2. Selecione o campo que você quer usar para filtrar no menu suspenso Nome do filtro na seção Filtros.
  3. Selecione o botão de condição atual, que por padrão é qualquer valor, em Valor do filtro para personalizar as condições de filtro que você quer aplicar.
  4. Selecione a condição e insira ou selecione um valor. Selecione o botão de adição Adicionar ao lado do valor para incluir várias condições no campo selecionado. Para salvar, clique fora da condição de filtro ou use a tecla Esc.
    • Quando disponíveis, as sugestões de valor aparecem em uma lista suspensa, indicada por uma seta para baixo na caixa de entrada de valor, para que os usuários selecionem ou pesquisem. As sugestões estão mais disponíveis para dimensões de type: string.
    • Se você estiver editando uma medição personalizada, mude o nome dela para refletir a condição de filtro. O nome do campo aparece no seletor de campos e na tabela de dados.
  5. Para adicionar mais filtros, selecione o botão de adição Adicionar na seção Valor do filtro. Para remover filtros, selecione o botão de subtração Remover.
    • O Looker aplica automaticamente condições SQL, como a lógica AND ou OR, quando você cria vários filtros, com base nos tipos de campo, condições e valores especificados.
  6. Se quiser, clique na seta para baixo ao lado de Filtro personalizado na parte de baixo da guia Filtros para expandir o campo Expressão e adicionar um filtro personalizado em vez de ou além de um filtro baseado na UI. Insira uma expressão do Looker na caixa Filtro personalizado usando qualquer função e operador do Looker que possa ser usado em filtros personalizados. O editor de expressões do Looker vai sugerir nomes de campos e mostrar ajuda de sintaxe para as funções que você usar. Os campos que são usados em uma Análise e qualificados para uso com o tipo de campo que você está criando são marcados com um círculo preto.
  7. Na guia Detalhes do campo, você pode especificar um formato na seção Formato e adicionar uma descrição opcional de até 255 caracteres na caixa Descrição para dar a outros usuários mais detalhes sobre o campo personalizado, incluindo o uso pretendido.
  8. Selecione Salvar.

Criar uma medição filtrada com base em outra medição

Para criar uma medição personalizada que copia uma medição atual e adiciona um filtro, siga estas etapas:

  1. Abra a visualização que contém a medição em que você quer adicionar um filtro personalizado. A medição não pode ser uma medição personalizada nem uma medição type: number. Para adicionar uma expressão de filtro a uma medição personalizada existente, você precisa editá-la.
  2. Selecione o menu Mais de três pontos dessa medição no painel Configurar (ou o seletor de campo nas Análises clássicas). Você também pode selecionar o menu Mais da coluna de dados no painel Dados ou o menu de engrenagem no painel Dados para Análises clássicas.
  3. Selecione Criar medição filtrada.
  4. Especifique um nome diferente do padrão no campo Nome, conforme necessário. O nome aparece no seletor de campos e na tabela de dados.
  5. Na seção Filtros, selecione o campo que você quer usar para filtrar no menu suspenso Nome do filtro.
  6. Selecione o botão de condição atual, que por padrão é qualquer valor, em Valor do filtro para personalizar as condições de filtro que você quer aplicar.
  7. Selecione a condição e insira ou selecione um valor. Selecione o botão de adição Adicionar ao lado do valor para incluir várias condições no campo selecionado. Para salvar, clique fora da condição de filtro ou use a tecla Esc.
    • Quando disponíveis, as sugestões de valor aparecem em uma lista suspensa, indicada por uma seta para baixo na caixa de entrada de valor, para que os usuários selecionem ou pesquisem. As sugestões estão mais disponíveis para dimensões de type: string.
    • Se você estiver editando uma medição personalizada, mude o nome dela para refletir a condição de filtro.
  8. Para adicionar mais filtros, selecione o botão de adição Adicionar na seção Valor do filtro. Para remover filtros, selecione o botão de subtração Remover.
    • O Looker aplica automaticamente condições SQL, como a lógica AND ou OR, quando você cria vários filtros, com base nos tipos de campo, condições e valores especificados.
  9. Se quiser, clique na seta ao lado de Filtro personalizado na parte de baixo da guia Filtros para expandir o campo Expressão e adicionar um filtro personalizado em vez de ou além de um filtro baseado na UI. Insira uma expressão do Looker na caixa Filtro personalizado usando qualquer função e operador do Looker que possa ser usado em filtros personalizados. O editor de expressões do Looker vai sugerir nomes de campos e mostrar ajuda de sintaxe para as funções que você usar. Os campos que são usados em uma Análise e qualificados para uso com o tipo de campo que você está criando são marcados com um círculo preto.
  10. Na guia Detalhes do campo, você pode especificar um formato na seção Formato e adicionar uma descrição opcional de até 255 caracteres na caixa Descrição para dar a outros usuários mais detalhes sobre o campo personalizado, incluindo o uso pretendido.
  11. Selecione Salvar.

O seletor de campo vai mostrar a nova medição na seção Campos personalizados.

Como acontece com outras medições, é possível adicionar ou remover uma medição personalizada de uma consulta clicando no nome dela. Você também pode passar o cursor sobre o campo para conferir outras opções disponíveis, incluindo selecionar o ícone Filtrar para usá-lo como filtro em uma consulta. Também é possível editar o campo, se necessário.

Como criar uma dimensão personalizada usando uma expressão do Looker

Os métodos para criar uma dimensão personalizada variam de acordo com o uso da interface padrão da Análise ou da interface clássica da Análise.

Criar uma dimensão personalizada na interface padrão da Análise

Para criar uma dimensão personalizada na interface padrão de Análise usando uma expressão do Looker e uma ou mais dimensões, siga estas etapas:

  1. No painel Configurar, selecione + Adicionar e escolha Dimensão personalizada.

  2. Na caixa Expressão, insira uma expressão do Looker que calcule o valor da dimensão usando funções e operadores do Looker. O editor de expressões do Looker vai sugerir nomes de campos e mostrar ajuda de sintaxe para as funções que você usar. Os campos usados em uma Análise e que podem ser usados com o campo que você está criando são marcados com um círculo preto.

  3. Selecione uma opção de formatação diferente da padrão no menu suspenso Formato, conforme necessário.

  4. Especifique o nome da dimensão personalizada no campo Nome. O nome aparece no painel Configurar e na tabela de dados.

  5. Selecione + Adicionar descrição para incluir uma descrição opcional de até 255 caracteres na caixa Descrição e dar mais contexto ou informações sobre a dimensão personalizada para outros usuários.

  6. Selecione Salvar.

A nova dimensão personalizada vai aparecer automaticamente na tabela de dados e na visualização Campos personalizados no painel Configurar.

Como acontece com outros campos, é possível adicionar ou remover uma dimensão personalizada de uma consulta clicando no nome dela. Você também pode manter o ponteiro sobre o campo para revelar mais opções disponíveis, incluindo selecionar o ícone Filtrar para usá-lo como um filtro em uma consulta. Também é possível editar o campo, se necessário.

Como criar uma dimensão personalizada em Análises clássicas

Para criar uma dimensão personalizada em Análises clássicas usando uma expressão do Looker e uma ou mais dimensões, siga estas etapas:

  1. Selecione Adicionar na seção Campos personalizados do seletor de campo.
  2. Escolha Dimensão personalizada.
  3. Na caixa Expressão, insira uma expressão do Looker que calcule o valor da dimensão usando funções e operadores do Looker. O editor de expressões do Looker vai sugerir nomes de campos e mostrar ajuda de sintaxe para as funções que você usar. Os campos usados em uma Análise e que podem ser usados com o campo que você está criando são marcados com um círculo preto.
  4. Selecione uma opção de formatação diferente da padrão no menu suspenso Formato, conforme necessário.
  5. Especifique o nome da dimensão personalizada no campo Nome. O nome aparece no seletor de campos e na tabela de dados.
  6. Selecione + Adicionar descrição para incluir uma descrição opcional de até 255 caracteres na caixa Descrição e dar mais contexto ou informações sobre a dimensão personalizada para outros usuários.
  7. Selecione Salvar.

O seletor de campo vai mostrar sua nova dimensão personalizada na seção Campos personalizados.

Como acontece com outros campos, é possível adicionar ou remover uma dimensão personalizada de uma consulta clicando no nome dela. Você também pode manter o ponteiro sobre o campo para revelar mais opções disponíveis, incluindo selecionar o ícone Filtrar para usá-lo como um filtro em uma consulta. Também é possível editar o campo, se necessário.

Como duplicar um campo personalizado

Se você tiver permissão para criar campos personalizados, também poderá duplicar os campos personalizados existentes que você ou outros usuários criaram. Duplicar e editar campos personalizados pode ser útil se você quiser criar vários campos personalizados com pequenas diferenças (por exemplo, somas de 30, 60 ou 90 dias).

Os métodos para duplicar um campo personalizado variam de acordo com a interface usada: interface padrão do Explore ou interface clássica do Explore.

Como duplicar campos personalizados na interface padrão da Análise

É possível duplicar campos personalizados na interface padrão da Análise de uma das seguintes maneiras:

  • No painel Configurar, abra a visualização Campos personalizados, selecione o menu Mais do campo personalizado e clique em Duplicar.
  • No painel Dados, selecione o menu Mais da coluna de dados do campo personalizado e escolha Duplicar.

O campo personalizado duplicado aparece na visualização Campos personalizados no painel Configurar e na tabela de dados, usando o nome do campo original com a palavra "Cópia" adicionada ao final.

Em seguida, você pode editar o campo personalizado duplicado.

Como duplicar campos personalizados em Análises clássicas

Nas Análises clássicas, é possível duplicar campos personalizados das seguintes maneiras:

  • Usando o menu Mais de três pontos de um campo personalizado na seção Campos personalizados do seletor de campo
  • Como usar o menu de engrenagem da tabela de dados de um campo personalizado

Para duplicar um campo personalizado nas Análises clássicas, siga estas etapas:

  1. No seletor de campos, abra a seção Campos personalizados.
  2. Selecione o menu de três pontos Mais do campo personalizado que você quer duplicar.
  3. Selecione Duplicar.

Como alternativa, selecione Duplicar no menu de engrenagem da tabela de dados do campo personalizado.

O campo duplicado aparece abaixo do original na seção Campos personalizados do seletor de campo, usando o nome do campo original com a palavra "Cópia" adicionada ao final.

Em seguida, você pode editar o campo personalizado duplicado.

Editar um campo personalizado

Se você tiver permissão para criar campos personalizados, também poderá editar os campos personalizados que você ou outros usuários criaram.

Os métodos para editar um campo personalizado variam de acordo com o uso da interface padrão da Análise ou da interface clássica da Análise.

Como editar campos personalizados na interface padrão da Análise

É possível editar campos personalizados na interface padrão da Análise de uma das seguintes maneiras:

  • No painel Configurar, abra a visualização Campos personalizados, selecione o menu Mais do campo personalizado e clique em Editar.
  • No painel Dados, selecione o menu Mais da coluna de dados do campo personalizado e escolha Editar.

As duas opções abrem a caixa de diálogo para editar o campo personalizado.

Editar uma dimensão personalizada

Para editar uma dimensão personalizada, siga estas etapas:

  1. Mude a definição da dimensão personalizada conforme necessário na caixa Expressão. Quando disponível, você pode usar a assistência do Gemini para criar uma expressão do Looker.
  2. Selecione um novo formato no menu suspenso Formato, se necessário.
  3. Digite um novo nome no campo Nome, conforme necessário. O nome aparece no painel Configurar e na tabela de dados. Se você tiver alterado a definição de um campo personalizado, considere modificar o nome para que ele corresponda.
  4. Adicione ou atualize uma descrição opcional de até 255 caracteres na caixa Descrição para dar mais contexto ou informações sobre a dimensão personalizada a outros usuários.
    • Se houver uma descrição, a caixa Descrição vai aparecer automaticamente. Se não houver uma descrição, selecione + Adicionar descrição para incluir uma descrição opcional.
  5. Selecione Salvar.

Editar uma medição personalizada

Para editar uma medição personalizada, siga estas etapas:

  1. Para mudar o campo que deve ser agregado, selecione um novo campo no menu suspenso Campo a ser medido.
  2. Para mudar o tipo de função de medição, selecione uma nova opção no menu suspenso Tipo de medição.
  3. Digite um novo nome no campo Nome, conforme necessário. O nome aparece no painel Configurar e na tabela de dados. Se você mudar um campo ou tipo de medição, normalmente também precisará mudar o nome da medição personalizada para que corresponda. Por exemplo, se você mudar o campo Preço de venda para Custo, também precisará mudar o nome do campo personalizado, neste caso, de Soma do preço de venda para Soma do custo.
  4. Adicione, mude ou remova um filtro personalizado ou baseado na UI na guia Filtros.
    • Se houver um filtro personalizado, a caixa Expressão vai aparecer automaticamente. Se não houver um filtro personalizado, selecione a seta para baixo ao lado de Filtro personalizado para adicionar um filtro personalizado opcional na caixa Expressão em vez de ou além de um filtro baseado na UI.
  5. Na guia Detalhes do campo, adicione, mude ou remova qualquer formatação na seção Formato ou adicione uma descrição opcional de até 255 caracteres na caixa Descrição para dar a outros usuários mais detalhes sobre o campo personalizado, incluindo o uso pretendido.
  6. Selecione Salvar.

Editar um grupo ou agrupamento personalizado

Para editar condições de grupo, pontos de interrupção de agrupamento, nomes de campos e descrições em um grupo ou agrupamento personalizado, depois de abrir a caixa de diálogo de edição, siga as etapas nas seções Agrupamento personalizado e Agrupamento personalizado.

Como editar campos personalizados em Análises clássicas

Nas Análises clássicas, é possível editar campos personalizados das seguintes maneiras:

  • Usando o menu Mais de três pontos de um campo personalizado na seção Campos personalizados do seletor de campo
  • Como usar o menu de engrenagem da tabela de dados de um campo personalizado

Editar uma dimensão personalizada

Para editar uma dimensão personalizada nas Análises clássicas, siga estas etapas:

  1. Mude a definição da dimensão personalizada conforme necessário na caixa Expressão.
  2. Selecione um novo formato no menu suspenso Formato, se necessário.
  3. Insira um novo nome no campo Nome, se necessário. O nome aparece no seletor de campos e na tabela de dados. Se você tiver alterado a definição de um campo personalizado, considere modificar o nome para que ele corresponda.
  4. Selecione + Adicionar descrição para incluir uma descrição opcional de até 255 caracteres na caixa Descrição e dar mais contexto ou informações sobre a dimensão personalizada para outros usuários.
    • Se houver uma descrição, a caixa Descrição vai aparecer automaticamente.
  5. Selecione Salvar.

Editar uma medição personalizada

Para editar uma medição personalizada nas Análises clássicas, siga estas etapas:

  1. Para mudar o campo que deve ser agregado, selecione um novo campo no menu suspenso Campo a ser medido.
  2. Para mudar o tipo de função de medição, selecione uma nova opção no menu suspenso Tipo de medição.
  3. Insira um novo nome no campo Nome, se necessário. O nome aparece no seletor de campos e na tabela de dados. Se você mudar um campo ou tipo de medição, normalmente também precisará mudar o nome da medição personalizada para que corresponda. Por exemplo, se você mudar o campo Preço de venda para Custo, também precisará mudar o nome do campo personalizado, neste caso, de Soma do preço de venda para Soma do custo.
  4. Adicione, mude ou remova um filtro personalizado ou baseado na UI na guia Filtros.
    • Se houver um filtro personalizado, a caixa Expressão vai aparecer automaticamente. Se não houver um filtro personalizado, selecione a seta para baixo ao lado de Filtro personalizado para adicionar um filtro personalizado opcional na caixa Expressão em vez de ou além de um filtro baseado na UI.
  5. Na guia Detalhes do campo, adicione, mude ou remova qualquer formatação na seção Formato ou adicione uma descrição opcional de até 255 caracteres na caixa Descrição para dar a outros usuários mais detalhes sobre o campo personalizado, incluindo o uso pretendido.
  6. Selecione Salvar.

Editar um grupo ou agrupamento personalizado nas Análises clássicas

Para editar condições de grupo, pontos de interrupção de agrupamento, nomes de campo e descrições em um grupo ou agrupamento personalizado nas Análises detalhadas clássicas, depois de abrir a caixa de diálogo de edição, siga as etapas nas seções Agrupamento personalizado e Agrupamento personalizado.

Como remover e excluir campos personalizados

Se você tiver permissão para criar campos personalizados, poderá removê-los de uma consulta ou excluí-los da Análise.

Quando você exclui um campo personalizado, ele desaparece da Análise, mas não dos Looks ou blocos de painel que o utilizam. Além disso, qualquer pessoa que usar um URL para uma Análise que tinha o campo personalizado ainda terá o campo.

Você pode escolher entre Remover e Excluir:

  • Remover: remove o campo personalizado da consulta e da tabela de dados da Análise, mas mantém a definição dele na seção Campos personalizados do seletor de campo para que você possa adicioná-lo novamente à consulta mais tarde.
  • Excluir: exclui permanentemente o campo personalizado da consulta da Análise e da seção Campos personalizados do painel Configurar (ou do seletor de campos nas Análises clássicas).

Os métodos para remover e excluir um campo personalizado variam de acordo com o uso da interface padrão do recurso Explorar ou da interface clássica do recurso Explorar.

Como remover campos personalizados na interface padrão da Análise

Na interface padrão da Análise, é possível escolher entre Remover e Excluir:

  • Remover: remove o campo personalizado da consulta e da tabela de dados da Análise, mas mantém a definição dele na visualização Campos personalizados no painel Configurar para que você possa adicioná-lo novamente à consulta mais tarde.
  • Excluir: exclui permanentemente o campo personalizado da consulta da Análise e da visualização Campos personalizados no painel Configurar.

Para remover um campo personalizado da consulta e mantê-lo no painel Configurar, use um dos seguintes métodos:

  • No painel Dados, selecione o menu Mais da coluna de dados do campo personalizado e escolha Remover.
  • No painel Configurar, selecione a guia Campos em uso e clique no nome do campo personalizado para desmarcá-lo.

O campo personalizado não vai mais aparecer na tabela de dados ou nos resultados da consulta, mas vai continuar disponível na visualização Campos personalizados no painel Configurar.

Como excluir campos personalizados na interface padrão da Análise

Para excluir permanentemente um campo personalizado de uma consulta de análise detalhada e do painel Configurar, use um dos seguintes métodos:

  • No painel Configurar, abra a visualização Campos personalizados, selecione o menu Mais do campo personalizado e escolha Excluir.
  • No painel Dados, selecione o menu Mais da coluna de dados do campo personalizado e escolha Excluir.

Também é possível usar os atalhos de teclado Command-K (Mac) ou Ctrl+K (Windows) para excluir campos personalizados e limpar campos de uma consulta de Análise.

Para restabelecer um campo personalizado que você excluiu, selecione a seta para voltar no navegador.

Como remover campos personalizados nas Análises clássicas

É possível remover campos personalizados em Análises clássicas de uma das seguintes maneiras:

  • Usando o menu Mais de três pontos de um campo personalizado na seção Campos personalizados do seletor de campo
  • Como usar o menu de engrenagem da tabela de dados de um campo personalizado

Para excluir um campo personalizado nas Análises clássicas, siga estas etapas:

  1. No seletor de campos, abra a seção Campos personalizados.
  2. Selecione o menu de três pontos Mais do campo personalizado que você quer remover.
  3. Selecione Remover.

Como alternativa, selecione Remover no menu de engrenagem da tabela de dados do campo personalizado.

Como excluir campos personalizados em Análises clássicas

É possível excluir campos personalizados em Análises clássicas de uma das seguintes maneiras:

  • Usando o menu Mais de três pontos de um campo personalizado na seção Campos personalizados do seletor de campo
  • Como usar o menu de engrenagem da tabela de dados de um campo personalizado

Para excluir um campo personalizado nas Análises clássicas, siga estas etapas:

  1. No seletor de campos, abra a seção Campos personalizados.
  2. Selecione o menu de três pontos Mais no campo personalizado que você quer excluir.
  3. Selecione Excluir.

Como alternativa, selecione Excluir no menu de engrenagem da tabela de dados do campo personalizado.

Também é possível usar os atalhos de teclado Command-K (Mac) ou Ctrl+K (Windows) para excluir campos personalizados e limpar campos de uma consulta de Análise.

Para restabelecer um campo personalizado que você excluiu, selecione a seta para voltar no navegador.

Agora que você aprendeu a criar e editar campos personalizados, talvez queira fazer o seguinte: