Compartir a través de


Visualización de un diagrama de entidades en la base de datos KQL (versión preliminar)

En Real-Time Intelligence, puede ver el linaje y la relación de los elementos de base de datos KQL. La vista permite explorar visualmente las relaciones entre las entidades de base de datos y ayudarle a comprender el flujo de datos del origen al destino, lo que proporciona una representación clara del grafo. Mediante el diagrama de entidades, puede administrar de forma eficaz la base de datos y comprender mejor cómo interactúan estas entidades. Esta representación visual de entidades simplifica la administración de bases de datos y le ayuda a optimizar las estructuras de datos, lo que facilita el seguimiento de las dependencias y realiza acciones rápidamente.

Para obtener información sobre el linaje del área de trabajo en Fabric, consulte Linaje.

Importante

Esta característica se encuentra en versión preliminar.

Prerrequisitos

Para los usuarios que quieran activar los detalles de la ingesta:

  • Permisos de Administrador de base de datos o Monitor de base de datos para ver los detalles de la ingestión en el diagrama de entidades. Para más información, vea Control de acceso basado en roles.

Abrir vista de diagrama de entidades

Para acceder a la vista, vaya a la base de datos KQL deseada y seleccione Diagrama de entidades.

Captura de pantalla que muestra el botón de vista del diagrama de entidades.

¿Qué ve en una vista de diagrama de entidades?

Al abrir la vista de diagrama de entidades, verá las dependencias entre todos los elementos de la base de datos KQL.

Captura de pantalla que muestra una vista de diagrama de entidades en la base de datos KQL.

La vista diagrama de entidades muestra la siguiente información:

Puede seleccionar un elemento para ver sus relaciones con otros elementos de la base de datos. El diagrama de entidades resalta todos los elementos relacionados con ese elemento y atenua el resto.

Visualización de los detalles de la ingesta

También puede ver los detalles de ingesta de cada tabla y vista materializada. Para ver los detalles de la ingesta, en el lado derecho de la cinta de opciones, seleccione Ingesta y, a continuación, el intervalo de tiempo deseado. La información se agrega a la tarjeta de la entidad pertinente.

Captura de pantalla de un diagrama de entidades en el que se muestra la vista de detalles de ingestión.

Ver la ingesta desde Eventstreams

También puede ver los detalles de ingesta de cada tabla que se origina en Eventstream.

Captura de pantalla de un diagrama de entidades en la que se muestra la ingesta desde la vista detalles de Eventstream.

Además del nombre de la secuencia de eventos, puede ver información adicional seleccionando el icono de secuencia verde, que revela el nombre de la secuencia derivada y el nombre del mapeo de ingesta. Si no se muestra ninguna asignación, se usa la asignación predeterminada (identidad). Al habilitar detalles de ingesta en Mostrar detalles, verá el número de registros ingeridos en cada tabla de todos los orígenes, incluidos Eventstreams.

Captura de pantalla de un diagrama de entidades, con los detalles que se muestran después de hacer clic en el icono verde.

Nota:

Solo las secuencias de eventos aparecen como orígenes externos en la vista de diagrama de entidades. Otros orígenes externos no se muestran en el diagrama de entidades.

Violaciones de esquema

Las violaciones del esquema ayudan a identificar inconsistencias o referencias rotas entre entidades de base de datos. Estos son algunos ejemplos de infracciones de esquema:

  • Una función hace referencia a una tabla o columna que ya no existe.
  • Una función hace referencia a otra función que ya no existe.
  • Una función hace referencia a una función con un número o tipo incorrectos de parámetros.
  • Una función hace referencia a una columna cuyo tipo de datos ha cambiado.
  • Una directiva de actualización hace referencia a una función o tabla de origen que ya no existe.
  • Una directiva de actualización hace referencia a una función cuyo esquema de salida no coincide con el esquema de la tabla de destino.
  • La asignación de ingesta no válida (por ejemplo, una o varias columnas definidas en la asignación no existen en la tabla de destino).
  • Exportación continua no válida (por ejemplo, no se encontró una tabla o columna a la que se hace referencia).
  • No se puede acceder a una tabla externa porque es posible que la ubicación de almacenamiento no exista o que no haya permisos suficientes para acceder a ella.

Nota:

Los accesos directos se conocen como "tablas externas" en la funcionalidad de infracciones de esquema.

Al habilitar show Schema Violations (Mostrar infracciones de esquema), se resaltan las entidades afectadas directamente en el diagrama. Al hacer clic en la instancia de Violación de esquema, se abre un panel lateral con detalles sobre la violación.

Esta característica permite localizar y resolver rápidamente las dependencias rotas, lo que garantiza que la base de datos de Eventhouse siga siendo coherente y confiable.

Captura de pantalla de un diagrama de entidades en la que se muestran las infracciones de esquema resaltadas en rojo.

¿Para qué escenarios puede usar un diagrama de entidades?

En esta sección se exploran varios escenarios en los que puede usar la vista de diagrama de entidades en la base de datos KQL:

Administración proactiva de dependencias

La administración de dependencias entre entidades como tablas y funciones resulta sencilla con el linaje. Por ejemplo, si cambia el nombre de una tabla o modifica su esquema, puede identificar instantáneamente qué funciones dependen de esa tabla dentro de su consulta KQL. Este enfoque proactivo ayuda a evitar problemas inesperados y garantiza actualizaciones sin problemas en la estructura de la base de datos.

Rastrear las relaciones entre vistas materializadas y tablas de origen

Los diagramas de entidades permiten realizar un seguimiento de las relaciones entre las vistas materializadas y sus tablas de origen subyacentes. Esto facilita la identificación de orígenes de datos originales, lo que le permite realizar un seguimiento y solucionar problemas del flujo de datos de forma más eficaz.

Interactuar con elementos y actuar

Puede seleccionar en cualquier elemento del gráfico para resaltar sus elementos relacionados, mientras que el resto del gráfico está atenuado, lo que facilita el enfoque en relaciones específicas. Para tablas y tablas externas, en los puntos suspensivos [...], puede seleccionar otras opciones, como consultar la tabla, crear un informe de Power BI basado en la tabla, etc.

Captura de pantalla de una tabla de diagrama de entidades, en la que se muestra el menú más.

Ingestión de registros de seguimiento

Los diagramas de entidades permiten hacer un seguimiento de cuántos registros se han ingerido en cada tabla y cada vista materializada. Esta vista clara de los flujos de datos le ayuda a mantenerse al día del tamaño y el volumen de la ingesta, lo que garantiza que la base de datos procesa los datos correctamente.