Поделиться через

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

  • Статья

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

Имя каталога

При сохранении нового элемента в Git интеграция Git автоматически создает каталог для этого элемента.

Имя каталога элементов основано на следующих правилах:

  • Шаблон имени {display name}.{public facing type}.
  • При необходимости вносятся следующие изменения в отображаемое имя:
    • Недопустимые символы заменяются html-номером.
    • Ведущее пространство заменяется его HTML-номером.
    • Конечный пробел или точка заменяются его HTML-номером.
  • Если это имя папки недоступно, вместо отображаемого имени используется имя логического ИДЕНТИФИКАТОРа элемента (GUID).

Например, если у вас есть следующие элементы в рабочей области (обратите внимание, что первые и третие элементы имеют невидимое начальное и конечное пространство соответственно):

Снимок экрана: список элементов в рабочей области Fabric.

В репозитории Git создаются следующие каталоги:

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

  • После создания интеграция Git никогда не изменяет имя каталога. Даже если изменить имя элемента, имя каталога остается неизменным.
  • Если вы вручную измените имя каталога элементов, обязательно учитывайте зависимости элемента. Например, если изменить каталог семантической модели, необходимо обновить путь к семантической модели в файле зависимостей отчета. Имейте в виду, что расположения зависимостей зависят от различных интерфейсов Fabric. Изменение имени каталога не приводит к входящего изменения в рабочей области.

Содержимое каталога

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

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

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

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

Зеркальные базы данных

Зеркальные папки базы данных содержат файл .json, определяющий зеркальную базу данных.

Инструкции по использованию интеграции Git с зеркальными базами данных см. раздел CI/CD для зеркальных баз данных.

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

Папки записной книжки содержат файл .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 или item.config.json.platform У вас нет всех трех файлов.

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

В версии 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.