Partilhar via

Formato do código-fonte de integração Git

Os itens no Microsoft Fabric são armazenados em uma pasta. A pasta que contém o item pode estar no diretório raiz ou em um subdiretório. Quando conectares a tua área de trabalho ao git, liga-te à pasta que contém os itens. Cada item na pasta é representado em seu próprio subdiretório.

Nome do diretório

Quando você salva um novo item no Git, a integração do Git cria automaticamente um diretório para esse item.

O nome do diretório do item é baseado nas seguintes regras:

  • O padrão para o nome é {display name}.{public facing type}.
  • Se necessário, as seguintes alterações no nome para exibição são feitas:
    • Os caracteres inválidos são substituídos pelo número HTML.
    • O espaço inicial é substituído pelo seu número HTML.
    • O espaço ou ponto final é substituído pelo seu HTML number.
  • Se esse nome de pasta não estiver disponível, o nome do logicalID (GUID) do item será usado em vez do nome para exibição.

Por exemplo, se você tiver os seguintes itens em um espaço de trabalho (observe que o primeiro e o terceiro itens têm um espaço à esquerda e à direita invisível, respectivamente):

Captura de ecrã da lista de itens em um espaço de trabalho Fabric.

Os seguintes diretórios são criados no repositório Git:

Captura de tela dos nomes dos diretórios do Git que contêm os itens de malha.

  • Uma vez criada, a integração do Git nunca altera o nome de um diretório. Mesmo se você alterar o nome do item, o nome do diretório permanecerá o mesmo.
  • Se você alterar manualmente o nome de um diretório de item, certifique-se de levar em conta as dependências do item. Por exemplo, se você alterar o diretório de um modelo semântico, atualize o caminho do modelo semântico no arquivo de dependência do relatório. Lembre-se de que os locais de dependência variam entre diferentes experiências do Fabric. Alterar o nome do diretório não causa alterações no espaço de trabalho.

Conteúdo do diretório

Cada diretório de item contém os arquivos de definição de item e arquivos de sistema gerados automaticamente.

Arquivos de definição de item

O diretório de cada item tem arquivos específicos e necessários que definem esse item.

Os seguintes itens são atualmente suportados no Microsoft Fabric:

Bancos de dados espelhados

As pastas de banco de dados espelhado contêm um arquivo .json que define o banco de dados espelhado.

Para obter instruções sobre como usar a integração do Git com bancos de dados espelhados, consulte CI/CD para bancos de dados espelhados.

Ficheiros do caderno

As pastas do bloco de notas contêm um ficheiro .py :

Para obter instruções sobre como usar a integração do Git com notebooks, consulte Controle de versão e implantação de notebooks.

Arquivos de relatório paginados

As pastas de relatório paginadas contêm um arquivo .rdl que define o relatório paginado. RDL (Report Definition Language) é uma representação XML de uma definição de relatório paginada.

Para obter mais informações sobre RDL, consulte Report Definition Language (RDL). Para obter instruções sobre como usar a integração do Git com relatórios paginados, consulte Integração do Git com relatórios paginados.

Ficheiros de relatório

As pastas de relatório contêm os seguintes ficheiros:

  • definição.pbir
  • report.json

Para obter mais informações sobre pastas de relatório e uma lista completa de seu conteúdo, consulte Pasta de relatório de projeto do Power BI Desktop.

Arquivos de modelo semântico

As pastas de modelo semântico contêm os seguintes ficheiros:

  • definição.pbism
  • \definition pasta com arquivos TMDL

Para obter mais informações sobre pastas de modelo semântico e uma lista completa de seu conteúdo, consulte Pasta de modelo semântico de projeto do Power BI Desktop.

Arquivos de sistema gerados automaticamente

Além dos arquivos de definição de item, cada diretório de item contém um ou dois arquivos de sistema gerados automaticamente, dependendo da versão que você está usando:

  • Um diretório versão 1 contém item.metadata.json e item.config.json. Com V1, ambos os arquivos devem estar no diretório.
  • Um diretório versão 2 contém .platform. Este ficheiro inclui o conteúdo dos ficheiros item.metadata.json e item.config.json. Se tiver este ficheiro, não poderá ter os outros dois ficheiros. Se estiver a utilizar a versão 1 e confirmar alterações, os ficheiros de sistema serão automaticamente atualizados para esta versão.

Nota

Seu diretório deve conter os item.metadata.json arquivos e item.config.json ou o .platform arquivo. Não é possível ter os três ficheiros.

Arquivo da plataforma

Na versão 2, em vez de ter dois arquivos de origem em cada diretório de item, o arquivo .platform combina todas as informações em um arquivo junto com uma propriedade $schema . Se tiver este ficheiro, não poderá ter os outros dois ficheiros.

{
    "version": "2.0",
    "$schema": https://developer.microsoft.com/json-schemas/fabric/platform/platformProperties.json,
    "config": {
        "logicalId": "e553e3b0-0260-4141-a42a-70a24872f88d"
    },
    "metadata": {
        "type": "Report",
        "displayName": "All visual types",
        "description": "This is a report"
    }
}

O .platform arquivo contém os seguintes atributos:

  • version: Número da versão dos ficheiros de sistema. Esse número é usado para habilitar a compatibilidade com versões anteriores. O número da versão do item pode ser diferente.
  • logicalId: (string) Um identificador de espaço de trabalho cruzado gerado automaticamente que representa um item e sua representação de controle do código-fonte.
  • type: (string) O tipo do item (modelo semântico, relatório, etc.)
  • displayName: (string) O nome do item.
  • description: (string opcional) Descrição do item.

Se renomeares o artefato no espaço de trabalho e a pasta do artefato no Git tiver um sufixo '.', então, após a confirmação, o nome do diretório no Git corresponderá.

O logicalId conecta um item na área de trabalho com o seu item correspondente numa ramificação do Git. Itens com os mesmos logicalIds são assumidos como sendo os mesmos. O logicalId preserva o link mesmo se o nome ou o diretório forem alterados. Como uma ramificação pode ser sincronizada com vários espaços de trabalho, é possível ter itens em espaços de trabalho diferentes com o mesmo logicalId, mas um único espaço de trabalho não pode ter dois itens com o mesmo logicalId. O logicalId é criado quando o espaço de trabalho é conectado a uma ramificação do Git ou um novo item é sincronizado. O logicalId é necessário para que a integração do Git funcione corretamente. Por isso, é essencial não alterá-lo de forma alguma.

Nota

Quando você confirma alterações no Git na versão 1, os arquivos do sistema são atualizados automaticamente para a versão 2 junto com as alterações. Além disso, todos os novos arquivos exportados do modo de desenvolvedor do Power BI Desktop serão salvos no formato de arquivo da versão 2.

Nota

  • O campo "type" é sensível a maiúsculas e minúsculas. Não altere a forma como é gerado automaticamente ou poderá falhar.
  • Embora você geralmente não deva alterar o logicalId ou o nome de exibição de um item, uma exceção pode ser se você estiver criando um novo item copiando um diretório de item existente. Nesse caso, precisas alterar o logicalId e o nome de exibição para algo único no repositório.

Conteúdos relacionados

Comece a usar a integração com o Git.

  • Last updated on