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

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

  • Статья

Итоги

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

Примечание.

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

Необходимые компоненты

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

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

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

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

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

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

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

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

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

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

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

  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). Дополнительные сведения: где получить данные

    Снимок экрана: диалоговое окно выбора источника данных с выделенным соединителем 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.

Дополнительный параметр Description
Использование 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 Значением по умолчанию для идентификатора пула рабочей силы является powerquery-<TenantId>идентификатор клиента TenantId>, который <является текущим идентификатором <> клиента 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 (Идентификатор 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 приводит к ошибке "Недопустимый запрос" или визуальной ошибке.

Включение единого входа Microsoft Entra ID для Google BigQuery

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

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

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

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

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

  2. Включите параметр единого входа Google BigQuery.

    Снимок экрана: параметр единого входа 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.

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

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

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

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