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


PostgreSQL

Сводка

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

Заметка

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

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

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

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

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

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

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

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

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

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

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

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

    Снимок экрана: построитель подключений PostgreSQL в Power BI.

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

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

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

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

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

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

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

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

  6. В навигаторе выберите нужные сведения базы данных, а затем выберите "Загрузить ", чтобы загрузить данные или преобразовать данные, чтобы продолжить преобразование данных в редакторе Power Query.

    Снимок экрана: навигатор Power Query Desktop с данными сотрудников отдела кадров в базе данных PostgreSQL.

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

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

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

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

    построитель подключений PostgreSQL в Power Query Online.

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

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

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

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

  7. В навигаторе выберите необходимые данные, а затем выберите "Преобразовать данные ", чтобы преобразовать данные в редакторе Power Query.

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

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

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

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

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

Выбрав необходимые дополнительные параметры, нажмите кнопку "ОК " в 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