Google BigQuery (Идентификатор Microsoft Entra)

Итоги

Элемент Описание
Состояние релиза Общая доступность
Поддерживаемые продукты Power BI (семантические модели)
Power BI (потоки данных)
Fabric (Dataflow 2-го поколения)
Power Apps (потоки данных)
Поддерживаемые типы проверки подлинности Учетная запись организации

Примечание.

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

Примечание.

С июля 2025 года мы представили новую реализацию для соединителя Google BigQuery (Microsoft Entra ID), который в настоящее время доступен в предварительной версии. Дополнительные сведения о этой функции.

Предварительные условия

Для входа в Google BigQuery требуется учетная запись Microsoft Entra ID (Microsoft Entra ID).

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

  • Импорт
  • DirectQuery (семантические модели Power BI)

Подключитесь к данным Google BigQuery (Microsoft Entra ID) из Power Query Desktop

Чтобы подключиться к Google BigQuery (идентификатор Microsoft Entra ID) из Power Query Desktop, сделайте следующее:

  1. В разделе «Получение данных» найдите и выберите Google BigQuery (Microsoft Entra ID). Дополнительные сведения: где получить данные

    Снимок экрана: диалоговое окно получения данных с акцентом на соединитель Google BigQuery (Идентификатор Microsoft Entra ID).

  2. Укажите идентификатор проекта выставления счетов, который требуется для использования этого соединителя. Если вы хотите использовать дополнительные параметры, выберите дополнительные параметры. В противном случае выберите "Импорт" или "DirectQuery", а затем нажмите кнопку "ОК", чтобы продолжить. Дополнительные сведения: подключение с помощью дополнительных параметров

    Скриншот диалогового окна Google BigQuery (Microsoft Entra ID), где вы вводите идентификатор своего проекта выставления счетов, выбираете

  3. Соединитель Google BigQuery (Microsoft Entra ID) поддерживает подключение через учетную запись Microsoft Entra ID. Нажмите кнопку "Войти" , чтобы продолжить.

    Снимок экрана: диалоговое окно проверки подлинности, указывающее, что вы не вошли в систему.

  4. После входа нажмите кнопку "Подключиться ", чтобы продолжить.

    Снимок экрана: диалоговое окно проверки подлинности после входа.

  5. После успешного подключения откроется окно навигатора и отображает данные, доступные на сервере. Выберите данные в навигаторе. Затем выберите преобразование данных в Power Query или Load , чтобы загрузить данные в Power BI Desktop.

Подключение к данным Google BigQuery (Идентификатор Microsoft Entra) из Power Query Online

Чтобы подключиться к Google BigQuery, используя Microsoft Entra ID, из Power Query Online, выполните следующие шаги:

  1. В разделе "Получение данных" найдите Google и выберите Google BigQuery (Microsoft Entra ID). Дополнительные сведения: где получить данные

    Снимок экрана диалогового окна выбора источника данных с подсвеченным коннектором Google BigQuery (Microsoft Entra ID).

  2. В диалоговом окне Google BigQuery (Идентификатор Microsoft Entra) может потребоваться создать новое подключение или выбрать существующее подключение. Если вы создаете новое подключение, введите идентификатор проекта выставления счетов. Если вы используете локальные данные, выберите локальный шлюз данных.

    Снимок экрана: диалоговое окно

  3. Если вы хотите использовать дополнительные параметры, выберите дополнительные параметры. Дополнительные сведения: подключение с помощью дополнительных параметров

  4. После входа нажмите кнопку "Далее ", чтобы продолжить.

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

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

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

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

Дополнительный параметр Описание
Использование API хранилища Флаг, позволяющий использовать API хранилища Google BigQuery. Этот параметр по умолчанию имеет значение true. Этот параметр может иметь значение false, чтобы не использовать API хранилища и использовать REST API.
Длительность времени ожидания подключения Стандартный параметр подключения (в секундах), который определяет, сколько времени Power Query ожидает завершения подключения. Это значение можно изменить, если подключение не завершится до 15 секунд (значение по умолчанию).
Длительность таймаута команды Сколько времени Power Query ожидает завершения и возврата результатов запроса. Значение по умолчанию зависит от драйвера по умолчанию. Вы можете ввести другое значение в минутах, чтобы сохранить подключение открытым дольше.
URI аудитории URI, содержащий <идентификатор> пула рабочей силы, который необходимо изменить на имя пула рабочей силы, используемый при настройке конфигурации OIDC. Формат значения URI аудитории — это //iam.googleapis.com/locations/global/workforcePools/<workforce pool ID>/providers/azuread. Значением по умолчанию для идентификатора пула рабочей силы является <, где > это текущий идентификатор вашего клиента Power BI. При обновлении URI аудитории строка, которую вы вводите, будет использоваться как есть.
ProjectID Проект, на который требуется выполнить собственные запросы. Этот параметр доступен только в Power Query Desktop.
Собственный запрос Дополнительные сведения см. в статье Импорта данных из базы данных с помощью собственного запроса к базе данных. В этой версии функций собственных запросов к базе данных необходимо использовать полные имена таблиц в формате Database.Schema.Table, например SELECT * FROM DEMO_DB.PUBLIC.DEMO_TABLE. Этот параметр доступен только в Power Query Desktop.

Выбрав необходимые дополнительные параметры, нажмите кнопку "ОК " в Power Query Desktop или "Далее " в Power Query Online, чтобы подключиться к данным Google BigQuery.

Новая реализация соединителя Google BigQuery (предварительная версия)

С июля 2025 года мы представили новую реализацию соединителя Google BigQuery (Microsoft Entra ID) для улучшения интеграции с Google BigQuery, в настоящее время доступной в предварительной версии. Он использует подключение к базе данных со стрелками (ADBC) вместо ODBC для подключения к данным и получения данных из Google BigQuery, что повышает производительность, особенно для больших результирующих наборов. По мере того как мы продолжаем улучшать и добавлять новые возможности в этот соединитель, мы рекомендуем вам обновить до последней версии, чтобы попробовать ее и предоставить нам отзыв.

Примечание.

Эта функция поддерживается в 64-разрядной версии Power BI Desktop и не работает в 32-разрядной версии.

Чтобы получить доступ к этой функции в Power BI Desktop, перейдите в Параметры и настройки (на вкладке "Файл"), затем >, и установите флажок, чтобы включить опцию Использовать новую реализацию соединителя Google BigQuery. После включения параметра все только что созданные подключения автоматически используют новую реализацию соединителя.

Существующие подключения остаются неизменными. Вы можете попробовать эту функцию, добавив флаг Implementation="2.0" в запросы GoogleBigQueryAad.Database, как показано ниже. Это свойство отличает версию используемого соединителя.

Чтобы получить доступ к этой функции в Dataflow Gen2, после настройки получения данных из Google BigQuery, перейдите в расширенный редактор на верхней панели и добавьте флаг Implementation="2.0" в ваши GoogleBigQueryAad.Database запросы следующим образом, чтобы использовать этот новый соединитель.

Source = GoogleBigQueryAad.Database([Implementation = "2.0"])

Примечание.

При использовании локального шлюза данных обратите внимание, что минимальная поддерживаемая версия — июль 2025 г. Рекомендуется использовать последнюю версию для оценки этой функции с наиболее актуальными возможностями.

Чтобы облегчить диагностику любой потенциальной проблемы, вы можете найти Implementation, обозначенный как "2.0", и DriverType, обозначенный как ADBC, в ваших журналах Mashup.

В настоящее время этот соединитель имеет следующие известные ограничения:

  • Отношения не поддерживаются.
  • Прокси-сервер не поддерживается.

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

В этом разделе описаны ограничения и вопросы, которые следует учитывать для коннектора Google BigQuery (Идентификатор Microsoft Entra ID).

Конфигурации OIDC

Соединитель Google BigQuery (Microsoft Entra ID) использует токены JWT Microsoft Entra ID для подключения аутентификации, основанной на идентификаторе Microsoft, с функцией федерации рабочей силы Google. Таким образом, настройка на стороне проверки подлинности должна быть на основе OIDC, чтобы соответствовать токенам JWT идентификатора Microsoft Entra ID. Обратитесь к вашей точке контакта Google BigQuery, чтобы получить дополнительные сведения о настройке проверки подлинности и поддержке на стороне Google.

Подключение к Google BigQuery (идентификатор Microsoft Entra) в Power BI Desktop

При использовании соединителя Google BigQuery с Power BI следует учитывать несколько ограничений и рекомендаций.

вложенные поля

Для оптимизации производительности Google BigQuery хорошо справляется с большими наборами данных, когда они денормализованы, плоские и структурированы в виде вложенных конструкций.

Соединитель Google BigQuery (Microsoft Entra ID) поддерживает вложенные поля, которые загружаются в виде текстовых столбцов в формате JSON.

Снимок экрана: поддержка вложенных полей Google BigQuery.

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

  1. На вкладке "Преобразования" в категории "Текстовый столбец" выберите "Разбор" и затем "JSON".
  2. Извлеките поля записи JSON с помощью параметра "Развернуть столбец ".

Не удается выполнить проверку подлинности с помощью API хранилища Google BigQuery

Соединитель Google BigQuery (Microsoft Entra ID) использует API хранилища Google BigQuery по умолчанию. Эта функция управляется расширенным параметром UseStorageApi. Если вы используете детализированные разрешения, могут возникнуть проблемы с этой функцией. В этом сценарии может появиться следующее сообщение об ошибке или сбой получения данных из запроса:

ERROR [HY000] [Microsoft][BigQuery] (131) Unable to authenticate with Google BigQuery Storage API. Check your account permissions

Эту проблему можно устранить, правильно изменив разрешения пользователя для API хранилища BigQuery. Эти разрешения API хранилища необходимы для правильного доступа к данным с ПОМОЩЬЮ API BigQueryStorage:

  • bigquery.readsessions.create: создает новый сеанс чтения с помощью API хранилища BigQuery.
  • bigquery.readsessions.getData: считывает данные из сеанса чтения через API хранилища BigQuery.
  • bigquery.readsessions.update: обновляет сеанс чтения с помощью API хранилища BigQuery.

Эти разрешения обычно предоставляются в BigQuery.User роли. Дополнительные сведения о предопределенных ролях и разрешениях Google BigQuery

Если описанные выше действия не устраняют проблему, можно отключить API хранилища BigQuery.

Не удается использовать данные типа DateTime в режиме DirectQuery

Существует известная проблема, из-за которой тип DateTime не поддерживается через DirectQuery. Выбор столбца с типом DateTime приводит к ошибке "Недопустимый запрос" или визуальной ошибке.

Включение функции одноэтапной аутентификации (SSO) Microsoft Entra ID для Google BigQuery

Мы поддерживаем единый вход Microsoft Entra ID через службу Power BI (облако), а также через локальный шлюз данных. Дополнительные сведения о включении единого входа Microsoft Entra ID для всех соединителей см. в статье "Обзор единого входа" для локальных шлюзов данных в Power BI. Убедитесь у вашего контакта в Google, что ваша система и учетные записи настроены правильно для единого входа в Microsoft Entra ID, прежде чем пытаться выполнять подключение в Power BI.

Единый вход (SSO) Microsoft Entra ID через службу Power BI

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

  1. В службе Power BI выберите Портал администратора из списка параметров.

    Снимок экрана: открытое меню параметров с выделенным порталом администрирования.

  2. Включите опцию Google BigQuery SSO.

    Снимок экрана: опция единого входа Google BigQuery с включенной кнопкой

Единый вход Microsoft Entra ID для Google BigQuery с локальным шлюзом данных

Прежде чем включить единый вход Microsoft Entra ID для Google BigQuery, сначала необходимо включить единый вход Microsoft Entra ID для всех источников данных, поддерживающих единый вход Microsoft Entra ID с локальным шлюзом данных. По крайней мере убедитесь, что вы обновили локально установленного шлюза данных до версии от декабря 2022 года.

  1. В службе Power BI выберите Портал администратора из списка параметров.

    Другой снимок экрана меню

  2. В разделе "Параметры интеграции" включите единый вход Azure AD для шлюза.

После включения единого входа Microsoft Entra ID для всех источников данных включите единый вход Microsoft Entra ID для Google BigQuery:

  1. Включите опцию Google BigQuery SSO.

  2. Выберите "Управление шлюзами " из списка параметров.

    Снимок экрана: меню

  3. Выберите шлюз и выберите команду "Выбрать источник данных".

  4. На вкладке "Параметры источника данных" введите значение в идентификаторе проекта выставления счетов. Параметр идентификатора проекта выставления счетов требуется при использовании идентификатора Microsoft Entra и должен быть указан в дополнительных параметрах. Кроме того, выберите Использовать единый вход через Azure AD для запросов DirectQuery.