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

Внимание

Проекты 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

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

Перейдите в раздел Файл > Параметры и настройки > Параметры > Функции предварительного просмотра и установите флажок рядом с Сохранить семантическую модель в формате TMDL.

Сохранение в качестве проекта с помощью TMDL

Если включена функция предварительной версии TMDL, при сохранении проекта семантическая модель сохраняется в виде папки TMDL с именем \definition внутри папки семантической модели:

Дополнительные сведения о структуре папок TMDL.

Преобразование существующего PBIP в TMDL

Если у вас уже есть PBIP с помощью TMSL в качестве формата семантической модели, его можно преобразовать в TMDL следующим образом:

1. Откройте PBIP в Power BI Desktop.

2. Убедитесь, что функция предварительной версии включена.

3. Сохраните проект. Появится запрос на обновление до TMDL.

4. Выберите Обновить.

   Внимание

   После обновления до TMDL невозможно вернуться к TMSL. Если вы считаете, что вам может потребоваться вернуться к TMSL, сначала сохраните копию PBIP-файлов.

   

Существующий файл языка сценариев табличной модели (TMSL) (model.bim) заменяется папкой \definition , содержащей представление TMDL для семантической модели.

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

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

Чтобы улучшить чтение и редактирование файлов TMDL, установите расширение TMDL — Visual Studio Marketplace Microsoft VS Code.

Откройте папку PBIP с помощью VS Code и перейдите к папке определения семантической модели.

Power BI Desktop не знает об изменениях в файлах проекта, сделанных другими средствами. Поэтому при внесении изменений в открытые файлы за пределами Power BI Desktop необходимо перезапустить, чтобы эти изменения отображались в Power BI Desktop.

См здесь сведения о поддерживаемых операциях записи за пределами Power BI Desktop.

Ошибки TMDL

Если какие-либо недопустимые изменения вносятся в файлы TMDL, Power BI Desktop выдает ошибку при открытии с расположением ошибки:

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

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