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 novo item no Git, a integração do Git cria automaticamente um diretório para ele.

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

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

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

Captura de tela da lista de itens em um workspace do Fabric.

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

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

  • 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 as diferentes experiências do Fabric. Alterar o nome do diretório não causa uma alteração no workspace.

Conteúdo do diretório

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

Arquivos de definição de item

O diretório de cada item tem arquivos específicos que são necessários para definir o 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:

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. 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.json ou 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.