Папка семантической модели проекта Power BI Desktop

В этой статье описываются файлы и вложенные папки в папке семантической модели проекта Microsoft Power BI Desktop. Файлы и вложенные папки представлены семантической моделью Power BI. В зависимости от проекта папка семантической модели может включать:

• PBI\
  • localSettings.json
  • editorSettings.json
  • cache.abf
  • unappliedChanges.json
• папка DAXQueries\
• Папка TMDLScripts\
• определение\ папка³
• model.bim²
• diagramLayout.json
• .платформа
• definition.pbism¹

1 . Этот файл является обязательным.
2 . Этот файл требуется при сохранении с помощью формата TMSL.
3 . Этот файл требуется при сохранении с помощью формата TMDL.

Не каждая папка семантической модели проекта содержит все файлы и вложенные папки, описанные здесь.

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

PBI\localSettings.json

Содержит параметры семантической модели, которые применяются только для текущего пользователя и компьютера. Он должен быть включен в `.gitignore` или другие файлы исключений системы контроля версий. По умолчанию Git игнорирует этот файл.

Дополнительные сведения см. в документе схемы localSettings.json.

.pbi\editorSettings.json

Содержит параметры редактора семантических моделей, сохраненные в рамках определения семантической модели для использования для пользователей и сред.

Дополнительные сведения см. в документе схемы editorSettings.json.

.pbi\cache.abf

Файл резервного копирования служб Analysis Services (ABF), содержащий локальную кэшированную копию модели и данных на момент последнего редактирования. Он должен быть включен в `.gitignore` или другие файлы исключений системы контроля версий. По умолчанию Git игнорирует этот файл.

Power BI Desktop может открыть проект без файла cache.abf. В этом случае он открывает отчет, подключенный к модели со всем определением, но без данных. Если существует cache.abf, Power BI Desktop загружает данные и перезаписывает определение модели метаданными семантической модели в проекте.

.pbi\unappliedChanges.json

Power BI Desktop позволяет сохранять изменения, внесенные в редактор данных преобразования (Power Query), без первого применения этих изменений к модели данных.

При выборе "Применить позже" несохраненные изменения сохраняются в файле unappliedChanges.json. Если ожидающие изменения находятся в файле unappliedChanges, Power BI Desktop предложит применить или отменить ожидающие изменения:

Если выбрать "Применить изменения", Power BI Desktop перезаписывает запросы в метаданных семантической модели с помощью запросов из unappliedChanges.json. Если вы редактировали запросы за пределами Power BI Desktop и есть предыдущий файл unappliedChanges.json, изменения будут потеряны и заменены запросами в unappliedChanges.json при применении этих изменений.

Файл unappliedChanges.json автоматически включается в определение семантической модели и сохраняется в Git по умолчанию. Это позволяет зафиксировать текущую работу в ветке разработки, таким образом это служит резервной копией и делает её доступной другим членам команды. Однако этот файл можно исключить из отслеживания Git, чтобы незавершенные запросы не влияли на других разработчиков.

Дополнительные сведения см. в документе схемы unappliedChanges.json.

определение.pbism

Содержит общее определение семантической модели и основных параметров.

Этот файл также задает поддерживаемые форматы определения семантической модели с помощью свойства "version".

Версия	Поддерживаемые форматы
1.0	Определение семантической модели должно храниться как TMSL в файле model.bim.
версии 4.0 или более поздней	Определение семантической модели может храниться как TMSL (файл model.bim) или TMDL (папка определения).

Для получения дополнительной информации см. документ схемы definition.pbism.

model.bim

Этот файл доступен только в том случае, если проект Power BI сохраняется с помощью формата TMSL. Он содержит определение объекта базы данных языка скриптов табличной модели (TMSL) для модели проекта.

папка definition\

Эта папка доступна только в том случае, если проект Power BI сохраняется с помощью формата TMDL. Он заменяет файл model.bim .

Эта папка содержит определение объекта базы данных языка определения табличной модели (TMDL)модели проекта.

diagramLayout.json

Содержит метаданные схемы, определяющие структуру семантической модели, связанной с отчетом. Этот файл нельзя редактировать вне себя.

платформа

Файл платформы Fabric, содержащий свойства, жизненно важные для установления и поддержания соединения между элементами Fabric и Git.

Дополнительные сведения см. в статье об интеграции Git с автоматически созданными системными файлами.

Папка DAXQueries\

Содержит файл для каждой вкладки запросов DAX, сохраненной [Tab name].dax в виде DAX-файла.

.pbi\daxQueries.json

Содержит параметры редактора представления запросов DAX, такие как defaultTab или порядок вкладок.

Папка TMDLScripts\

Содержит файл для каждой вкладки скрипта представления TMDL , сохраненной [Tab name].tmdl в виде файла TMDL.

.PBI\tmdlscripts.json

Содержит параметры редактора TMDL представления, такие как defaultTab или порядок вкладок.

Формат TMDL

С целью повышения качества управления версиями и совместного разработки вы можете сохранить файлы проекта Power BI (PBIP) с помощью языка определения табличной модели (TMDL) в качестве формата файла семантической модели.

В отличие от языка скриптов табличной модели (TMSL), TMDL был разработан с нуля, чтобы быть понятным для человека, упрощая не только удобочитаемость , но и простое редактирование в любом текстовом редакторе. Это представляет собой существенное улучшение возможностей управления версиями и совместной разработки.

Вместо большого файла JSON, как в языке сценариев табличных моделей (TMSL), TMDL использует структуру папок с отдельными файлами для каждой таблицы, перспективы, роли и культуры. Это упрощает работу с другими пользователями, а также понимание структуры семантической модели, просто глядя на папку и файлы. В конечном счете это приводит к отличному контролю версий и совместной разработке при работе с git diff и конфликтами слияния.

Дополнительные сведения о TMDL см. здесь.

Внесение внешних изменений в файлы TMDL

Файлы TMDL можно редактировать в Visual Studio Code или другом внешнем средстве, пока проект остается открытым в Power BI Desktop. Чтобы улучшить редактирование TMDL, установите расширение TMDL для Visual Studio Code.

Перед редактированием файлов во внешнем режиме сохраните все изменения в Power BI Desktop. Откройте папку PBIP в VS Code, перейдите в папку семантической модели definition и сохраните изменения TMDL. Power BI Desktop обнаруживает сохраненные изменения и отображает баннер "Применить внешние изменения". Выберите "Применить внешние изменения " для перезагрузки семантической модели без закрытия и повторного открытия проекта.

Если Power BI Desktop имеет несохраненные изменения, оно предупреждает о том, что применение внешних изменений перезаписывает их. Полный рабочий процесс и ограничения см. в разделе "Изменение PBIP-файлов за пределами Power BI Desktop".

Поддерживаемые операции записи за пределами Power BI Desktop см. в разделе "Разработка моделей".

Ошибки TMDL

Если изменение TMDL недопустимо, Power BI Desktop отображает ошибку при применении внешних изменений или открытии проекта. Ошибка определяет расположение, которое необходимо исправить, прежде чем Power BI Desktop может загрузить обновленную семантику модели:

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

• Папка отчета проекта Power BI Desktop
• Проекты Power BI Desktop
• Язык сценариев табличной модели (TMSL)