Compartilhar via

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

  • Artigo

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. Ao conectar seu workspace ao git, conecte-se à 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 item no Git, a integração do Git cria automaticamente um diretório para esse item.

O nome do diretório do item é <item name>.<item type> seguido pelo tipo de item. Se esse nome não estiver disponível, o nome do ID lógico (GUID) do item será usado seguido pelo tipo de item.

Captura de tela do diretório do Git contendo itens.

  • 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, certifique-se de atualizar 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 os tipos de carga de trabalho.

Conteúdo do diretório

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

Arquivos de definição de item

O diretório de cada item contém arquivos obrigatórios específicos que definem esse item.

No momento, os itens a seguir têm suporte no Microsoft Fabric:

Arquivos do Notebook

As pastas do Notebook contêm um arquivo .py:

Captura de tela da árvore de diretórios mostrando os arquivos no diretório do notebook.

Para obter instruções sobre como usar a integração do Git com notebooks, consulte Controle do código-fonte do Notebook e de implantação.

Arquivos de relatório paginados

As pastas de relatório paginados contêm um arquivo .rdl que define o relatório paginado. A RDL (linguagem RDL) é uma representação XML de uma definição de relatório paginado.

Para obter mais informações sobre a RDL, consulte RDL (linguagem 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.

Arquivos de relatório

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

  • definition.pbir
  • report.json

Captura de tela da árvore de diretórios mostrando os arquivos no diretório de relatórios.

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

Arquivos de modelo semântico

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

  • definition.pbidataset
  • Arquivo model.bim (formato TMSL) OU \pasta de definition (formato TMDL)

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

Arquivos de sistema geradas 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 de qual versão você está usando:

  • Um diretório versão 1 contém item.metadata.json e item.config.json. Com a V1, ambos os arquivos devem estar no diretório.
  • Um diretório versão 2 contém .platform. Esse arquivo inclui o conteúdo dos arquivos item.metadata.json e item.config.json. Caso tenha esse arquivo, não poderá ter os outros dois arquivos. Se você estiver usando a versão 1 e confirmar alterações, seus arquivos de sistema serão atualizados automaticamente para esta versão.

Observação

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

Arquivo de 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. Caso tenha esse arquivo, não poderá ter os outros dois arquivos.

{
    "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 arquivo .platform contém as colunas a seguir:

  • version: número de versão dos arquivos do sistema. Esse número é usado para habilitar a compatibilidade com versões anteriores. O número de versão do item pode ser diferente.
  • logicalId: um identificador entre espaços de trabalho gerado automaticamente representando um item e sua representação de controle da fonte.
  • type: (sequência) o tipo do item (modelo semântico, relatório, etc.)
  • displayName: (sequência) o nome do item.
  • description: (sequência opcional) a descrição do item.

Observação

  • O campo tipo diferencia maiúsculas de minúsculas. Não altere a forma como ele é gerado automaticamente. Caso contrário, a operação poderá falhar.
  • Embora você geralmente não deve alterar o logicalId ou nome de exibição de um item, uma exceção é possível, caso esteja criando um novo item copiando um diretório de item existente. Nesse caso, você precisará alterar o logicalId e o nome de exibição para algo exclusivo no repositório.

Conteúdo relacionado

Introdução à integração do Git.