Папка семантической модели проекта Power BI Desktop
Внимание
Проекты Power BI Desktop в настоящее время находятся в предварительной версии.
В этой статье описываются файлы и вложенные папки в папке семантической модели проекта Microsoft Power BI Desktop. Файлы и вложенные папки представлены семантической моделью Power BI. В зависимости от проекта папка семантической модели может включать:
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. В этом случае он открывает отчет, подключенный к модели со всем определением, но без данных. Если кэш.abf существует, Power BI Desktop загружает данные и перезаписывает определение модели с содержимым в model.bim.
PBI\unappliedChanges.json
Power BI Desktop позволяет сохранять изменения, внесенные в редактор данных преобразования (Power Query), без первого применения этих изменений к модели данных.
При нажатии кнопки "Применить" изменения, не примененные изменения сохраняются в файле unappliedChanges.json. Если ожидающие изменения находятся в файле unappliedChanges, Power BI Desktop предложит применить или отменить ожидающие изменения:
Если выбрать "Применить изменения", Power BI Desktop перезаписывает запросы в model.bim с помощью запросов из unappliedChanges.json. Если вы редактировали запросы в model.bim за пределами Power BI Desktop и есть предыдущий файл unappliedChanges.json, изменения будут потеряны и заменены запросами в unappliedChanges.json при применении этих изменений.
Файл unappliedChanges.json автоматически включается в определение семантической модели и сохраняется в Git по умолчанию. Это позволяет зафиксировать текущую работу в ветви разработки, выступая в качестве резервной копии и делая ее доступной другим участникам команды. Однако этот файл можно исключить из отслеживания Git, предотвращая незавершенную работу запроса, влияющую на других разработчиков.
Дополнительные сведения см. в документе схемы unappliedChanges.json.
definition.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)Database для модели проекта.
diagramLayout.json
Содержит метаданные схемы, определяющие структуру семантической модели, связанной с отчетом. Во время предварительной версии этот файл не поддерживает внешнее редактирование.
платформе.
Файл платформы Fabric, содержащий свойства, жизненно важные для установления и поддержания соединения между элементами Fabric и Git.
Дополнительные сведения см. в статье об интеграции Git с автоматически созданными системными файлами.
Формат 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 следующим образом:
Откройте PBIP в Power BI Desktop.
Убедитесь, что функция предварительной версии включена.
Сохраните проект. Появится запрос на обновление до TMDL.
Выберите Обновить.
Внимание
После обновления до 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 выдает ошибку при открытии с расположением ошибки:
Рекомендации и ограничения TMDL
В общедоступной предварительной версии интеграция Git Fabric по-прежнему экспортирует семантику модели с помощью TMSL по умолчанию. Однако если семантическая модель импортируется в Fabric с помощью интеграции Fabric с форматом TMDL, интеграция TMDL будет использовать формат TMDL для экспорта определения семантической модели в Git, если в службе есть какие-либо изменения семантической модели.
Внимание
При импорте семантической модели с помощью любого другого метода импорта, например публикации Power BI Desktop, интеграция Fabric Git вернется к формату TMSL по умолчанию.