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

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

Внимание

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

Совет

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

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

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

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

  • Прозрачность структуры папок — отдельные папки для семантической модели и отчета, обеспечивая мощные и простые задачи, такие как копирование таблиц семантической модели между проектами или повторное использование страниц отчетов. Отличный выбор для создания и повторного создания шаблонов разработки.

  • Готово к управлению версиями — текстовые файлы открытого типа, предназначенные для простой интеграции с Git, включая историю версий и совместную работу команды. Дополнительные сведения см. в разделе "Управление версиями" в Git.

  • Поддержка непрерывной интеграции и непрерывной доставки (CI/CD) — применяйте методики CI/CD на основе существующих систем управления исходным кодом с помощью PBIP-файлов, включая шлюзы качества и автоматизацию развертывания в производственные среды. Дополнительные сведения о CI/CD в Fabric см. в рабочих процессах CI/CD Fabric.

  • программного создания и редактирования определений элементов. Вы можете программно создавать и изменять текстовые файлы определения элементов, что позволяет выполнять пакетные операции, такие как обновление всех визуальных элементов страниц отчетов или добавление набора мер в каждую таблицу. Для семантических моделей можно использовать табличную объектную модель (TOM) как клиентскую библиотеку для десериализации метаданных семантической модели, внесения программных изменений и сериализации их обратно в файлы.

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

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

Перейдите в > и > установите флажок "Сохранить" рядом с параметром> сохранения проекта Power BI (PBIP).

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

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

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

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

Project/
├── AdventureWorks.Report/
├── AdventureWorks.SemanticModel/
├── .gitignore
└── AdventureWorks.pbip

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

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

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

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

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

.gitIgnore

Указывает намеренно неуправляемые файлы Git следует игнорировать для файлов Проекта Power BI, таких как cache.abf и localSettings.json.

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

Содержимое .gitignore по умолчанию при сохранении в виде PBIP:

**/.pbi/localSettings.json
**/.pbi/cache.abf
<имя> проекта.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/
│   └── definition.pbism
├── .gitignore
└── AdventureWorks.pbip

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

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

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

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

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

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

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

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

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

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

Развертывание в рабочей области Fabric

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

  • Используйте интеграцию Fabric Git .
  • Используйте API-интерфейсы Fabric.
  • Используйте параметр публикации Power BI Desktop.

Заметка

Публикация в Power BI Desktop осуществляется через временный PBIX-файл, который публикуется в сервисе, аналогично сохранению и публикации PBIX-файла. В отличие от других параметров развертывания PBIP, которые развертывают только метаданные, этот метод публикации развертывает метаданные и локальный кэш данных редактируемой семантической модели.

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

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

  • Путем подключения к экземпляру службы анализа Power BI Desktop (AS) с внешними инструментами.
  • Изменяя метаданные TMDL в папке /definition с помощью VS Code или другого внешнего средства.

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

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

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

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

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

  • Семантические модели, такие как составные модели или Direct Lake , могут включать объекты и свойства, полученные из других моделей или источников данных. При настройке этих свойств или удалении синхронизированных объектов Power BI требует, чтобы свойство changedProperties и аннотация PBI_RemovedChildren были установлены. Эти индикаторы помечают изменения как пользовательские настройки, обеспечивая их сохранение во время следующей синхронизации схемы с источником данных. Дополнительные сведения см. в разделе "Теги происхождения" для семантических моделей Power BI.

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

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

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

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

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

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

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

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

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

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

Ответ. 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 в Службах 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, расположенный в папке отчета.

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

  • Last updated on