Atualize a versão do arquivo do sistema de um depósito em um espaço de trabalho integrado com Fabric do Git

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

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

Important

Esse recurso está na versão prévia.

O Microsoft Fabric atualiza periodicamente a definição de item subjacente para os tipos de item, incluindo o depósito. Quando essa definição de item muda, o config.version valor no arquivo do .platform item é deslocado, por exemplo, de 1.0 para 2.0. Para evitar quebrar as mudanças existentes do seu depósito, o Fabric não aplica essa atualização automaticamente. Em vez disso, o Fabric mostra um aviso de atualização disponível nocontrole de versão e permite que você escolha quando aplicar a atualização para um tipo específico de item, como armazenamento.

Captura de tela do portal Fabric do banner de atualização do sistema disponível no painel de controle de versão.

Pré-requisitos

Identifique que uma atualização de arquivo do sistema está disponível

O config.version valor e a $schema URL contêm a versão atual do arquivo do sistema para um depósito.

  1. Vá até o seu espaço de trabalho conectado ao Git e selecione Controle de versão.

  2. Se uma atualização do sistema estiver 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 controle de versão.

    Você também pode confirmar a versão atual do arquivo do sistema para um armazém inspecionando a config.version propriedade no arquivo do .platform item no seu repositório Git. Por exemplo, o seguinte .platform arquivo para um depósito nomeado dw mostra uma versão do arquivo 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 arquivo, veja Arquivos de sistema gerados automaticamente.

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

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

Se você aplicar atualizações do sistema e fazer commit das suas próprias mudanças no warehouse, fica mais difícil separar os dois conjuntos de mudanças depois. Se você fizer o commit das mudanças existentes primeiro, a atualização do arquivo do sistema aparece como um commit isolado próprio. Essa separação facilita a revisão e, se necessário, reverter a atualização do sistema sem afetar suas próprias alterações.

  1. Vá para o controle de versão no espaço de trabalho do Fabric.
  2. Revise as mudanças pendentes na lista de Alterações .
  3. Selecione os itens que deseja comprometer, adicione uma mensagem de commit e faça commit das alterações no repositório Git.

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

Aplicar atualizações do sistema

Depois de comprometer suas alterações existentes, aplique a atualização do sistema.

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

    Captura de tela do portal Fabric mostrando a notificação de progresso Aplicando atualizações do sistema.

  2. O Fabric aplica a atualização do sistema a todos os depósitos desse tipo de item no espaço de trabalho. Se você tem vários armazéns, todos são atualizados ao mesmo tempo. Você não pode selecionar armazéns individuais para atualizar.

  3. Aguarde a notificação de Aplicando atualizações do sistema ser concluída.

Revise e faça commit da atualização do sistema

Quando a atualização do sistema terminar de ser aplicada, revise as diferenças antes de commetê-las.

  1. No controle de versão, vá para a lista de Mudanças. Cada depósito atualizado aparece como uma alteração pendente.

  2. Selecione um depósito e, em seguida, selecione Revisar e confirmar alterações para comparar a definição mais recente do item com sua versão atual. Você pode comparar o .sqlproj arquivo e outros arquivos do sistema para ver exatamente o que mudou, como uma versão atualizada Sdk .

    Tire uma captura de tela do portal Fabric da Review e faça commit de diálogo de alterações comparando a versão atual do workspace com a última versão sincronizada.

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

Se você tem vários armazéns no espaço de trabalho, todos mostram a mesma atualização do sistema. Revise e comprometa cada depósito da mesma forma, seja individualmente ou juntos, para garantir que cada depósito seja atualizado para a versão mais recente.

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

Para um histórico e notas de lançamento do histórico de versões do arquivo do sistema, veja Notas de lançamento para Fabric Data Warehouse arquivo do sistema.

Conteúdo relacionado

  • Last updated on