Запустить сценарий Python в Power BI DesktopRun Python scripts in Power BI Desktop

Вы можете выполнять сценарий Python непосредственно в Power BI Desktop и импортировать полученные наборы данных в модели данных Power BI Desktop.You can run Python scripts directly in Power BI Desktop, and import the resulting datasets into a Power BI Desktop data model.

Установка PythonInstall Python

Для запуска сценариев Python в Power BI Desktop необходимо установить Python на локальном компьютере.To run Python scripts in Power BI Desktop, you need to install Python on your local machine. Вы можете скачать и установить Python бесплатно из различных расположений, включая официальную страницу скачивания Python и Anaconda.You can download and install Python for free from many locations, including the Official Python download page, and the Anaconda. В текущем выпуске сценариев Python в Power BI Desktop в пути установки поддерживаются символы Юникода, а также пробелы (пустые символы).The current release of Python scripting in Power BI Desktop supports Unicode characters as well as spaces (empty characters) in the installation path.

Запустить сценарии PythonRun Python scripts

С помощью всего нескольких действий в Power BI Desktop вы можете запустить сценарии Python и создать модель данных, из которой можно создавать отчеты и совместно использовать их в службе Power BI.With just a few steps in Power BI Desktop, you can run Python scripts and create a data model, from which you can create reports, and share them on the Power BI service.

Подготовка сценария PythonPrepare a Python script

Чтобы запустить сценарий Python в Power BI Desktop, создайте его в локальной среде разработки Python и убедитесь, что он выполняется успешно.To run a Python script in Power BI Desktop, create the script in your local Python development environment, and make sure it runs successfully.

Чтобы запустить сценарий в Power BI Desktop, убедитесь, что этот сценарий успешно выполняется в новой и неизмененной рабочей области.To run the script in Power BI Desktop, make sure the script runs successfully in a new and unmodified workspace. Это означает, что все пакеты и зависимости должны загружаться и выполняться явным образом.This means that all packages and dependencies must be explicitly loaded and run.

При подготовке и выполнении сценариев Python в Power BI Desktop действуют некоторые ограничения.When preparing and running a Python script in Power BI Desktop, there are a few limitations:

  • Импортируются только кадры данных pandas, поэтому убедитесь, что импортируемые в Power BI данные представлены в кадре.Only Pandas data frames are imported, so make sure the data you want to import to Power BI is represented in a data frame
  • Любой сценарий Python, который выполняется дольше 30 минут, завершается по истечении времени ожидания.Any Python script that runs longer than 30 minutes times out
  • Интерактивные вызовы в сценарии Python, например ожидание ввода данных пользователем, прерывают выполнение сценария.Interactive calls in the Python script, such as waiting for user input, halts the script’s execution
  • При настройке рабочего каталога в сценарии Python необходимо задать полный, а не относительный путь каталога.When setting the working directory within the Python script, you must define a full path to the working directory, rather than a relative path
  • Вложенные таблицы (таблицы в таблицах) на данный момент не поддерживаются.Nested tables (table of tables) are currently not supported

Выполнение сценария Python и импорт данныхRun your Python script and import data

  1. Соединитель данных сценария Python в Power BI Desktop находится в области Получить данные.In Power BI Desktop, the Python Script data connector is found in Get Data. Чтобы выполнить сценарий Python, выберите Получить данные > Подробнее, а затем выберите Другие > сценарий Python, как показано на следующем рисунке.To run your Python Script, select Get Data > More..., then select Other > Python script as shown in the following image:

  2. Если Python установлен на локальном компьютере, в качестве подсистемы Python выбирается самая новая установленная версия.If Python is installed on your local machine, the latest installed version is selected as your Python engine. Просто скопируйте сценарий в окне сценария и нажмите кнопку ОК.Simply copy your script into the script window and select OK.

  3. Если Python не установлен, не определен или если на локальном компьютере есть несколько установок, будет отображаться предупреждение.If Python is not installed, is not identified, or if there are multiple installations on your local machine, warning will be displayed.

    Параметры установки Python расположены централизованно в разделе "Создание скриптов Python" в диалоговом окне "Параметры".Python installation settings are centrally located in the Python Scripting section of the Options dialog. Чтобы указать параметры установки Python, выберите Файл > Параметры и настройки, а затем Параметры > Создание сценариев Python.To specify your Python installation settings, select File > Options and settings and then Options > Python scripting. Если доступно несколько установок Python, появится раскрывающееся меню для выбора используемой установки.If multiple installations of Python are available, a drop-down menu appears that allows you to select which installation to use. Можно также выбрать Другое и предоставить путь настройки.You can also select Other and give custom path.

  4. Нажмите кнопку ОК, чтобы выполнить сценарий Python.Select OK to run the Python Script. Если сценарий выполняется успешно, можно выбрать полученные кадры данных для добавления в модель Power BI.When the script runs successfully, you can then choose the resulting data frames to add to the Power BI model.

ОбновитьRefresh

Вы можете обновить сценарий Python в Power BI Desktop.You can refresh a Python script in Power BI Desktop. При обновлении сценария Python Power BI Desktop запускает его повторно в среде Power BI Desktop.When you refresh a Python script, Power BI Desktop runs the Python script again in the Power BI Desktop environment.

Дальнейшие действияNext steps

Ознакомьтесь с дополнительными материалами по Python в Power BI.Take a look at the following additional information about Python in Power BI.