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

Проекты Power BI Desktop (предварительная версия)

  • Статья

Внимание

Проекты Power BI Desktop в настоящее время находятся в предварительной версии.

Совет

Инструкции по планированию разработки Power BI см. в статье о планировании реализации Power BI.

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

Сохранение работы в качестве проекта имеет следующие преимущества:

  • Поддержка текстового редактора— файлы определения элементов — это текстовые файлы JSON, содержащие семантические модели и метаданные отчета. Они публично документированы и доступны для чтения. Хотя файлы проекта поддерживают простые средства редактирования текста, такие как Блокнот, лучше использовать редактор кода, например Visual Studio Code (VS Code), который обеспечивает широкий интерфейс редактирования, включая intellisense, проверку и интеграцию Git.

  • Определения элементов программного создания и редактирования. Вы можете создавать скрипты с помощью популярных и простых для использования языка сценариев табличных моделей (TMSL) или создавать собственные пользовательские приложения для внесения изменений в определения элементов. Приложения могут основываться на общедоступной документации по схемам определения элементов и (или) клиентским библиотекам.

  • Управление версиями — семантическая модель Power BI и определения элементов отчета могут храниться в системе управления версиями, например Git. С помощью Git можно отслеживать журнал версий, сравнивать редакции (дифф) и возвращаться к предыдущим версиям. Управление версиями также может разблокировать совместную работу при использовании Power BI Desktop с помощью знакомых механизмов совместной работы для разрешения конфликтов (слияния) и просмотра изменений (запросов на вытягивание). Дополнительные сведения см. в разделе "Управление версиями" в Git.

  • Непрерывная интеграция и непрерывная доставка (CI/CD) — вы можете использовать системы, в которых разработчики в организации могут отправить предлагаемое изменение в систему CI/CD. Затем система проверяет изменение с помощью ряда шлюзов качества перед применением изменения к рабочей системе. Эти шлюзы качества могут включать проверки кода другими разработчиками, автоматизированным тестированием и автоматической сборкой для проверки целостности изменений. Системы CI/CD обычно основаны на существующих системах управления версиями. Дополнительные сведения см. в статье DevOps — непрерывная интеграция и DevOps — непрерывная доставка.

Видео

Ознакомьтесь с проектами Power BI Desktop и другими функциями режима разработчика, представленными в Microsoft Build 2023.

Включить функции из предварительной версии

Сохранение в качестве проекта в Power BI Desktop в настоящее время находится в предварительной версии. Чтобы использовать эту функцию, требуется лицензия Premuim и ее необходимо включить в предварительных версиях.

Чтобы включить, в параметрах и параметрах>> предварительной версии файлов>Power BI Desktop> установите флажок для сохранения проекта Power BI (PBIP).

Сохранение в качестве проекта

Если вы работаете над новым проектом или открыли существующий файл Power BI Desktop (pbix), вы можете сохранить работу в качестве файла проекта Power BI (pbip):

Снимок экрана, показывающий сохранение файла в качестве проекта Power BI

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

Снимок экрана с файлами проекта Power BI

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

Снимок экрана, показывающий название Power BI Desktop при сохранении в проекте.

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

Снимок экрана, показывающий всплывающее меню заголовка Power BI Desktop.

Давайте рассмотрим, что вы видите в корневой папке проекта:

<имя> проекта. SemanticModel

Коллекция файлов и папок, представляющих семантику Power BI. Дополнительные сведения о файлах и вложенных папках и файлах см . в папке "Семантика проекта".

<имя> проекта. Сообщать

Коллекция файлов и папок, представляющих отчет Power BI. Дополнительные сведения о файлах и вложенных папках и файлах см . в папке отчета Project.

.gitIgnore

Указывает намеренно неуправляемые файлы Git должны игнорироваться. Power BI Desktop создает файл .gitignore в корневой папке при сохранении, если он еще не существует.

Семантическая модель и вложенные папки отчетов имеют файлы, игнорируемые по умолчанию в .gitIgnore:

├── project
│   ├── *.SemanticModel
│   │   ├── .pbi
│   │   │   ├── localSettings.json
│   │   │   └── cache.abf
│   ├── *.Report
│   │   ├── .pbi
│   │   │   └── localSettings.json
<имя> проекта.pbip

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

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

Открытие проекта Power BI

Вы можете открыть Power BI Desktop из папки Проекта Power BI, открыв PBIP-файл или PBIR-файл в папке отчета. Оба параметра открывают отчет для редактирования и семантической модели, если есть относительная ссылка на семантику модели.

Вы можете сохранить несколько отчетов и семантических моделей в одну папку. Наличие отдельного PBIP-файла для каждого отчета не требуется, так как вы можете открыть каждый отчет непосредственно из PBIR в папке отчета.

├── project
│   ├── AdventureWorks-Sales.Report
│   │   └── definition.pbir
│   ├── AdventureWorks-Stocks.Report
│   │   └── definition.pbir
│   ├── AdventureWorks.SemanticModel
|   |   └── *.*
│   .gitignore
└──  AdventureWorks.pbip

Изменения за пределами Power BI Desktop

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

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

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

Снимок экрана, в который не удается открыть ошибку файла.

Сведения о схеме для следующих файлов не документируются. Во время предварительной версии изменения этих файлов за пределами Power BI Desktop не поддерживаются:

Разработка моделей

Вы можете внести изменения в определение семантической модели с помощью внешних средств двумя способами:

  • Путем подключения к экземпляру службы анализа Power BI Desktop (AS) с внешними инструментами.
  • Редактирование метаданных JSON в файле model.bim с помощью VS Code или другого внешнего средства.

Не каждый объект модели поддерживает операции записи. Применение изменений за пределами поддерживаемых может привести к непредвиденным результатам.

Объекты, поддерживающие операции записи:

Object Подключение к экземпляру AS Изменение файла
Таблицы No Да
Столбцы Да 1, 2 Да
вычисляемые таблицы; Да Да
Вычисляемые столбцы Да Да
Иерархии Да Да
Связи Да Да
Показатели Да Да
Ключевые показатели эффективности модели Да Да
Группы расчета Да Да
Точки зрения Да Да
Переводы Да Да
Безопасность на уровне строк (RLS) Да Да
Безопасность на уровне объектов (OLS) Да Да
Заметки Да Да
Выражения M No Да 3, 4

Помните о следующем:

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

  • Power BI Desktop не поддерживает таблицы с несколькими секциями. Поддерживается только одна секция для каждой таблицы. Создание таблиц с пустыми секциями или несколькими секциями приводит к ошибке при открытии отчета.

  • Автоматические таблицы дат, созданные Power BI Desktop, не должны изменяться с помощью внешних средств.

  • При изменении модели, которая использует прямой запрос для подключения к семантической модели Power BI или модели Служб Analysis Services, необходимо обновить коллекцию ChangedProperties и PBI_RemovedChildren для измененного объекта, чтобы включить любые измененные или удаленные свойства. Если изменены изменения и(или) PBI_RemovedChildren не обновлены, Power BI Desktop может перезаписать любые изменения при следующем изменении запроса или обновлении модели в Power BI Desktop.

  • 1 . Изменение типа данных столбца поддерживается. Однако переименование столбцов не поддерживается при подключении к экземпляру AS.

  • 2 . Если семантическая модель включена функция автоматической даты и времени и создается новый столбец datetime за пределами Power BI Desktop, локальная таблица дат не создается автоматически.

  • 3. Тип источника секции должен быть вычисляемым, M, Entity или CalculationGroup. Режим секции должен быть импортом, DirectQuery или двойным.

  • 4 . Любые изменения выражений за пределами Power BI Desktop в проекте с unappliedChanges.json теряются при применении этих изменений.

  • Изменение выражений запросов таблицы за пределами Power BI Desktop приводит к удалению данных таблицы при перезапуске Power BI Desktop.

Схемы JSON-файлов

Большинство файлов проекта содержат метаданные в формате JSON. Соответствующие схемы JSON можно использовать для проверки и документации.

С помощью схем JSON можно:

  • Узнайте о настраиваемых свойствах.
  • Используйте встроенную проверку JSON, предоставляемую редактором кода.
  • Улучшение разработки с выделением синтаксиса, подсказками и автозавершением.
  • Используйте внешние средства с знаниями о поддерживаемых свойствах в метаданных проекта.

Используйте VS Code для сопоставления схем JSON с созданными файлами. Схемы JSON для файлов проекта предоставляются в репозитории Git для Power BI Desktop.

Рекомендации и ограничения

  • Power BI Desktop не знает об изменениях, внесенных с другими инструментами или приложениями. Изменения, внесенные с помощью внешних средств, требуют перезапуска Power BI Desktop до отображения этих изменений.
  • Метки конфиденциальности не поддерживаются в проектах Power BI.
  • Представление схемы игнорируется при редактировании моделей в службе.
  • При сохранении в качестве проекта Power BI максимальная длина пути к файлам проекта составляет 260 символов.
  • В Power BI Desktop нельзя сохранить как PBIP непосредственно в OneDrive и SharePoint.
  • При редактировании PBIP-файлов за пределами Power BI Desktop их следует сохранять с помощью UTF-8 без кодирования BOM.
  • Схема лингвистики отчетов не поддерживается в проектах Power BI.
  • Power BI Desktop использует CRLF в качестве конца строки. Чтобы избежать проблем в диффах, настройте Git для обработки конец строки, включив автокркльф.
  • Проекты Power BI в настоящее время не поддерживаются в версии Microsoft Power BI Desktop, оптимизированной для Сервер отчетов Power BI.

Часто задаваемые вопросы

Вопрос. Просмотр определений семантической модели и папок элемента отчета помечаются как необходимые, что происходит, если удалить их?

Ответ. Power BI Desktop автоматически создает их при сохранении в виде проекта (PBIP).

Вопрос. Учитывает ли Power BI Desktop изменения, внесенные в файлы проекта Power BI из внешнего средства или приложения?

Ответ: Нет. Любые изменения, внесенные в файлы, требуют перезапуска Power BI Desktop для отражения этих изменений.

Вопрос. Если я преобразую PBIX в PBIP, можно ли преобразовать его обратно в PBIX?

Ответ: Да. Можно сохранить PBIX в виде PBIP или сохранить PBIP в виде PBIX.

Вопрос. Можно ли преобразовать PBIX в PBIP и наоборот программно?

Ответ: Нет. Вы можете преобразовать PBIX только в PBIP и наоборот, используя сохранение файлов>Power BI Desktop как.

Вопрос. Можно ли развернуть проект Power BI Desktop в Службах Azure Analysis Services (AAS) или службах SQL Server Analysis Services (SSAS)?

Ответ: Нет. Определения отчетов о проекте Power BI Desktop не поддерживаются в AAS и SSAS. Определения моделей используют расширенные метаданные, уникальные для Power BI. Для проектов AAS и SSAS используйте Microsoft Visual Studio для разработки моделей, интеграции Git и Azure DevOps.

Вопрос. Почему файл *.pbip отсутствует при подключении рабочей области Fabric к Git? Как изменить отчет и семантику модели в Power BI Desktop?

Ответ. PBIP-файл является необязательным и просто служит ярлыком для папки отчета. Вы можете открыть отчет и семантику для редактирования в Power BI Desktop, открыв файл definition.pbir, расположенный в папке отчета.

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