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

PostgreSQL

Сводка

Элемент Описание
Статус релиза Общая доступность
Продукция Эксель
Power BI (семантические модели)
Power BI (потоки данных)
Fabric (Dataflow 2-го поколения)
Power Apps (потоки данных)
Dynamics 365 Customer Insights
Сервисы анализа
Поддерживаемые типы проверки подлинности База данных (имя пользователя и пароль)
Учетная запись Майкрософт (Microsoft Entra ID)
Справочная документация по функциям PostgreSQL.Database

Заметка

Некоторые возможности могут присутствовать в одном продукте, но не другие из-за расписаний развертывания и возможностей для конкретного узла.

Необходимые условия

Power BI Desktop включает поставщика Npgsql для соединителя PostgreSQL с декабря 2019 года, устраняя необходимость в дополнительных установках. Начиная с версии за октябрь 2024 г., она включает Npgsql версии 4.0.17. Отдельная установка GAC Npgsql переопределяет эту версию по умолчанию.

Соединитель PostgreSQL поддерживается для облачного подключения и через шлюз данных виртуальной сети или локальный шлюз данных. С момента выпуска июня 2025 г. локальный шлюз данных включает поставщика Npgsql, поэтому дополнительная установка не требуется. Отдельная установка GAC Npgsql переопределяет эту версию по умолчанию.

Для версий Power BI Desktop, выпущенных до декабря 2019 года, и локального шлюза данных, выпущенного до июня 2025 года, необходимо установить провайдер Npgsql на вашем локальном компьютере, чтобы использовать соединитель PostgreSQL. Чтобы установить поставщика Npgsql, перейдите на страницу выпусков версии 4.0.17, скачайте и запустите файл .msi. Архитектура поставщика (32-разрядная или 64-разрядная) должна соответствовать архитектуре продукта, в котором планируется использовать соединитель. При установке убедитесь, что вы выбрали установку GAC Npgsql, чтобы убедиться, что на компьютер добавляется Npgsql. Npgsql 4.1 и up не поддерживаются из-за несовместимости версии .NET.

Снимок экрана: установщик Npgsql с выбранным параметром

Поддерживаемые возможности

  • Импорт
  • DirectQuery (семантические модели Power BI)
  • Дополнительные параметры
    • Время ожидания команды в минутах
    • Инструкция на языке SQL
    • Столбцы связей
    • Навигация с помощью полной иерархии

Подключение к базе данных PostgreSQL из Power Query Desktop

После установки соответствующего поставщика Npgsql можно подключиться к базе данных PostgreSQL. Чтобы сделать подключение, выполните следующие действия.

  1. Выберите опцию базы данных PostgreSQL в меню выбора соединителя. Дополнительные сведения см. в Где получить данные.

  2. В появившемся диалоговом окне базы данных PostgreSQL укажите имя сервера и базы данных.

    Screenshot построителя подключений PostgreSQL в Power BI.

  3. Выберите режим подключения данных Импорт или DirectQuery.

  4. Если вы впервые подключаетесь к этой базе данных, выберите тип проверки подлинности, который вы хотите использовать, и введите свои учетные данные. Доступны следующие типы проверки подлинности:

    • База данных (имя пользователя и пароль)
    • Учетная запись Майкрософт (Microsoft Entra ID)

    Дополнительные сведения о проверке подлинности см. в аутентификации с помощью источника данных.

    Снимок экрана: диалоговое окно проверки подлинности, в котором введите имя пользователя и пароль PostgreSQL.

  5. Если подключение не зашифровано, появится запрос со следующим сообщением.

    Screenshot диалогового окна поддержки шифрования базы данных Azure SQL.

    Нажмите кнопку "ОК ", чтобы подключиться к базе данных с помощью незашифрованного подключения. Если требуется зашифрованное подключение, сервер PostgreSQL должен быть настроен для размещения SSL-подключений (перейдите в документацию по PostgreSQL для получения рекомендаций ). После завершения вашему компьютеру может понадобиться установить SSL-сертификат сервера PostgreSQL в Доверенные корневые удостоверяющие центры.

  6. В Navigator выберите нужные сведения базы данных, а затем выберите Load для загрузки данных или Transform Data для продолжения преобразования данных в редакторе Power Query.

    Скриншот настольной навигационной панели Power Query, показывающий данные сотрудников отдела кадров в базе данных PostgreSQL.

Подключение к базе данных PostgreSQL из Power Query Online

Чтобы сделать подключение, выполните следующие действия.

  1. Выберите опцию базы данных PostgreSQL в меню выбора соединителя. Дополнительные сведения см. в Где получить данные.

  2. В появившемся диалоговом окне базы данных PostgreSQL укажите имя сервера и базы данных.

    Снимок экрана построителя подключений PostgreSQL в Power Query Online.

  3. Выберите имя локального шлюза данных, который вы хотите использовать.

  4. Выберите тип проверки подлинности Базовый и введите учетные данные PostgreSQL в поля Имя пользователя и Пароль.

  5. Если подключение не зашифровано, снимите флажок Использовать Зашифрованное Подключение.

  6. Выберите Далее, чтобы подключиться к базе данных.

  7. В Navigator выберите необходимые данные, а затем выберите Трансформ данных для преобразования данных в редакторе Power Query.

Подключитесь с помощью дополнительных параметров

Power Query Desktop предоставляет набор дополнительных параметров, которые можно добавить в запрос при необходимости.

Снимок экрана: дополнительные параметры, включенные в диалоговое окно подключения PostgreSQL.

В следующей таблице перечислены все дополнительные параметры, которые можно задать в Power Query Desktop.

Расширенный параметр Описание
Время ожидания команды в минутах Если подключение длится дольше 10 минут (время ожидания по умолчанию), можно ввести другое значение в минутах, чтобы сохранить подключение открытым дольше. Этот параметр доступен только в Power Query Desktop.
Инструкция SQL Для получения информации перейдите к Импорт данных из базы с использованием собственных запросов.
Включите столбцы связей Если установлен флажок, содержит столбцы, которые могут иметь связи с другими таблицами. Если это поле снято, эти столбцы не отображаются.
Навигация с помощью полной иерархии Если установлен флажок, навигатор отображает полную иерархию таблиц в базе данных, к которому вы подключаетесь. При очистке навигатор отображает только таблицы, столбцы и строки которых содержат данные.

Выбрав необходимые дополнительные параметры, выберите OK в Power Query Desktop для подключения к базе данных PostgreSQL.

Свертывание нативных запросов

По умолчанию включено свертывание родных запросов. Операции, способные к складыванию, применяются поверх собственного запроса в соответствии с общепринятой логикой импорта или прямого запроса. Свертывание Native Query не применяется, если присутствуют необязательные параметры в Value.NativeQuery.

В редких случаях, когда собственная свёртка запросов с включенной функцией не работает, её можно отключить. Чтобы отключить свертку исходных запросов, установите EnableFolding параметр false для Value.NativeQuery в расширенном редакторе.

Пример: Value.NativeQuery(target as any, query, null, [EnableFolding=false])

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

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

We cannot fold on top of this native query. Please modify the native query or remove the 'EnableFolding' option.

Основной этап устранения неполадок — проверить, вызывает ли запрос в Value.NativeQuery ту же ошибку с предложением limit 1 вокруг него:

select * from (query) _ limit 1

  • Last updated on