detalhar_campos (para campos)

Esta página se refere ao parâmetro drill_fields que faz parte de uma dimensão ou medida.

O drill_fields também pode ser usado como parte de uma visualização, conforme descrito na página de documentação do parâmetro drill_fields (para visualizações).

Uso

view: view_name {
dimensão: field_name {
drill_fields: [field_or_set, field_or_set, ...]
}
}

Hierarquia Ver arquivo view Tipo de campo drill_fields

Tipos de campo possíveis Dimensão, dimensão em um grupo de dimensões, medida Aceita Uma lista com colchetes entre nomes de campos ou nomes de conjuntos

Definição

O parâmetro drill_fields controla o que acontece quando um usuário clica no valor de uma célula da tabela enquanto explora os dados. Quando um usuário faz isso, ele "detalha" os dados, permitindo que ele veja os registros individuais que compõem essa célula, limite a consulta ao valor da célula ou divida os dados de maneira relacionada.

O parâmetro drill_fields aceita uma lista de campos, uma lista de conjuntos ou uma combinação de ambos os campos e conjuntos.

Se uma medida usar o parâmetro drill_fields, os campos de detalhamento definidos no nível da vista da propriedade não serão aplicados a essa medida.

O detalhamento pode ser desativado em alguns casos:

• Ao usar o parâmetro can_filter
• Ao usar o rawperíodo em um grupo de dimensões

Quando os usuários clicam em um campo de detalhamento, eles são direcionados para uma sobreposição de detalhamento. Os dados na sobreposição têm uma classificação padrão com base na priorização a seguir:

1. A primeira dimensão de data, em ordem decrescente
2. Se não houver dimensões de data, a primeira medida, decrescente
3. Se não houver medidas, a primeira dimensão adicionada, crescente

Detalhar dimensões

Ao detalhar uma dimensão, você tem as seguintes opções:

• Limite a consulta ao valor da dimensão selecionada pelo usuário
• Limite a consulta ao valor da dimensão selecionada pelo usuário e substitua a dimensão por outra dimensão

Limitar a consulta ao valor da dimensão selecionada pelo usuário

Ao detalhar uma dimensão, uma opção é limitar a consulta ao valor da dimensão selecionada. Nesse caso, quando um usuário clica em um valor de dimensão, ele pode escolher filtrar o valor.

Neste exemplo, ao selecionar Filter on "UK" no menu de detalhamento, a consulta resultante será filtrada para mostrar apenas os resultados em que Country é UK.

Essa opção é um comportamento padrão para dimensões e não requer o uso do parâmetro drill_fields.

Substituir a dimensão que o usuário selecionou por outra dimensão

Quando você detalhar uma dimensão, outra opção será limitar a consulta ao valor da dimensão selecionada e substituir a dimensão original por outra dimensão relacionada nos resultados da consulta. Por exemplo, suponha que você tenha um campo chamado País e queira fornecer aos usuários a opção de detalhar por estado e cidade. O LookML seria semelhante a este:

dimension: country {
  sql: ${TABLE}.country ;;
  drill_fields: [state, city]
}

Na IU do Looker, o menu de detalhamento da dimensão País oferece opções para detalhar cada valor por estado e por cidade.

Neste exemplo, se o usuário selecionar a opção por estado no menu de detalhamento para o valor EUA na coluna País, a coluna País na consulta resultante será substituída por Estado. As medidas adicionadas à consulta antes da perfuração também são transferidas para a nova consulta.

Os grupos de dimensões de type: time têm campos de detalhamento adicionados por padrão. Cada período pode detalhar os períodos mais granulares (por exemplo, a semana pode detalhar a data e a hora, mas não o mês). No entanto, é possível limitar os períodos de detalhamento usando o parâmetro drill_fields:

dimension_group: created {
  type: time
  timeframes: [time, date, week, month, year]
  sql: ${TABLE}.created ;;
  drill_fields: [created_month, created_date]
}

Detalhar as medidas

O detalhamento de uma medida mostra os dados no nível da linha dos itens que a compõem. Embora o parâmetro drill_fields possa ser usado com qualquer tipo de medida, geralmente faz mais sentido quando drill_fields é usado com uma medida de type: count ou type: count_distinct. As informações exibidas para cada linha são definidas pelos campos ou conjuntos definidos por você no parâmetro drill_fields.

Por exemplo, suponha que você tenha o seguinte LookML:

measure: count {
  type: count
  drill_fields: [user_details*]
}
set: user_details {
  fields: [id, city, state, country]
}

Neste exemplo, conforme definido em LookML, como o subparâmetro fields do parâmetro set lista os campos id, city, state e country, esses campos vão aparecer nos resultados da consulta quando você detalhar a medida count.

Links para painéis nos menus de detalhamento

Se o administrador do Looker tiver ativado o recurso Painéis em menus de detalhamento, o Looker identificará automaticamente os painéis possíveis de uma determinada dimensão. Para especificar links para painéis específicos (ou outros URLs que não são do Looker), use o parâmetro link.

Os painéis aparecem automaticamente no menu de detalhamento quando têm um filtro no campo que você está pesquisando. Isso acontece nos seguintes casos:

• Há um filtro de tipo de campo global no painel que aponta para o campo em que você está fazendo o detalhamento.
• Há um filtro de painel aplicado ao campo em um bloco do painel. Por exemplo, pode haver um filtro de painel numérico aplicado ao campo users.age em um determinado bloco de painel. Isso fará com que o painel apareça no menu de detalhamento do campo users.age.
• Os painéis de controle estão em pastas compartilhadas.

Para um exemplo de detalhamento de um painel pelo menu de detalhamento de um campo, consulte a seção Como detalhar painéis na página de documentação Como analisar dados no Looker.