Compartilhar via

Pipelines de implantação de banco de dados do Eventhouse e KQL e integração do Git (versão prévia)

  • Artigo

Os bancos de dados dos Eventhouses e KQL integram-se aos recursos de gerenciamento do ciclo de vida no Microsoft Fabric, fornecendo uma colaboração padronizada entre todos os membros da equipe de desenvolvimento durante toda a vida útil do produto. Essa funcionalidade é entregue por meio de integração do Gite pipelines de implantação.

Neste artigo, você aprenderá sobre as opções de configuração disponíveis por meio do gerenciamento de ciclo de vida do Microsoft Fabric para Eventhouses e bancos de dados KQL.

Integração do Git de banco de dados do Eventhouse e KQL

O Eventhouse e o banco de dados KQL são itens que contêm metadados e dados referenciados em vários objetos no espaço de trabalho. O banco de dados do Eventhouse e KQL contém tabelas, funções e exibições materializadas. Do ponto de vista do fluxo de trabalho de desenvolvimento, os seguintes objetos dependentes podem referenciar um banco de dados do Eventhouse ou KQL:

A integração do Git se aplica no nível de dados e plataforma para os Eventhouses e bancos de dados KQL.

Integração no nível da plataforma

As seguintes informações do Eventhouse e do banco de dados KQL são serializadas e rastreadas em um espaço de trabalho conectado ao Git:

  • Eventhouse

    • Nome
    • Descrição
    • GUID lógico

  • Banco de dados KQL

    • Nome
    • Descrição
    • Política de cache
    • Política de retenção
    • GUID lógico

Integração no nível de dados

A integração no nível de dados é obtida por meio do uso de um script do KQL para criar ou modificar esquemas, propriedades e políticas de objetos de banco de dados. No entanto, é importante observar que nem todos os comandos com suporte em um script do KQL são compatíveis com o ALM do Microsoft Fabric.

  • Banco de dados KQL

    Os seguintes objetos de banco de dados têm suporte no script do KQL:

    • Tabela
    • Função
    • Atualização da política de tabela
    • Política de codificação de coluna
    • Exibição materializada
    • Mapeamento da ingestão de tabela

    Para obter informações sobre comandos com suporte, consulte a descrição do arquivo DatabaseSchema.kql em arquivos de banco de dados KQL.

Representação de integração do Git

Cada Eventhouse e itens do Banco de Dados KQL sincronizados com o Git aparecem em sua própria pasta nomeada usando o seguinte formato: <ItemName>.<ItemType> onde <ItemName> é o nome do item e <ItemType> é o tipo do item. Por exemplo, para um Eventhouse chamado Exemplo que tem um único banco de dados KQL chamado ExampleDB, as seguintes pastas aparecem no repositório do Git:

  • Exemplo.Eventhouse
  • ExampleDB.KQLDatabase

Arquivos do Eventhouse

Os seguintes arquivos estão contidos em uma pasta do Eventhouse:

  • .platform

    O arquivo usa o seguinte esquema para definir um Eventhouse:

    {
  "$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

    O arquivo permite definir as configurações no nível da plataforma para o item do Eventhouse.

Arquivos de banco de dados KQL

Os seguintes arquivos estão contidos em uma pasta de banco de dados KQL:

  • .platform

    O arquivo usa o seguinte esquema para definir um banco de dados 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

    O arquivo usa o seguinte esquema para definir as configurações no nível da plataforma para o item de banco de dados KQL:

    {
  "databaseType": "ReadWrite",
  "parentEventhouseItemId": "",
  "oneLakeCachingPeriod": "P36500D",
  "oneLakeStandardStoragePeriod": "P36500D"
}

    A tabela a seguir descreve as propriedades do arquivo DatabaseProperties.json:

    Propriedade Descrição
    databaseType Valores válidos: ReadWrite
    parentEventhouseItemId A ID lógica do Eventhouse pai. Isso não deve ser modificado.
    oneLakeCachingPeriod Configuração de nível de banco de dados para a política de cache.
    oneLakeStandardStoragePeriod Configuração de nível de banco de dados para a política de retenção.

  • DatabaseSchema.kql

    O arquivo é um script do KQLque define as configurações de nível de dados para o banco de dados KQL. Ele é gerado automaticamente quando o banco de dados KQL é sincronizado com o Git. O arquivo é executado ao sincronizar com o Espaço de Trabalho do Fabric.

    É possível fazer alterações nesse script adicionando ou modificando os seguintes comandos com suporte:

    Objeto de banco de dados Comandos com suporte:
    Tabela Criar ou mesclar
    Função Criar ou alterar
    Atualização da política de tabela Alter
    Política de codificação de coluna Alter
    Exibição materializada Criar ou alterar
    Mapeamento da ingestão de tabela Criar ou alterar

    Veja a seguir um exemplo de um script do KQL para criar uma tabela e seu mapeamento de ingestão.

    // 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':''}]"

Conteúdo relacionado