Table of Contents

Puente semántico

Note

El Semantic Bridge está en versión preliminar pública. Tiene limitaciones, como se documenta a continuación, y tanto la API como el alcance de la funcionalidad pueden cambiar.

El Puente semántico es un compilador de modelos semánticos capaz de traducir la estructura y las expresiones de un modelo semántico de una plataforma a otra. Esto permite reutilizar la lógica de negocio en varias plataformas de datos, dar soporte a los usuarios finales y llegar hasta donde consumen los datos. También permite migraciones de una plataforma a otra.

Interfaz

Importar YAML de Metric View

El Puente semántico está disponible a través de Archivo > Abrir > Importar desde Metric View YAML. Se abrirá un cuadro de diálogo que le guiará a través de la importación de una Metric View en el modelo tabular actual y añadirá tablas, columnas, medidas y relaciones según la estructura de la Metric View. Debe tener un modelo tabular abierto en Tabular Editor. Puede ser un modelo nuevo y vacío, o un modelo existente que desee mejorar con los objetos de la Metric View. El botón del menú no se habilitará hasta que abra o cree un nuevo modelo tabular.

Importar una Metric View desde el menú Archivo con Archivo > Abrir > Importar desde Metric View YAML

Introducir los detalles de conexión de Databricks

Debe proporcionar tres datos en este cuadro de diálogo:

  1. La ruta del archivo YAML de Metric View. Puedes pegar la ruta del archivo o usar el botón Examinar para localizarlo.
  2. El nombre de host de Databricks. Esto sirve para proporcionar el argumento correcto en la partición M que se genera para el sistema de origen de Databricks.
  3. La ruta HTTP de Databricks. Esto sirve para proporcionar el argumento correcto en la partición M que se genera para el sistema de origen de Databricks.

Si solo estás probando la función de traducción, puedes indicar valores de marcador de posición para los dos últimos elementos, pero tendrás que corregir las definiciones de las particiones M antes de poder actualizar los datos en tu modelo tabular.

Después de completar los detalles, haz clic en Aceptar. Semantic Bridge traducirá tu Metric View a Tabular y creará todos los objetos TOM por ti.

Detalles de Databricks en el cuadro de diálogo de importación

Resultado

Hay tres resultados posibles:

  1. Éxito: todo lo que había en Metric View se tradujo a Tabular y tienes un modelo tabular listo para usar.
  2. Éxito, pero con algunos problemas: Semantic Bridge no pudo traducir todos los objetos de Metric View; hay mensajes de diagnóstico que puedes revisar para entender qué requiere tu atención.
  3. Fallo: Semantic Bridge no pudo traducir Metric View

Después de cualquiera de los dos tipos de éxito, puedes usar las funciones de deshacer/rehacer con normalidad en Tabular Editor para deshacer o repetir al instante la importación.

Éxito

Notificación de importación exitosa

Éxito con problemas

Notificación de importación exitosa con incidencias

Si haces clic en Ver diagnósticos, puedes ver una lista de mensajes que describen los problemas en la traducción. Estos diagnósticos están disponibles para revisarlos más adelante al emitirlos desde un C# Script:

// Mostrar todos los mensajes de diagnóstico del último intento de importar una Metric View
var sb = new System.Text.StringBuilder();
foreach (var d in SemanticBridge.MetricView.ImportDiagnostics)
{
    sb.AppendLine($"[{d.Severity}] {d.Code} {d.Path}");
    sb.AppendLine($"    {d.Context} {d.Message}");
    sb.AppendLine();
}
Output(sb.ToString());

Diagnóstico de importación

Fallo

Importación fallida

Ver los diagnósticos de un fallo es lo mismo que para un éxito con problemas.

Limitaciones

Plataformas compatibles

En la versión preliminar pública, admitimos traducciones de una Metric View de Databricks a un modelo tabular.

Conectividad

La versión preliminar pública no se conecta a ninguna plataforma aparte de Fabric, Power BI y Analysis Services. Trabajar con modelos de otras plataformas, p. ej., Metric Views de Databricks, se basa en archivos de origen locales, como una definición YAML de Metric View.

Apéndice sobre nomenclatura

Puede resultar confuso hablar del Semantic Bridge, ya que hay muchas palabras que tienen significados tanto genéricos como específicos, según el nivel de abstracción del que estemos hablando y la plataforma que estemos tratando. Por ejemplo, el término "modelo semántico" es a la vez genérico, ya que se refiere al concepto de una colección de datos y lógica de negocio en una forma adecuada para dar soporte a las necesidades de informes y análisis, y también es el nombre que Microsoft ha adoptado para referirse a su implementación específica de este concepto genérico en Power BI y Fabric. Así, un modelo semántico puede referirse de forma genérica a una Metric View de Databricks, a un cubo OLAP/multidimensional, a un modelo semántico de Power BI o a un modelo hospedado en la capa semántica de otra plataforma. Por ello, hemos adoptado las siguientes definiciones y estándares en nuestra documentación para mantener la claridad y la coherencia.

Note

Estas convenciones solo están pensadas para la documentación sobre la funcionalidad Semantic Bridge.

Definiciones

  • modelo semántico: cuando se usa por sí solo, siempre se refiere al concepto genérico de una colección de datos, metadatos y lógica de negocio para respaldar la elaboración de informes y el análisis. Si, y solo si, va inmediatamente precedido de "Fabric" o "Power BI", entonces se refiere a ese tipo de artefacto en esa plataforma, concretamente a un modelo tabular que se guarda como TMDL o BIM y utiliza M y DAX; solemos preferir usar el término modelo tabular para referirnos al modelo semántico de Power BI / Fabric y evitar esta confusión siempre que sea posible, porque el modelo tabular se comparte entre Power BI / Fabric y también con Analysis Services Tabular.
  • Plataforma: una solución tecnológica que tiene una capa semántica, en la que se aloja un modelo semántico genérico. Databricks Metric Views representan una plataforma; Fabric / Power BI representan una plataforma; Analysis Services Tabular es una plataforma; Analysis Services Multidimensional es una plataforma para la que hoy no tenemos compatibilidad en Semantic Bridge.
  • Formato de serialización: una forma de representar un modelo semántico en disco en un formato textual. TMDL y TMSL (.bim) son dos formatos de serialización para un modelo semántico de Power BI; YAML es el formato de serialización de un Databricks Metric View.
  • Modelo de objetos: una representación en memoria de un modelo semántico con la que trabajamos en Tabular Editor mediante Semantic Bridge, ya sea a través de acciones en la GUI o mediante C# Scripts. El TOM, o Tabular Object Model, debería resultar familiar a los usuarios actuales de Tabular Editor. También hemos creado un modelo de objetos para Databricks Metric Views, para permitir su manipulación en nuestra herramienta.

Terminología general de modelado dimensional

Hay muchos términos que se usan de forma general al hablar de un modelo dimensional o de un modelo semántico, y también dentro del modelo de objetos y los formatos de serialización de una plataforma específica. En una Metric View, una medida es una expresión SQL con nombre que define una agregación en la Metric View, y en un modelo tabular, una medida es una expresión DAX con nombre que define una agregación en el modelo tabular. Es imposible hablar del trabajo de Semantic Bridge sin hablar a la vez de los múltiples significados de estas palabras. Por ejemplo, hablamos de traducir una medida de Metric View a una medida tabular. Por ello, siempre nos referimos a un objeto del modelo de una plataforma específica mencionando la plataforma y el objeto, por ejemplo, "medida de Metric View" o "medida tabular"; "campo de Metric View" o "columna de TOM". Si alguna vez se usa el término sin ir acompañado del nombre de una plataforma, entonces estamos hablando del concepto de forma genérica.

Recursos adicionales