Adicionar campos personalizados

Observação: esta página faz parte da série de aprendizado Extrair e representar dados em gráficos.

A maioria dos campos no seletor de campos é criada pelos desenvolvedores do Looker. No entanto, ao usar campos personalizados, é possível criar novas dimensões e medições personalizadas ad hoc em uma Análise. Esta página discute como criar e usar campos personalizados para aprimorar a análise de dados.

Para usar campos personalizados, o administrador do Looker precisa conceder a permissão create_custom_fields a usuários ou grupos para permitir o acesso ao recurso.

Quando você tem acesso a campos personalizados, é possível criar vários tipos:

• Uma medida personalizada com base em uma dimensão atual
• Uma medida personalizada filtrada com base em uma medida atual
• Uma dimensão personalizada com base em uma expressão do Looker

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

Há algumas diferenças entre campos personalizados e dimensões e medições definidas no LookML, incluindo:

• Não há recursos de detalhamento para campos personalizados.
• Os campos personalizados só permanecem no seletor de campos da seção "Explorar" para alguns usuários.

Há algumas diferenças entre os campos personalizados e os cálculos de tabela:

• Os campos personalizados geram SQL que será executado no banco de dados, semelhante a um campo do LookML.
• Os campos personalizados não dependem dos dados da tabela de dados.

Tipos de campos personalizados

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

• Dimensão
• Medir

Tipos de campo personalizado 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 detalhada, dependendo do tipo de campo do LookML. A tabela a seguir descreve os tipos de campos personalizados aceitos em cada tipo de dimensão.

S = funciona com o tipo de dados string

N = funciona com o tipo de dados number e medidas 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 de número inteiro ^*

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:

• Agregação: os campos agregados são tipos de medidas 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: campos não agregados são dimensões que podem ser agrupadas em uma consulta de análise.

Nome do campo personalizado	Categoria	Descrição	Compatibilidade do tipo de campo do LookML
Contagem distinta Contagem distinta	Agregar	Cria uma métrica count_distinct que calcula o número de valores distintos de uma dimensão selecionada.	S N T ZC YN DI DU TS ID SD L
Soma Soma	Agregar	Cria uma medida sum que soma os valores de uma dimensão selecionada.	N DI DU ID
Média Média	Agregar	Cria uma medida average que calcula a média dos valores de uma dimensão selecionada.	N DI DU ID
Mín. Mín.	Agregar	Cria uma medição min que encontra o menor valor de uma dimensão selecionada.	N DI DU ID
Máx. Máx.	Agregar	Cria uma métrica max que encontra o maior valor de uma dimensão selecionada.	N DI DU ID
Mediana Mediana	Agregar	Cria uma medição median que encontra o ponto médio dos valores de uma dimensão selecionada.	N DI DU ID
Lista de valores exclusivos 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 Agrupamento	Não agregado	Cria classes, 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 Grupo	Não agregado	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. Isso pode afetar os tipos de campos personalizados disponíveis para esses campos. Por exemplo, o Looker interpreta o período hour_of_day como um tipo de dados number e, portanto, tem opções de campo personalizadas disponíveis para outros campos type: number. Para informações mais específicas, consulte a seção Como os campos personalizados interpretam tipos de dados de data e hora nesta página.

Tipos de campo personalizado para medidas

Você só pode criar um tipo de campo personalizado, uma medida filtrada, com base nas medidas no seletor de campo de uma Análise, dependendo do tipo de medida do LookML. A tabela a seguir descreve os campos do LookML em que tipos de medidas você pode adicionar um filtro.

LI = Funciona com o tipo de medida list

DT = Funciona com o tipo de medida date

Sim = funciona com o tipo de medida yesno

N = funciona com tipos de medidas numéricos ^*

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

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

O Looker interpreta alguns períodos e tipos baseados em tempo como diferentes tipos de dados quando você cria campos personalizados. Isso 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:

• Carimbo de data/hora
• Número inteiro
• String

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

Tipos de dados de data com 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:

• date
• time
• microsecond
• millisecond
• millisecondX
• second
• minute
• minuteX
• hour
• hourX
• week
• month
• quarter
• fiscal_quarter
• fiscal_year
• year

Tipos de dados de data inteiros

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

• hour_of_day
• day_of_month
• day_of_year
• month_num
• fiscal_month_num
• week_of_year
• day_of_week_index

Tipos de dados de string de data

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

• time_of_day
• day_of_week
• month_name
• quarter_of_year
• fiscal_quarter_of_year

Como os campos personalizados interpretam medidas numéricas

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

• average
• average_distinct
• count
• count_distinct
• max
• median
• median_distinct
• min
• percent_of_previous
• percent_of_total
• percentile
• percentile_distinct
• running_total
• sum
• sum_distinct

Esses tipos de métrica são compatíveis com o tipo de campo personalizado da métrica filtrada, conforme indicado na tabela Tipos de campo personalizado para métricas.

Aviso: o tipo de medida type: number não é compatível com campos personalizados.

Como criar uma medição personalizada usando uma dimensão

É possível criar uma medida personalizada com base em uma dimensão de uma das seguintes maneiras:

• Usando o menu Mais de três pontos da dimensão
• Usando a seção Campos personalizados do seletor de campos.

O segundo método permite que você personalize o campo personalizado à medida que o cria, por exemplo, renomeando, adicionando uma descrição opcional ou selecionando um formato diferente do padrão.

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

Em muitos casos, você pode usar esta técnica de atalho:

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

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

Assim como nos outros campos, é possível selecionar o nome de um campo personalizado para adicioná-lo ou removê-lo de uma consulta. Também é possível passar o cursor sobre o campo para revelar mais opções disponíveis para ele, incluindo a seleção do ícone Filtro para usá-lo como um filtro em uma consulta. Você também pode editar o campo conforme necessário.

Como usar a seção "Campos personalizados"

Se você quiser definir um formato ou um filtro para uma medida personalizada ao criá-la, comece com o botão Adicionar na seção Campos personalizados:

1. Selecione Adicionar na seção Campos personalizados do seletor de campos.
2. Selecione o tipo de campo que você quer criar. Este exemplo usa a medição personalizada.
3. Selecione um campo para medir no menu suspenso Campo a ser medido, escolha 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 campo e na tabela de dados.
4. Se você quiser adicionar uma condição de filtro, selecione um campo no menu suspenso Nome do filtro na guia Filtros. Adicione ou remova as condições de filtro usando os botões Adicionar e Remover mais e menos Valor do filtro.
   • Também é possível selecionar a seta ao lado de Filtro personalizado para criar uma expressão de filtro personalizado usando funções e operadores do Looker que possam ser usados em filtros personalizados. O editor de expressões do Looker sugere nomes de campos e mostra ajuda sobre a sintaxe de todas as funções usadas. Os campos que são usados atualmente em uma Análise e que podem ser usados com o tipo de campo que você está criando são marcados com um círculo preto. Consulte a seção Como adicionar um filtro personalizado a uma medição personalizada nesta página para mais detalhes sobre como adicionar filtros a medidas.
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 fornecer aos outros usuários mais detalhes sobre o campo personalizado, incluindo a finalidade dele.
6. Selecione Salvar.

O seletor de campos vai mostrar a nova medida personalizada na seção Custom Fields.

Assim como em outros campos, você pode selecionar o nome de um campo personalizado para exibi-lo em uma consulta. Também é possível selecionar o botão Filtrar para usar o campo como um filtro em uma consulta.

Agrupamento personalizado

Com o tipo de campo personalizado Grupo, é possível criar grupos personalizados específicos 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 pode ser ú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. Expanda a visualização que contém a dimensão para a qual você deseja criar grupos personalizados.

2. Você pode realizar a próxima etapa de duas maneiras:

   • Expanda a visualização, selecione o menu Mais de três pontos da dimensão e clique em Agrupar para abrir o menu Agrupar por.
   • Se o campo já estiver selecionado em uma análise detalhada, selecione Agrupar no menu de engrenagem da dimensão na tabela Dados para abrir o menu Agrupar por e siga as próximas etapas para criar grupos personalizados.

   

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 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 do filtro ou use a tecla de escape.

   • 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 possam selecionar ou pesquisar. As sugestões geralmente estão 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 especificados.
   • Se você estiver editando um grupo personalizado, considere mudar o nome para refletir as condições atualizadas.

   

6. Para adicionar mais grupos a essa dimensão, passe o cursor sobre o grupo existente e selecione o botão de sinal de adição Adicionar. para remover grupos, selecione o botão Remover sinal de menos. Para editar um grupo existente, selecione a condição dele. 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 especificados.

7. Opcionalmente, marque 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 do grupo. Neste exemplo, qualquer estado que não seja Oregon, Idaho ou Washington será agrupado em um marcador chamado Outro. Outro é o nome padrão, mas você pode personalizar o 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.

   

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 que outros usuários tenham mais informações sobre o grupo personalizado.

   • Se você estiver editando um grupo personalizado e já houver uma descrição, a caixa Descrição será exibida automaticamente.

10. Selecione Save e Run para executar a Análise novamente.

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

Você pode usar o novo grupo para obter 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 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.

Assim como nos outros campos, é possível selecionar o nome do campo para adicioná-lo ou removê-lo de uma consulta. Também é possível passar o cursor sobre o campo para revelar mais opções disponíveis, incluindo selecionar o ícone Filtro para usá-lo como um filtro em uma consulta. Você também pode editar o grupo personalizado como quiser.

Binário personalizado

O tipo de campo personalizado Bin permite criar agrupamentos ou níveis personalizados específicos 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 do LookML type: tier.

Isso pode ser útil quando você quer agrupar valores rapidamente em intervalos inteiros específicos para ajustar a granularidade dos dados.

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

Para criar um agrupamento, siga estas etapas:

1. Expanda a visualização do seletor de campo que contém a dimensão para a qual você quer criar agrupamentos personalizados.

2. Você pode realizar a próxima etapa de duas maneiras:

   • Selecione o menu de três pontos Mais da dimensão e clique em Lixeira para abrir o menu Lixeira.
   • Se o campo já estiver selecionado em uma Análise, selecione Agrupamento no menu de engrenagem da dimensão na tabela Dados para abrir o menu Lixeira e siga as próximas etapas para criar agrupamentos personalizados.

   

3. Outra opção é selecionar Acessar informações do campo para saber mais sobre os valores da dimensão para a qual você está criando agrupamentos por classes personalizados, incluindo o valor mínimo, o valor máximo e o intervalo de valores. Ter essas informações pode ser útil para determinar a maneira como você especifica 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 inteiros iguais. Por exemplo, camadas 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, camadas 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 bins 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.
   Aviso: é possível criar no máximo 500 agrupamentos para cada tipo de campo personalizado Agrupamento.

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 oferecer a outros usuários mais informações sobre a barra personalizada.

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

8. Selecione Save e Run para executar a Análise novamente.

O novo campo vai aparecer na tabela de dados e mostrar os níveis de valores de acordo com a categoria especificada.

Você pode usar o novo agrupamento para obter novos insights sobre seus dados. Por exemplo, para um compartimento personalizado com base na dimensão 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.

Assim como nos outros campos, é possível selecionar o nome do campo para adicioná-lo ou removê-lo de uma consulta. Também é possível passar o cursor sobre o campo para revelar mais opções disponíveis. Por exemplo, selecione o ícone Filtro para usá-lo como um filtro em uma consulta. Você também pode editar o agrupamento por classes personalizado.

Adicionar um filtro a uma medida personalizada

A aplicação de filtros a métricas personalizadas permite que uma métrica limite os dados, como incluir apenas pedidos de determinadas regiões. É possível adicionar um filtro personalizado a uma métrica personalizada ao criar ou editar uma métrica personalizada. Para adicionar um filtro a uma métrica personalizada:

1. No seletor de campo, expanda a seção Campos personalizados.
2. Selecione Adicionar e Medida personalizada para criar uma medida personalizada ou selecione o menu de três pontos Mais de três pontos para editar uma medição personalizada.
3. Se você estiver editando um campo, selecione Editar.
4. Selecione o campo que você quer usar para filtrar no menu suspenso Nome do filtro na seção Filtros.
5. 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.
6. Selecione a condição e insira ou selecione um valor. Selecione o botão de sinal de adição Adicionar ao lado do valor para acrescentar várias condições ao campo selecionado. Para salvar, clique fora da condição do filtro ou use a tecla de escape.
   • 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 os usuários selecionarem ou pesquisarem. As sugestões geralmente estão disponíveis para dimensões de type: string.
   • Se você estiver editando uma métrica personalizada, mude o nome dela para refletir a condição do filtro. O nome do campo aparece no seletor de campos e na tabela de dados.
7. Para adicionar mais filtros, selecione o botão de sinal de adição Adicionar na seção Valor do filtro. Para remover filtros, selecione o botão Remover sinal de menos.
   • 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.
8. Como alternativa, clique na seta para baixo ao lado de Filtro personalizado na parte de baixo da guia Filtros para expandir a caixa de texto Expressão e adicionar um filtro personalizado em vez de um filtro baseado UI ou além dele. Insira uma expressão do Looker na caixa Filtro personalizado usando qualquer função e operadores do Looker que possam ser usados em filtros personalizados. O editor de expressões do Looker sugere nomes de campos e mostra ajuda sobre a sintaxe de todas as funções usadas. Os campos usados atualmente em uma Análise e qualificados para serem usados com o tipo de campo que você está criando são marcados com um círculo preto.
9. 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.
10. Selecione Salvar.

Criar uma medida filtrada com base em outra

Para criar uma métrica personalizada que copie uma métrica existente e adicione um filtro, siga estas etapas:

1. Abra a visualização que contém a medida a que você quer adicionar um filtro personalizado. A métrica não pode ser personalizada ou type: number. Para adicionar uma expressão de filtro a uma métrica personalizada, você precisa editar a métrica.
2. Selecione o menu Mais de três pontos de três pontos.
3. Selecione Criar medida filtrada.
4. Especifique um nome diferente do padrão no campo Nome. O nome aparece no seletor de campo 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 da condição existente, que por padrão é qualquer valor, em Valor do filtro para personalizar as condições do 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 adicionar várias condições ao campo selecionado. Para salvar, clique fora da condição do filtro ou use a tecla de escape.
   • 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 os usuários selecionarem ou pesquisarem. As sugestões geralmente estão disponíveis para dimensões de type: string.
   • Se você estiver editando uma medida personalizada atual, mude o nome dela para refletir a condição do filtro.
8. Para adicionar mais filtros, selecione o botão de sinal de mais Adicionar na seção Valor do filtro. Para remover filtros, selecione o botão de sinal de menos 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. Como alternativa, clique na seta ao lado de Filtro personalizado na parte de baixo da guia Filtros para expandir a caixa de texto Expressão e adicionar um filtro personalizado em vez de um filtro baseado na UI ou além dele. 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 sugere nomes de campos e mostra ajuda sobre a sintaxe de todas as funções usadas. Os campos que são usados atualmente em uma Análise e que podem ser usados com o tipo de campo que você está criando são marcados com um círculo preto.
10. 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 fornecer 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 medida na seção Campos personalizados.

Assim como em outras medidas, é possível selecionar o nome de uma medida personalizada para adicioná-la ou removê-la de uma consulta. Também é possível passar o cursor sobre o campo para revelar mais opções disponíveis, incluindo selecionar o ícone Filtro para usá-lo como um filtro em uma consulta. Também é possível editar o campo conforme necessário.

Criar uma dimensão personalizada usando uma expressão do Looker

Para criar uma dimensão personalizada usando uma expressão do Looker e uma ou mais outras dimensões, siga estas etapas:

1. Selecione Adicionar na seção Campos personalizados do seletor de campos.
2. Escolha Dimensão personalizada.
3. Na caixa Expressão, insira uma expressão do Looker que calcule o valor da sua dimensão usando funções e operadores do Looker. O editor de expressões do Looker sugere nomes de campos e mostra ajuda sobre a sintaxe de todas as funções usadas. Os campos que estão sendo 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 do padrão na lista suspensa Formato desejada.
5. Especifique o nome da dimensão personalizada no campo Nome. O nome aparece no seletor de campo 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 a outros usuários mais contexto ou informações sobre a dimensão personalizada.
7. Selecione Salvar.

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

Assim como nos outros campos, você pode selecionar o nome de uma dimensão personalizada para adicioná-la ou removê-la de uma consulta. Também é possível passar o cursor sobre o campo para revelar mais opções disponíveis para ele, incluindo a seleção do ícone Filtro para usá-lo como um filtro em uma consulta. Também é possível editar o campo conforme necessário.

Como visualizar e usar campos personalizados

A capacidade de visualizar campos personalizados e como interagir com eles vai variar de acordo com sua permissão para criar ou não.

Visualização de campos personalizados

Se você tiver permissão para criar campos personalizados, poderá ver e editar qualquer um que apareça na seção Campos personalizados do seletor de campo.

Se você não tiver permissão para criar campos personalizados, a seção Campos personalizados não será exibida no seletor de campo.

No entanto, se você incluir um campo personalizado em uma Análise, um Look ou um bloco de dashboard, qualquer usuário com quem você compartilhar esse conteúdo poderá ver o campo personalizado, mesmo que não possa criar campos personalizados. Se você compartilhar esse conteúdo compartilhando um URL da seção "Explorar", ele 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 vão ver 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 permissão para criar campos personalizados, poderá editar e usar qualquer um deles que apareça na seção Campos personalizados do seletor de campos. É possível interagir com elas quase da mesma forma que com outras medidas ou dimensões, incluindo a filtragem, a adição a visualizações e (para dimensões personalizadas) o uso para pivotar resultados. Uma exceção é que você não pode usar campos personalizados para criar filtros do painel.

Somente os usuários que têm permissão para criar campos personalizados podem adicionar esses campos às consultas em cards de Análises detalhadas, Looks ou painéis. No entanto, se um usuário selecionar Acessar aqui em um bloco de visualização ou painel compartilhado que inclui um campo personalizado, ele poderá criar uma nova consulta usando esse campo, mesmo que não tenha permissão para criar campos personalizados.

Duplicar um campo personalizado

Se você tem permissão para criar campos personalizados, também pode duplicar campos personalizados existentes. 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).

Para duplicar um campo personalizado, siga estas etapas:

1. No seletor de campos, expanda a seção Campos personalizados.
2. Selecione o menu de três pontos Mais para o 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, usando o nome do campo original e a palavra "Copiar". anexado ao final.

Em seguida, você pode editar o campo duplicado, conforme descrito na próxima seção.

Como 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.

Como editar uma dimensão personalizada

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

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

3. Selecione Editar.

   Você também pode selecionar Editar no menu de engrenagem da tabela de dados do campo personalizado.

4. Mude a definição da dimensão personalizada conforme necessário na caixa Expressão.

5. Selecione um novo formato na lista suspensa Formato, se quiser.

6. Digite um novo nome no campo Nome conforme desejado. O nome aparece no seletor de campos e na tabela de dados. Se você alterou a definição de um campo personalizado, modifique o nome para que ele corresponda.

7. Selecione + Adicionar descrição para adicionar uma descrição opcional de até 255 caracteres na caixa Descrição e fornecer mais contexto ou informações sobre a dimensão personalizada.

   • Se já houver uma, a caixa Descrição vai aparecer automaticamente.

8. Selecione Salvar.

Editar uma medida personalizada

Para editar uma medida personalizada, siga estas etapas:

1. No seletor de campo, expanda a seção Campos personalizados.
2. Selecione o menu Mais de três pontos para o campo personalizado que você quer editar.

3. Selecione Editar.

   Você também pode selecionar Editar no menu de engrenagem da tabela de dados do campo personalizado.

4. Para alterar o campo a ser agregado, selecione um novo campo no menu suspenso Campo a ser medido.

5. Para mudar o tipo de função de medida, selecione um novo tipo na lista suspensa Tipo de medida.

6. Digite um novo nome no campo Nome conforme desejado. O nome aparece no seletor de campo e na tabela de dados. Se você mudar um campo ou tipo de medição, normalmente precisará também alterar o nome da medição personalizada para que haja correspondência. Por exemplo, se você alterar o campo Preço promocional para Custo, altere também o nome do campo personalizado, nesse caso, de Soma do preço de venda para Soma do custo.

7. Adicione, mude ou remova um filtro personalizado ou baseado na interface na guia Filtros.

   • Se já houver um filtro personalizado, a caixa Expressão será exibida automaticamente. Se não houver um filtro personalizado, clique na seta para baixo ao lado de Filtro personalizado para adicionar um filtro opcional na caixa Expressão em vez de ou em adição a um filtro baseado na interface.

8. 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 fornecer aos outros usuários detalhes adicionais sobre o campo personalizado, incluindo o uso pretendido.

9. Selecione Salvar.

Como excluir um campo personalizado

Se você tiver permissão para criar campos personalizados, também poderá excluir os campos personalizados que você ou outros usuários criaram. Quando você exclui um campo personalizado, ele desaparece de Explorar, mas não de qualquer elemento dos Looks ou dashboards que usam esse campo. Além disso, qualquer pessoa que use o URL de uma Análise com um campo personalizado ainda terá o campo.

Para excluir um campo personalizado do seletor de campo, siga estas etapas:

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

3. Selecione Excluir.

   Você também pode selecionar 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.

Para restabelecer um campo personalizado excluído, clique na seta para voltar no navegador.