Canalizaciones de implementación de bases de datos del centro de eventos y KQL e integración de Git (versión preliminar)
Las bases de datos del centro de eventos y KQL ya se integran con las funcionalidades de administración del ciclo de vida de Microsoft Fabric, lo que proporciona una colaboración estandarizada entre todos los miembros del equipo de desarrollo durante toda la vida del producto. Esta funcionalidad se entrega a través de canalizaciones de implementación e integración de Git.
En este artículo, obtendrá información sobre las opciones de configuración disponibles a través de la administración del ciclo de vida de Microsoft Fabric para centros de eventos y bases de datos KQL.
Integración de Git de la base de datos de KQL y el centro de eventos
El centro de eventos y la base de datos KQL son elementos que contienen metadatos y datos a los que se hace referencia en varios objetos del área de trabajo. El centro de eventos y la base de datos KQL contienen tablas, funciones y vistas materializadas. Desde una perspectiva del flujo de trabajo de desarrollo, los siguientes objetos dependientes pueden hacer referencia a una base de datos del centro de eventos o KQL:
- Definiciones de trabajos de Spark
- Blocs de notas
- Modelos semánticos y Power BI
La integración de Git se aplica en el nivel de plataforma y de datos para los centros de eventos y las bases de datos KQL.
Integración de nivel de plataforma
La siguiente información de la base de datos de KQL y del centro de eventos se serializa y realiza un seguimiento en un área de trabajo conectada a Git:
Eventhouse
- Nombre
- Descripción
- Guid lógico
Base de Datos KQL
- Nombre
- Descripción
- Directiva de caché
- Directiva de retención
- Guid lógico
Integración de nivel de datos
La integración a nivel de datos se logra mediante el uso de un script KQL para crear o modificar esquemas, propiedades y directivas de objetos de base de datos. Sin embargo, es importante tener en cuenta que no todos los comandos admitidos en un script KQL son compatibles con Microsoft Fabric ALM.
Base de Datos KQL
Los siguientes objetos de base de datos se admiten en el script KQL:
- Tabla
- Función
- Actualización de directiva de tabla
- Directiva de codificación de columnas
- Vista materializada
- Asignación de ingesta de tabla
Para obtener información sobre los comandos admitidos, vea la descripción del archivo DatabaseSchema.kql en archivos de base de datos KQL.
Representación de integración de Git
Cada centro de eventos y los elementos de la base de datos KQL sincronizados con Git aparecen en su propia carpeta denominada con el siguiente formato: <ItemName>.<ItemType> donde <ItemName> es el nombre del elemento y <ItemType> es el tipo del elemento. Por ejemplo, para un centro de eventos denominado Example que tiene una base de datos KQL única denominada ExampleDB, las siguientes carpetas aparecen en el repositorio git:
- Example.Eventhouse
- ExampleDB.KQLDatabase
Archivos del centro de eventos
Los archivos siguientes se encuentran en una carpeta del centro de eventos:
.platform
El archivo usa el esquema siguiente para definir un centro de eventos:
{ "$schema": "https://developer.microsoft.com/json-schemas/fabric/gitIntegration/platformProperties/2.0.0/schema.json", "metadata": { "type": "Eventhouse", "displayName": "", "description": "" }, "config": { "version": "2.0", "logicalId": "" } }EventhouseProperties.json
El archivo permite configurar los valores de nivel de plataforma para el elemento del centro de eventos.
Archivos de base de datos KQL
Los archivos siguientes se encuentran en una carpeta de base de datos KQL:
.platform
El archivo usa el esquema siguiente para definir una base de datos KQL:
{ "$schema": "https://developer.microsoft.com/json-schemas/fabric/gitIntegration/platformProperties/2.0.0/schema.json", "metadata": { "type": "KQLDatabase", "displayName": "", "description": "" }, "config": { "version": "2.0", "logicalId": "" } }DatabaseProperties.json
El archivo usa el esquema siguiente para configurar la configuración de nivel de plataforma para el elemento de base de datos KQL:
{ "databaseType": "ReadWrite", "parentEventhouseItemId": "", "oneLakeCachingPeriod": "P36500D", "oneLakeStandardStoragePeriod": "P36500D" }En la tabla siguiente se describen las propiedades del archivo
DatabaseProperties.json.Propiedad Descripción databaseType Valores válidos: ReadWrite parentEventhouseItemId Identificador lógico del centro de eventos primario. Esto no debe modificarse. oneLakeCachingPeriod Configuración de nivel de base de datos para la directiva de almacenamiento en caché. oneLakeStandardStoragePeriod Configuración de nivel de base de datos para la directiva de retención. DatabaseSchema.kql
El archivo es un script KQL que configura los valores de nivel de datos para la base de datos KQL. Se genera automáticamente cuando la base de datos KQL se sincroniza con Git. El archivo se ejecuta al sincronizar con el área de trabajo de Fabric.
Puede realizar cambios en este script agregando o modificando los siguientes comandos admitidos:
Objeto Database Comandos admitidos: Tabla Crear o combinar Función Crear o modificar Actualización de directiva de tabla Alter Directiva de codificación de columnas Alter Vista materializada Crear o modificar Asignación de ingesta de tabla Crear o modificar A continuación se muestra un ejemplo de un script KQL para crear una tabla y su asignación de ingesta.
// KQL script // Use management commands in this script to configure your database items, such as tables, functions, materialized views, and more. .create-merge table SampleTable (UsageDate:datetime, PublisherType:string, ChargeType:string, ServiceName:string, ServiceTier:string, Meter:string, PartNumber:string, CostUSD:real, Cost:real, Currency:string) .create-or-alter table SampleTable ingestion csv mapping 'SampleTable_mapping' "[{'Properties':{'Ordinal':'0'},'column':'UsageDate','datatype':''},{'Properties':{'Ordinal':'1'},'column':'PublisherType','datatype':''}]"