Pular para o conteúdo principal

Criar uma métrica view

info

Visualização

Esse recurso está em Public Preview.

Saiba como criar uma métrica view para centralizar a lógica de negócios e definir consistentemente os indicadores de desempenho key em todas as superfícies de relatórios. Consulte Unity Catalog métricas view. Este site tutorial demonstra como criar uma métrica view usando a UI do Catalog Explorer. Para definir a visualização de métricas usando SQL, consulte CREATE VIEW.

Pré-requisitos​

  • Você deve ter privilégios SELECT nos objetos de dados de origem.
  • O senhor deve ter o privilégio CREATE TABLE e o privilégio USE SCHEMA no esquema em que deseja criar as métricas view.
  • Você também deve ter o privilégio USE CATALOG no catálogo principal do esquema.
  • Permissões CAN USE em um SQL warehouse ou outro compute recurso executando Databricks Runtime 16.4 ou acima.

Um administrador da metastore ou o proprietário do catálogo pode conceder a você todos esses privilégios. Um proprietário ou usuário do esquema com o privilégio MANAGE pode conceder a você os privilégios USE SCHEMA e CREATE TABLE no esquema.

Etapa 1: Escolha uma fonte de dados​

Suas métricas view podem ser baseadas em uma tabela, view, ou consulta SQL. Este tutorial usa a tabela orders no esquema tpch do catálogo samples.

  1. Clique em Ícone de dados. Catalog na barra lateral workspace.
  2. Use a barra de pesquisa no navegador de esquemas para encontrar a tabela samples.tpch.orders. Clique em pedidos para mostrar os detalhes da tabela.
  3. Clique em Create > métricas view . O editor YAML é aberto.

Etapa 2: Definir métricas​

A definição YAML para essas métricas view inclui os seguintes campos de nível superior:

  • version: padrão para 0.1. Essa é a versão da especificação métricas view.
  • source: samples.tpch.orders é um nome de tabela totalmente qualificado. Todas as dimensões e medidas nesta métrica view usam a tabela especificada como fonte de dados.
  • filter: Todas as consultas nesse site view retornam registros com o_orderdate após 1º de janeiro de 1990.
  • dimensions: Order Month, Order Status e Order Priority são definidos como dimensões.
  • measures: Quatro medidas (Order Count, Total Revenue, Total Revenue per Customer e Total Revenue for Open Orders) são definidas, cada uma com uma expressão de agregação especificada.

  1. Use o menu suspenso de catálogo e esquema para escolher onde deseja salvar suas métricas view. Os usuários downstream devem ter pelo menos os privilégios USE CATALOG e USE SCHEMA para acessar as métricas view.

  2. Digite um nome para suas métricas view. métricas view nomes podem incluir valores alfanuméricos e sublinhados.

  3. Substitua o conteúdo do editor pela seguinte definição:

    YAML
    version: 0.1

    source: samples.tpch.orders
    filter: o_orderdate > '1990-01-01'

    dimensions:
      - name: Order Month
        expr: DATE_TRUNC('MONTH', o_orderdate)

      - name: Order Status
        expr: CASE
          WHEN o_orderstatus = 'O' then 'Open'
          WHEN o_orderstatus = 'P' then 'Processing'
          WHEN o_orderstatus = 'F' then 'Fulfilled'
          END

      - name: Order Priority
        expr: SPLIT(o_orderpriority, '-')[1]

    measures:
      - name: Order Count
        expr: COUNT(1)

      - name: Total Revenue
        expr: SUM(o_totalprice)

      - name: Total Revenue per Customer
        expr: SUM(o_totalprice) / COUNT(DISTINCT o_custkey)

      - name: Total Revenue for Open Orders
        expr: SUM(o_totalprice) FILTER (WHERE o_orderstatus='O')

  4. Clique em Criar .

Suas métricas view estão prontas para consumo por qualquer usuário com pelo menos SELECT privilégios no view. Consulte Privilégios e objetos protegíveis do Unity Catalog para saber mais sobre o gerenciamento de permissões. Para saber mais sobre como os usuários podem consultar esse site view, consulte Consulta a métricas view. Depois de criar uma métrica view, o senhor pode revisar a fonte, o filtro e as medidas e dimensões especificadas na Visão geral que se abre.

Etapa 3: adicione uma descrição, comentários e tags​

Na visão geral tab:

  • Clique em Add description (Adicionar descrição ) para adicionar uma descrição aos metadados do site view.
  • Para adicionar comentários, passe o mouse sobre a coluna Comentários da linha em que você deseja adicionar um comentário.
  • Para adicionar tags a uma medida ou dimensão, passe o mouse sobre a coluna Tags na qual você deseja adicionar uma tag.
  • Para adicionar uma tag ao site view, clique em Add tags (Adicionar tags ) no lado direito da página.

Etapa 4: (Opcional) Editar a definição YAML​

O senhor pode acessar view a definição YAML e abrir o editor YAML em Details tab.

  1. Clique em Detalhes .
  2. Clique em ...more lines (mais linhas ) para view a definição completa.
  3. Clique em Editar para abrir o editor YAML.
  4. Adicione ou exclua dimensões ou medidas. Clique em Salvar .

Etapa 5: (Opcional) Definir permissões​

As visualizações métricas respeitam o mesmo modelo de permissões hierárquicas que outros objetos protegíveis do Unity Catalog. Não são necessárias novas permissões se as suas métricas view estiverem armazenadas em um esquema ao qual os consumidores pretendidos tenham acesso de leitura. O senhor pode atribuir explicitamente permissões às métricas view em Permissions tab.

  1. Clique em Permissões .
  2. Use a interface do usuário para conceder e revogar permissões para outros usuários do Databricks.

Para obter mais detalhes, consulte Conceder permissões em objetos em um metastore do Unity Catalog.

Consulta a métricas view​

O senhor pode consultar uma métrica view no workspace SQL editor integrado do ou em qualquer SQL editor que possa acessar seus dados no.Databricks Para consultar uma métrica view, o senhor deve estar conectado a um recurso SQL warehouse ou outro recurso compute em execução Databricks Runtime 16.4 ou superior.

O exemplo de consulta a seguir avalia as três medidas e agregações listadas em Order Month e Order Status. Ele retorna os resultados classificados por Order Month.

Todas as medidas devem ser agrupadas na função MEASURE. Veja a função agregadameasure.

SQL

SELECT
 `Order Month`,
 `Order Status`,
 MEASURE(`Order Count`),
 MEASURE(`Total Revenue`),
 MEASURE(`Total Revenue per Customer`)
FROM
 orders_metric_view
GROUP BY ALL
ORDER BY 1 ASC

Próximas etapas​

Última atualização em