Formato do código-fonte da integração do 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. 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. Esses diretórios de item têm o mesmo nome que o item seguido pelo tipo de item.

Importante

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

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 tem arquivos obrigatórios específicos que definem esse item.

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

• Notebook
• Relatório paginado
• Report
• Modelo semântico

Arquivos do Notebook

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

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

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. Ao usar 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.

Versão 2

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.

Versão 1

SE você estiver usando a versão 1, terá dois arquivos em cada diretório de item:

• item.metadata.json
• item.config.json

{ 
    "type": "report", 
    "displayName": "All visual types",
    "description": "This is a report"
} 

{ 
    version: "1.0", 
    logicalId: "e553e3b0-0260-4141-a42a-70a24872f88d", 
} 

Arquivo de metadados

{ 
    "type": "report", 
    "displayName": "All visual types",
    "description": "This is a report"
} 

O arquivo item.metadata.json contém os seguintes atributos:

• 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

Para renomear um item, altere o displayName no arquivo 'item.metadata.json'. Alterar o nome da pasta não altera o nome de exibição do item no espaço de trabalho.

Arquivo de configuração

{ 
    version: "1.0", 
    logicalId: "e553e3b0-0260-4141-a42a-70a24872f88d", 
} 

O arquivo item.config.json 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.

A logicalId conecta um item em um espaço de trabalho com seu item correspondente em uma ramificação do Git. Presume-se que os itens com as mesmas logicalIds sejam os mesmos. A logicalId preserva o link mesmo se o nome ou diretório for alterado. Como uma ramificação pode ser sincronizada com vários espaços de trabalhos, é possível ter itens em espaços de trabalho diferentes com a mesma logicalId, mas um único espaço de trabalho não pode ter dois itens com a mesma logicalId. A logicalId é criada quando o espaço de trabalho está conectado a uma ramificação do Git ou um novo item é sincronizado. A logicalId é necessária para que a integração do Git funcione corretamente. Portanto, é essencial não alterá-lo de forma alguma.

Observação

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 do desenvolvedor do Power BI Desktop serão salvos no formato de arquivo da versão 2.

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.