Формат исходного кода интеграции Git

  • Статья

Элементы в Microsoft Fabric хранятся в папке. Папка, содержащая элемент, может находиться в корневом каталоге или подкаталоге. При подключении рабочей области к Git подключитесь к папке, содержащей элементы. Каждый элемент в папке представлен в отдельном подкаталоге. Эти каталоги элементов имеют то же имя, что и элемент, за которым следует тип элемента.

Снимок экрана: каталог Git, содержащий элементы.

Внимание

Эта функция доступна в предварительной версии.

Каждый каталог элементов содержит файлы определения элементов и один или два автоматически созданных системных файлов.

Файлы определения элементов

В каталоге каждого элемента есть определенные обязательные файлы, определяющие этот элемент.

В настоящее время в Microsoft Fabric поддерживаются следующие элементы:

Файлы записной книжки

Папки записной книжки содержат файл .py :

Снимок экрана: дерево каталогов с файлами в каталоге записной книжки.

Инструкции по использованию интеграции Git с записными книжками см. в статье "Управление версиями и развертывание записной книжки".

Файлы отчетов с разбивкой на страницы

Папки отчетов с разбивкой на страницы содержат RDL-файл , определяющий отчет с разбивкой на страницы. RDL (язык определения отчета) — это XML-представление определения отчета с разбивкой на страницы.

Дополнительные сведения о языке RDL см. в разделе "Язык определения отчетов" (RDL). Инструкции по использованию интеграции Git с отчетами с разбивкой на страницы см. в статье интеграции Git с отчетами с разбивкой на страницы.

Файлы отчетов

Папки отчетов содержат следующие файлы:

  • definition.pbir
  • report.json

Снимок экрана: дерево каталогов с файлами в каталоге отчета.

Дополнительные сведения о папках отчетов и полном списке их содержимого см . в папке отчета проекта Power BI Desktop.

Файлы семантической модели

Папки семантической модели содержат следующие файлы:

  • definition.pbidataset
  • model.bim file (формат TMSL) OR \definition folder (формат TMDL)

Дополнительные сведения о папках семантической модели и полном списке их содержимого см . в папке семантической модели проекта Power BI Desktop.

Автоматически созданные системные файлы

Помимо файлов определения элемента каждый каталог элементов содержит один или два автоматически созданных системных файлов в зависимости от используемой версии:

  • Каталог версии 1 содержит item.metadata.json и item.config.json. При использовании версии 1 оба файла должны находиться в каталоге.
  • Каталог версии 2 содержит платформу. Этот файл содержит содержимое как item.metadata.json, так и item.config.json файлов. Если у вас этот файл, у вас нет других двух файлов. Если вы используете версию 1 и фиксируете изменения, системные файлы автоматически обновляются до этой версии.

Примечание.

Каталог должен содержать файлы item.metadata.json или .platformitem.config.json файлы. У вас нет всех трех файлов.

Файл платформы

В версии 2 вместо двух исходных файлов в каждом каталоге элементов файл платформы объединяет все сведения в один файл вместе с свойством $schema . Если у вас этот файл, у вас нет других двух файлов.

{
    "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"
    }
}

Файл .platform содержит следующие атрибуты:

  • version: номер версии системных файлов. Это число используется для обеспечения обратной совместимости. Номер версии элемента может отличаться.
  • logicalId: автоматически созданный идентификатор между рабочими областями, представляющий элемент и его представление системы управления версиями.
  • type: (строка) Тип элемента (семантическая модель, отчет и т. д.)
  • displayName: (строка) Имя элемента.
  • description: (необязательная строка) Описание элемента.

Примечание.

  • Поле типа учитывает регистр. Не изменяйте способ автоматического создания или сбой.
  • Хотя обычно не следует изменять логический идентификатор или отображаемое имя элемента, одно исключение может быть в том случае, если вы создаете новый элемент путем копирования существующего каталога элементов. В этом случае необходимо изменить логический идентификатор и отображаемое имя на что-то уникальное в репозитории.

Связанный контент

Начало работы с интеграцией Git.