Atualize a versão do ficheiro de sistema de um armazém num espaço de trabalho integrado Git com Fabric

Aplica-se a: ✅ Armazém no Microsoft Fabric

Este artigo descreve como atualizar os itens do armazém para a versão mais recente do ficheiro de sistema num espaço de trabalho integrado com Fabric Git.

Importante

Este recurso está em pré-visualização.

O Microsoft Fabric atualiza periodicamente a definição subjacente de itens para os tipos de itens, incluindo o armazém. Quando esta definição de item muda, o config.version valor no ficheiro do .platform item é desligado, por exemplo, de 1.0 para 2.0. Para evitar que as alterações existentes do seu armazém, o Fabric não aplica esta atualização automaticamente. Em vez disso, o Fabric mostra um aviso de disponibilidade de atualização do sistema no controlo de versões e permite-lhe escolher quando aplicar a atualização para um tipo específico de artigo, como armazém.

Captura de ecrã do portal Fabric do banner de atualização do Sistema disponível no painel de controlo de versão.

Pré-requisitos

Identificar que existe uma atualização de ficheiro do sistema disponível

O config.version valor e a $schema URL contêm a versão atual do ficheiro de sistema para um armazém.

  1. Vai ao teu espaço de trabalho ligado ao Git e seleciona Controlo de Versão.

  2. Se houver uma atualização do sistema disponível para o tipo de item do armazém, o Fabric mostra um banner de atualização disponível no topo do painel de controlo de versão.

    Também pode confirmar a versão atual do ficheiro do sistema para um armazém inspecionando a config.version propriedade no ficheiro do .platform item no seu repositório Git. Por exemplo, o ficheiro seguinte .platform para um armazém nomeado dw mostra uma versão do ficheiro de sistema de 2.0:

    {
    "$schema": "https://developer.microsoft.com/json-schemas/fabric/gitIntegration/platformProperties/2.0.0/schema.json",
    "metadata": {
        "type": "Warehouse",
        "displayName": "dw"
    },
    "config": {
        "version": "2.0",
        "logicalId": "5e477a9e-0e1a-bf9b-4eb8-33420d62f352"
    }
}

Para mais informações sobre o .platform ficheiro, consulte Ficheiros de sistema gerados automaticamente.

Comprometa as alterações existentes antes de aplicar atualizações de ficheiros do sistema

Antes de selecionar Aplicar atualizações do sistema, comprometa quaisquer alterações pendentes no seu espaço de trabalho.

Se aplicares atualizações do sistema e confirmares as tuas próprias alterações no armazém, torna-se mais difícil separar os dois conjuntos de alterações mais tarde. Se confirmares as alterações existentes primeiro, a atualização do ficheiro do sistema aparece como um commit isolado próprio. Esta separação facilita a revisão e, se necessário, reverter a atualização do sistema sem afetar as suas próprias alterações.

  1. Vai ao controlo de versões no espaço de trabalho do Fabric.
  2. Revise as alterações pendentes na lista de Alterações .
  3. Seleciona os itens que queres comprometer, adiciona uma mensagem de commit e confirma as alterações no repositório Git.

Para mais informações sobre como fazer commit de alterações, veja Fazer alterações e confirmar atualizações do warehouse no Git.

Aplicar atualizações do sistema

Depois de comprometeres as alterações existentes, aplica a atualização do sistema.

  1. No controlo de versão, selecione Aplicar atualizações do sistema.

    Captura de ecrã do portal Fabric a mostrar a notificação de progresso Aplicar atualizações do sistema.

  2. O Fabric aplica a atualização do sistema a todos os armazéns desse tipo de item no espaço de trabalho. Se tiveres vários armazéns, todos são atualizados ao mesmo tempo. Não podes selecionar armazéns individuais para atualizar.

  3. Aguarde que a notificação de atualizações do sistema de Candidatura seja concluída.

Revise e confirme a atualização do sistema

Quando a atualização do sistema terminar de ser aplicada, revê as diferenças antes de as comprometeres.

  1. No controlo de versão, vai à lista de Mudanças. Cada armazém atualizado aparece como uma alteração pendente.

  2. Selecione um armazém e depois selecione Rever e confirmar alterações para comparar a definição mais recente do item com a sua versão atual. Pode comparar o .sqlproj ficheiro e outros ficheiros do sistema para ver exatamente o que mudou, como uma versão atualizada Sdk .

    Captura de ecrã do portal Fabric da Revisão e o diálogo de commit de alterações comparando a versão atual do workspace com a última versão sincronizada.

  3. Depois de confirmar que as alterações são esperadas, selecione os itens do armazém, adicione uma mensagem de commit e selecione Commit para confirmar a atualização do sistema no repositório Git.

Se tiveres vários armazéns no espaço de trabalho, todos mostram a mesma atualização do sistema. Revise e comprometa cada armazém da mesma forma, individualmente ou em conjunto, para garantir que cada armazém está atualizado para a versão mais recente.

Histórico de atualizações do sistema do armazém

Para um histórico e notas de versão do ficheiro de sistema, consulte Notas de lançamento para Fabric Data Warehouse ficheiro de sistema.

Conteúdo relacionado

  • Last updated on