Você pode usar vários parâmetros do LookML para tornar as Explorações mais fáceis de usar, alterando a forma como os campos aparecem na interface do usuário sem alterar o LookML subjacente. Esta página oferece uma visão geral dos parâmetros do LookML que modificam a aparência do menu Explorar do Looker e do seletor de campo.
| No Looker, seus usuários podem ver "Explorars" listados no menu Explorar. |
Em uma exploração, os usuários podem usar o seletor de campo para selecionar os campos (dimensões e medidas) para consultar os dados. |
|
|
Nesta página, listamos todos os parâmetros mais usados com um link para a página de referência completa, uma breve descrição da função e uma imagem do que ela faz.
Para dicas e sugestões sobre como tornar a navegação fácil de entender, consulte o artigo Práticas recomendadas: criar uma experiência positiva para usuários do Looker na Central de Ajuda.
Explorar nome e menu
Esta seção descreve o comportamento padrão de um nome e uma aparência do recurso Explorar no menu Explorar. Em seguida, descreve os parâmetros do LookML que permitem alterar esse comportamento:
Comportamento padrão do menu "Explorar"
Nomes de modelos
Por padrão, o menu Explorar é organizado por nomes de modelo, que são determinados pelo nome de cada arquivo de modelo. O menu Explorar mostra uma versão formatada do nome do modelo, com sublinhados alterados para espaços e cada palavra com letras maiúsculas. Abaixo de cada nome de modelo, há uma lista das explorações definidas nesse arquivo.
Explorar nomes
O nome de cada exploração no menu é baseado no parâmetro explore correspondente no arquivo do modelo. Assim como os nomes de modelos, os nomes dos recursos de exploração são formatados no menu para que os sublinhados sejam alterados para espaços e cada palavra seja maiúscula. Ele também é exibido como título "Explorar" acima do seletor de campos.
No exemplo a seguir, a exploração order_items é definida no arquivo de modelo e_commerce_model.model:
explore: order_items {
join: orders {
type: left_outer
sql_on: ${order_items.order_id} = ${orders.id} ;;
relationship: many_to_one
}
}
A opção order_items "Explorar" aparece como Itens do pedido no menu "Explorar" e no seletor de campo.
| Menu "Explorar": | Seletor de campo: |
 |
 |
Para mais informações sobre os arquivos de modelo, consulte a página de documentação Como entender o modelo e ver os arquivos. Para mais informações sobre como definir os explorações, consulte a página de documentação dos parâmetros explore.
label (modelo)
Um parâmetro label do modelo renomeia um modelo no menu Explorar sem mudar a forma como ele é referenciado no LookML. Os URLs de exploração, o ambiente de desenvolvimento integrado do Looker e o SQL Runner ainda refletem o nome real do modelo. A forma como o modelo deve ser referenciado nas configurações do LookML e Admin permanece inalterada.
Por padrão, o modelo market_research.model é exibido como Pesquisa de mercado no menu Explorar:
É possível usar o parâmetro label para renomear o modelo no menu"Explorar". Por exemplo, adicione o código label: "Marketing R&D" ao arquivo de modelo market_research.model:
label: "Marketing R&D"
Neste exemplo, o Looker exibe o nome do modelo da seguinte maneira no menu "Explorar":
label (exploramento)
Um parâmetro label "Explorar" renomeia uma opção "Explorar" no menu Explorar e na página "Explorar" sem alterar a forma como ela é referenciada no LookML.
Se o parâmetro label não for usado, o nome "Explorar" será exibido de acordo com o comportamento padrão.
group_label (exploramento)
Um parâmetro group_label do Explorar muda a organização padrão do menu Explorar. Em vez de listar cada Explorar com o nome do modelo, group_label permite definir um título personalizado para listar um ou mais Explorars.
Neste exemplo, os Explorars Clientes, Inventário, Itens do pedido e Dados do usuário são listados no marcador de grupo Consultas de lojas on-line:
description (exploramento)
Com o parâmetro description do Explorar, você pode adicionar uma descrição de Explorar à IU para que os usuários recebam mais informações ao criar relatórios.
Os usuários podem ver a descrição passando o cursor sobre o ícone de informações ao lado do nome do recurso "Explorar" na parte superior do seletor de campo. Esse ícone também aparece na lista suspensa "Explorar". Se você não adicionar uma descrição explicitamente a um Explorar, nenhuma descrição será exibida.
hidden (exploramento)
Um parâmetro hidden do recurso Explorar oculta o menu Explorar. Por padrão, a propriedade hidden fica desativada, e o recurso Explorar é exibido. hidden não oculta o LookML nem impede o acesso a um recurso"Explorar"pelo URL O hidden não é um recurso de segurança, mas um recurso de apresentação.
Por exemplo, ao adicionar o código LookML hidden: yes ao LookML para o inventory Explorar no exemplo a seguir, você oculta o Explorar Explorar do menu Explorar:
explore: inventory {
hidden: yes
join: order_facts {
view_label: "Orders"
relationship: many_to_one
sql_on: ${order_facts.order_id} = ${order_items.order_id} ;;
}
}
Seletor de campo
Esta seção descreve o comportamento padrão do seletor de campo e, em seguida, os parâmetros do LookML que permitem mudar esse comportamento.
Altere a forma como os nomes de visualização aparecem no seletor de campo com:
Altere a forma como os nomes de campos individuais aparecem no seletor de campo com:
Altere a organização dos campos no seletor de campo com:
Comportamento padrão do seletor de campo
Por padrão, o seletor de campo é organizado por cabeçalhos que correspondem às visualizações especificadas pelo parâmetro view do LookML. Os campos de cada visualização são agrupados no seletor de campos. O tipo de campo (dimensão, grupo de dimensões, medida, campo de filtro e campo de parâmetro) determina onde o campo é exibido na visualização. A menos que o parâmetro label seja usado para alterar o nome de exibição, o seletor de campo vai mostrar uma versão formatada da visualização ou do nome do campo LookML, com sublinhados alterados para espaços e cada palavra com letras maiúsculas.
No exemplo a seguir, o Looker exibe a visualização accounts como Contas no seletor de campo, que é o comportamento padrão:
view: accounts {
sql_table_name: accounts ;;
}
O exemplo a seguir mostra como os nomes de uma dimensão, um grupo de dimensões e uma medida são exibidos por padrão. A mesma formatação será aplicada aos nomes dos campos de filtro e campos de parâmetro.
dimension: account_number {
primary_key: yes
type: number
sql: ${TABLE}.account_number ;;
}
dimension: name {
type: string
sql: ${TABLE}.name ;;
}
dimension_group: created {
type: time
timeframes: [raw, time, date, week, month, quarter, year]
sql: ${TABLE}.created_date ;;
}
measure: average_annual_revenue {
type: average
sql: ${annual_revenue} ;;
value_format_name: custom_amount_value_format
}
Neste exemplo, o seletor de campo mostra os nomes de campo padrão Número da conta, Nome, Data de criação e Receita anual média das dimensões account_number e name, o grupo de dimensões created e a medida average_annual_revenue, respectivamente:
Se você mudar o nome de um campo, o seletor de campo se adaptará ao novo nome, mas talvez você queira adicionar um parâmetro alias com o nome antigo do campo. Esse parâmetro fornece nomes alternativos para um campo que pode aparecer no URL de uma consulta. Ela pode ser útil nos casos em que os nomes dos campos em um modelo mudam, mas algumas pessoas têm links compartilhados para dados e você quer manter esses URLs preexistentes em funcionamento.
view_label (exploramento)
Um parâmetro view_label do Explorar muda como o grupo de campos de uma visualização básica do Explorar é rotulado no seletor de campo sem alterar a forma como o recurso Explorar e os campos dele são referenciados no LookML.
Por exemplo, se você mesclar uma visualização order_facts a uma exploração chamada order_items, será possível usar o parâmetro view_label para definir o rótulo que o Looker mostra para a visualização order_facts no seletor de campo da seguinte maneira:
explore: order_items {
label: "Order Items"
join: order_facts {
view_label: "Orders and more"
relationship: many_to_one
sql_on: ${order_facts.order_id} = ${order_items.order_id} ;;
}
}
Neste exemplo, a visualização order_facts aparece como Pedidos e mais no seletor de campo da exploração Itens do pedido:
view_label (participar)
Com o parâmetro view_label de mesclagem, é possível agrupar campos de uma visualização no nome de outra visualização no seletor de campos. Se você não adicionar explicitamente um view_label a uma mesclagem, o view_label será padronizado com o nome da mesclagem.
Por exemplo, você mescla a visualização products ao product_facts Explorar:
explore: product_facts {
join: products {
type: left_outer
sql_on: ${product_facts.product_id} = ${products.id} ;;
relationship: many_to_one
}
}
Neste exemplo, como um rótulo de visualização não é especificado, os campos da visualização products são agrupados no rótulo de visualização Produtos no seletor de campo, separados da visualização Fatos do produto:
Você pode usar o parâmetro view_label para adicionar um rótulo de visualização à visualização products mesclada, como no exemplo a seguir:
explore: product_facts {
join: products {
view_label: "Product Facts"
type: left_outer
sql_on: ${product_facts.product_id} = ${products.id} ;;
relationship: many_to_one
}
}
Isso agrupa os campos da visualização products no rótulo de visualização Fatos do produto no seletor de campos:
label (visualização)
Um parâmetro label de visualização muda a forma como a visualização é rotulada no seletor de campo sem mudar a forma como é referenciada no LookML. Se não for especificado, o rótulo será padronizado para o nome da visualização. Diferentemente de view_label (Explorar) e view_label (Participar), esse parâmetro afeta todos os "explores" que usam a visualização.
Por exemplo, você pode usar o parâmetro label para especificar um rótulo para a visualização inventory_items da seguinte maneira:
view: inventory_items {
label: "Items in Inventory"
sql_table_name: inventory_items ;;
}
Neste exemplo, o seletor de campo exibe o rótulo Itens no inventário para a visualização inventory_items, em vez do rótulo padrão Itens de inventário:
description (campo)
Você pode adicionar uma description a qualquer campo. Para conexões do BigQuery, se você gerar um projeto LookML do seu banco de dados, o Looker preencherá automaticamente as descrições dos campos com as dos metadados da coluna do BigQuery, se houver.
O usuário pode ver essa descrição em vários lugares. O Looker exibe a descrição quando o usuário seleciona o ícone de informações à direita do nome do campo no seletor de campo:
Além disso, o Looker também exibe a descrição quando o usuário passa o cursor sobre o nome da coluna em uma visualização de tabela ou de gráfico de tabela em uma exploração, um painel ou uma aparência:
hidden (campo)
Por padrão, os campos especificados em uma vista serão exibidos no seletor de campos. O parâmetro hidden do campo oculta um campo no seletor de campo.
Os campos ocultos ainda podem ser acessados na IU se forem adicionados manualmente ao URL e serão exibidos em algumas janelas do Looker. Portanto, considere hidden como uma maneira de manter o seletor de campo limpo, e não como um recurso de segurança.
Como exemplo, ao adicionar o código LookML hidden: yes ao LookML para a dimensão product_id no exemplo a seguir, a dimensão ID do produto é ocultada no seletor de campo:
dimension: product_id {
hidden: yes
type: number
sql: ${TABLE}.product_id ;;
}
fields (campo)
Com o parâmetro fields, você especifica quais campos de uma visualização básica e mesclas de "Explorar" são expostos no seletor de campo. Se você não usar o parâmetro fields, o Looker exporá todos os campos.
Para especificar os campos que você quer exibir no seletor de campo, use uma lista separada por vírgulas de campos ou conjuntos. Para especificar os campos que você quer ocultar do seletor de campo, use o conjunto ALL_FIELDS* com uma lista separada por vírgulas dos campos ou conjuntos a serem excluídos, com um hífen (-) antes de cada um.
Por exemplo, você pode usar o seguinte código LookML para exibir somente uma seleção de campos da seção aircraft "Explorar" no seletor de campos:
explore: aircraft {
fields: [
aircraft.aircraft_model_code,
aircraft.aircraft_engine_code,
aircraft.count,
aircraft.city,
aircraft.country,
aircraft.zip,
]
}
Neste exemplo, a exploração do Aircraft exibe somente as dimensões Código do modelo do aeroporto, Código do mecanismo do aeroporto, Cidade, País e CEP e a medida Contagem no seletor de campo:
label (campo)
Um parâmetro label de campo permite mudar a forma como o nome de um campo vai aparecer no seletor de campo sem mudar a forma como ele é referenciado no LookML. Se nenhum rótulo for especificado, o rótulo será definido por padrão com o nome do campo.
Por exemplo, você pode usar o parâmetro label para definir um rótulo para a dimensão cost da seguinte maneira:
dimension: cost {
label: "price"
type: number
sql: ${TABLE}.cost ;;
}
Neste exemplo, a dimensão Custo tem o rótulo preço no seletor de campo:
view_label (campo)
Um parâmetro view_label de campo permite mudar o nome da visualização em que o campo está listado no seletor, sem alterar a forma como ele é referenciado no LookML. Se nenhum rótulo for especificado, o campo aparecerá abaixo do rótulo da visualização em que ele é definido.
Por exemplo, você pode usar o parâmetro view_label da seguinte maneira para especificar um rótulo de visualização para a dimensão cost:
dimension: cost {
view_label: "Cost Information"
type: number
sql: ${TABLE}.cost ;;
}
Neste exemplo, o Looker exibe a dimensão Custo no rótulo de visualização Informações de custo no seletor de campo:
group_label (campo)
Com o parâmetro group_label, é possível combinar campos em uma lista suspensa comum em uma visualização no seletor de campo.
Neste exemplo, o grupo Informações de frete inclui os campos Cidade do frete, País de envio e Estado do frete:
group_item_label (campo)
Quando os campos são exibidos em um marcador de grupo, talvez não seja necessário mostrar o nome completo dos campos ou os marcadores no seletor de campos. No exemplo mostrado anteriormente para group_label (campo), o rótulo do grupo já indica que os campos pertencem ao frete. Nesses casos, adicione o parâmetro group_item_label a cada um dos campos agrupados para alterar a aparência deles abaixo do marcador do grupo.
Neste exemplo, o grupo Informações de frete inclui os campos Cidade, País e Estado:
