Partilhar via

Formato do código-fonte de integração 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. Quando você conectar seu espaço de trabalho 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 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 à esquerda é substituído pelo seu número HTML.
    • O espaço à direita ou ponto é substituído pelo seu número HTML.
  • 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 tela da lista de itens em um espaço de trabalho de malha.

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 uma alteração de entrada 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:

Arquivos do bloco de anotações

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

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

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.pbidataset
  • arquivo model.bim (formato TMSL) OU pasta \definition (formato 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: 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.

Nota

  • O campo de tipo diferencia maiúsculas de 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, você precisa alterar o logicalId e o nome de exibição para algo exclusivo no repositório.

Conteúdos relacionados

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