Creación de una vista de métrica mediante la interfaz de usuario del Explorador de catálogos

Aprenda a crear una vista de métricas para centralizar la lógica de negocios y definir de forma coherente indicadores clave de rendimiento en superficies de informes. En este tutorial se muestra cómo crear una vista de métrica mediante la interfaz de usuario del Explorador de catálogos. Para definir vistas de métricas mediante SQL, consulte Uso de SQL para crear y administrar vistas de métricas y CREATE VIEW.

Prerrequisitos

• Debe tener privilegios SELECT en los objetos de datos de origen.
• Debe tener el privilegio CREATE TABLE y el privilegio USE SCHEMA en el esquema en el que desee crear la vista de métricas.
• También debe tener el privilegio USE CATALOG en el catálogo principal del esquema.
• PUEDE USAR permisos en una instancia de SQL Warehouse u otro recurso de proceso que ejecute Databricks Runtime 17.2 o superior.

Un administrador de metastore o el propietario del catálogo puede concederle todos estos privilegios. Un propietario o usuario de esquema con el privilegio de MANAGE puede concederle privilegios USE SCHEMA y CREATE TABLE en el esquema.

Paso 1: Elegir un origen de datos

La vista de métricas puede basarse en una tabla, vista o consulta SQL. En este tutorial se utiliza la tabla orders en el esquema samples del catálogo tpch.

1. Haga clic en Catálogo en la barra lateral del área de trabajo.
2. Use la barra de búsqueda en el explorador de esquemas para buscar la samples.tpch.orders tabla. Haga clic en pedidos para mostrar los detalles de la tabla.
3. Haga clic en Crear>vista métrica. Se abre el editor DE YAML.

Paso 2: Definición de métricas

La definición de YAML para esta vista de métrica incluye los siguientes campos de nivel superior:

• version: Tiene como valor predeterminado 1.1. Esta es la versión de la especificación de visualización de métricas.
• source:samples.tpch.orders es un nombre de tabla completamente calificado. Todas las dimensiones y medidas de esta vista de métrica usan la tabla especificada como origen de datos.
• filter: todas las consultas de esta vista devuelven registros con o_orderdate después del 1 de enero de 1990.
• dimensions:Order Month, Order Statusy Order Priority se definen como dimensiones.
• measures: se definen cuatro medidas (Order Count, Total Revenue, Total Revenue per Customery Total Revenue for Open Orders), cada una con una expresión de agregación especificada.

1. Utilice el menú desplegable de catálogo y esquema para elegir dónde desea guardar las vistas de métricas. Los usuarios que realizan consultas deben tener privilegios de al menos USE CATALOG y USE SCHEMA para acceder a la interfaz de métricas.

2. Escriba un nombre para la vista métrica. Los nombres de vista de métricas pueden incluir valores alfanuméricos y caracteres de subrayado.

3. Reemplace el contenido del editor por la siguiente definición:

   version: 1.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. Haga clic en Crear.

La vista de métricas está disponible para uso por parte de cualquier usuario que tenga al menos privilegios de SELECT en la vista de métricas. Consulte Privilegios del catálogo de Unity y objetos protegibles para obtener más información sobre la administración de permisos. Para obtener más información sobre cómo los usuarios pueden consultar esta vista de métricas, consulte Consulta de una vista de métricas.

Después de crear una vista de métricas, puede revisar el origen, el filtro y las medidas y dimensiones especificadas en la pestaña Información general que se abre.

Paso 3: Agregar una descripción, comentarios y etiquetas

Puede agregar descripciones, comentarios y etiquetas en la definición de YAML o a través de la pestaña Información general .

Para agregar mediante YAML (recomendado para el control de versiones):

Agregue comment campos directamente en la definición de YAML. Consulte Registro de cambios de especificación de versión para obtener detalles de sintaxis.

version: 1.1
comment: 'Orders metrics for revenue analysis'

dimensions:
  - name: Order Month
    expr: DATE_TRUNC('MONTH', o_orderdate)
    comment: 'Month when the order was placed'

measures:
  - name: Total Revenue
    expr: SUM(o_totalprice)
    comment: 'Sum of all order prices'

Para agregar mediante la pestaña Información general:

• Haga clic en Agregar descripción para agregar una descripción a los metadatos de la vista de métricas.
• Para agregar comentarios, mantenga el puntero sobre la columna Comentario de la fila donde desea agregar un comentario.
• Para agregar etiquetas a una medida o dimensión, mantenga el puntero sobre la columna Etiquetas donde desea agregar una etiqueta.
• Para agregar una etiqueta a la vista de métricas, haga clic en Agregar etiquetas en el lado derecho de la página.

Paso 4: (Opcional) Editar la definición de YAML

Puede ver la definición de YAML y abrir el editor de YAML en la pestaña Detalles .

1. Haga clic en Detalles.
2. Haga clic en ... más líneas para ver la definición completa.
3. Haga clic en Editar para abrir el editor de YAML.
4. Agregar o eliminar dimensiones o medidas. Haz clic en Guardar.

Paso 5: (Opcional) Establecer permisos

Las vistas de métrica respetan el mismo modelo de permisos jerárquicos que otros objetos protegibles del catálogo de Unity. No se necesitan nuevos permisos si la vista de métrica se almacena en un esquema al que los consumidores previstos tienen acceso de lectura. Puede asignar explícitamente permisos en la vista de métricas desde la pestaña Permisos .

1. Haga clic en Permisos.
2. Use la interfaz de usuario para conceder y revocar permisos para otros usuarios de Azure Databricks.

Para obtener más información, vea Conceder permisos en un objeto.

Consultar una vista de métricas

Puede consultar una vista de métricas desde el editor de SQL integrado del área de trabajo o desde cualquier editor de SQL que pueda acceder a los datos en Azure Databricks. Para consultar una vista de métricas, debe estar asociado a una instancia de SQL Warehouse u otro recurso de proceso que ejecute Databricks Runtime 17.2 o superior.

La consulta de ejemplo siguiente evalúa las tres medidas enumeradas y realiza agregaciones sobre Order Month y Order Status. Devuelve los resultados ordenados por Order Month.

Todas las medidas se deben encapsular en la MEASURE función . Consulte la measure función de agregación.

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

Pasos siguientes

Ahora que ha creado una vista de métricas con SQL, explore estos temas relacionados:

Consultar y consumir vistas de métricas

• Consultar una vista de métricas.
• Utiliza vistas métricas con paneles de AI/BI
• Utilice vistas de métricas con IA/BI Genie.
• Establezca alertas en las vistas de métricas.

Funciones avanzadas de visualización de métricas

• Utilice metadatos semánticos en las vistas de métricas.
• Utilizar uniones en vistas métricas.
• Utilice medidas de ventana en vistas métricas.
• Referencia de sintaxis de YAML.

Métodos de creación alternativos

• Use SQL para crear y administrar vistas de métricas.
• CREATE VIEW.
• ALTER VIEW.
• DESCRIBE TABLE.

Gobernanza y seguridad

• Administrar privilegios en el catálogo de Unity.
• Grupos.
• Privilegios del catálogo de Unity y objetos protegibles.