Запустить сценарий 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.You can download Python from the Python website. В текущем выпуске скриптов Python поддерживаются символы Юникода и пробелы в пути установки.The current Python scripting release supports Unicode characters and spaces in the installation path.

Установка необходимых пакетов PythonInstall required Python packages

Для интеграции Power BI с Python требуется установить два пакета Python:The Power BI Python integration requires the installation of two Python packages:

  • Pandas.Pandas. Библиотека программного обеспечения для обработки и анализа данных.A software library for data manipulation and analysis. В ней предоставляются структуры данных и операции для управления числовыми таблицами и временными рядами.It offers data structures and operations for manipulating numerical tables and time series. Импортированные данные должны находиться в кадре данных pandas.Your imported data must be in a pandas data frame. Кадр данных представляет собой двухмерную структуру данных.A data frame is a two-dimensional data structure. Например, данные могут быть организованы в табличном виде в строках и столбцах.For example, data is aligned in a tabular fashion in rows and columns.
  • Matplotlib.Matplotlib. Библиотека построения для Python и его числового математического расширения NumPy.A plotting library for Python and its numerical mathematics extension NumPy. В ней предоставляется объектно-ориентированный API для внедрения графиков в приложения с использованием универсальных наборов средств графического пользовательского интерфейса, таких как Tkinter, wxPython, Qt, GTK+ и другие.It provides an object-oriented API for embedding plots into applications using general-purpose GUI toolkits, such as Tkinter, wxPython, Qt, or GTK+.

В консоли или оболочке используйте для установки этих двух пакетов программу командной строки pip.In a console or shell, use the pip command-line tool to install the two packages. Средство pip входит в состав последних версий Python.The pip tool is packaged with more recent Python versions.

pip install pandas
pip install matplotlib

Включение скриптов PythonEnable Python scripting

Включение скриптов Python:To enable Python scripting:

  1. В Power BI Desktop последовательно выберите Файл > Параметры и настройки > Параметры > Создание скриптов Python.In Power BI Desktop, select File > Options and settings > Options > Python scripting. Откроется страница Параметры скриптов Python.The Python script options page appears.

    Параметры скриптов Python для Power BI Desktop

  2. При необходимости укажите локальный путь установки Python в разделе Обнаруженные домашние каталоги Python.If necessary, specify your local Python installation path in Detected Python home directories.

    На приведенном выше рисунке используется следующий локальный путь установки Python: C:\Python.In the above image, the Python's installation local path is C:\Python. Путь должен соответствовать расположению каталога с локальной установленной версией Python, которая будет использоваться службой Power BI Desktop.Make sure the path is for the local Python installation you want Power BI Desktop to use.

  3. Выберите ОК.Select OK.

После указания установленной версии Python все готово к выполнению скриптов Python в Power BI Desktop.Once you specify your Python installation, you’re ready to begin running Python scripts in Power BI Desktop.

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

Для запуска скриптов Python и создания модели данных достаточно выполнить несколько шагов.In just a few steps, you can run Python scripts and create a data model. На основе этой модели можно создавать отчеты и передавать их в службу Power BI для общего доступа.From this model, you can create reports and share them on the Power BI service.

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

Создайте скрипт в локальной среде разработки Python и убедитесь, что он выполняется успешно.First, create a script in your local Python development environment and make sure it runs successfully. Ниже приводится пример простого скрипта Python, который импортирует pandas и использует кадр данных:For example, here's a simple Python script that imports pandas and uses a data frame:

import pandas as pd
data = [['Alex',10],['Bob',12],['Clarke',13]]
df = pd.DataFrame(data,columns=['Name','Age'],dtype=float)
print (df)

При запуске этот скрипт возвращает:When run, this script returns:

     Name   Age
0    Alex  10.0
1     Bob  12.0
2  Clarke  13.0

При подготовке и выполнении сценариев 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 are currently not supported

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

Выполнение скрипта Python в Power BI Desktop:To run your Python Script in Power BI Desktop:

  1. На вкладке ленты "Главная" выберите Получить данные > Другое.In the Home ribbon, select Get Data > Other.

  2. Выберите Другое > Скрипт Python, как показано на следующем рисунке:Select Other > Python script as shown in the following image:

    Выбор "Получение данных" и скрипта Python

  3. Нажмите кнопку Подключиться.Select Connect. В качестве подсистемы Python выбирается локальная самая новая установленная версия Python.Your local latest installed Python version is selected as your Python engine. Скопируйте скрипт в появляющееся диалоговое окно Скрипт Python.Copy your script into the Python script dialog box that appears. Здесь мы вводим простой скрипт Python, показанный ранее.Here, we enter the simple Python script shown before.

    Пример скрипта Python

  4. Выберите ОК.Select OK. Если скрипт успешно выполняется, появляется окно Навигатор, в котором вы можете загрузить и использовать данные.If the script runs successfully, the Navigator appears and you can load the data and use it. Например, установите флажок df, как показано на следующем рисунке, после чего выберите Загрузить.For the example, select df, as shown in the image, then Load.

    Окно "Навигатор", в котором отображаются данные для загрузки и использования

Устранение неполадокTroubleshooting

Если средство Python не установлено или не определено, отображается предупреждение.If Python isn't installed or identified, a warning displays. Кроме того, может отображаться предупреждение о наличии нескольких установленных версий на локальном компьютере.You can also see a warning if you have multiple local machine installations. Снова ознакомьтесь с ранее приведенными разделами "Установка Python" и "Включение скриптов Python".Revisit and review the previous Install Python and Enable Python scripting sections.

Предупреждение о том, что Python не установлен

Использование пользовательских дистрибутивов PythonUsing custom Python distributions

Power BI выполняет скрипты напрямую с помощью исполняемого файла python.exe из каталога, указанного пользователем на странице параметров.Power BI executes scripts directly by using the python.exe executable from a user-provided directory (provided through the settings page). Выполнение дистрибутивов, требующих дополнительного шага для подготовки среды (например, Conda), может завершаться сбоем.Distributions that require an extra step to prepare the environment (for example, Conda) might encounter an issue where their execution fails.

Во избежание таких проблем мы рекомендуем использовать официальный дистрибутив Python с сайта https://www.python.org/.We recommend using the official Python distribution from https://www.python.org/ to avoid related issues.

В качестве возможного решения вы можете запустить Power BI Desktop из командной строки пользовательской среды Python.As a possible solution, you can start Power BI Desktop from your custom Python environment prompt.

ОбновитьRefresh

Вы можете обновить сценарий Python в Power BI Desktop.You can refresh a Python script in Power BI Desktop. Чтобы выполнить обновление, перейдите на вкладку ленты Главная и выберите Обновить.To refresh, go to the Home ribbon and select Refresh. При обновлении скрипта Python служба Power BI Desktop запускает его повторно.When you refresh a Python script, Power BI Desktop runs the Python script again.

Известные ограниченияKnown Limitations

В настоящий момент вы не можете использовать скрипты Python в отчетах, созданных при включенной функции Расширенные метаданные (предварительная версия) .Currently you won't be able to use Python scripts in reports created with Enhanced Metadata (Preview) feature enabled. Это не повлияет на работоспособность имеющихся отчетов.Existing reports will continue to work. Дополнительные сведения см. в статье Использование расширенных метаданных набора данных (предварительная версия).For more information check out Using enhanced dataset metadata (preview).

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

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