Google BigQuery (идентификатор Microsoft Entra ID) (бета-версия)

Статья
03/19/2024

Итоги

Позиция	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 ID) из Power Query Desktop

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

В интерфейсе получения данных найдите и выберите Google BigQuery (Идентификатор Microsoft Entra). Дополнительные сведения: где получить данные
Укажите идентификатор проекта выставления счетов, который требуется для использования этого соединителя. Если вы хотите использовать дополнительные параметры, выберите дополнительные параметры. В противном случае выберите "Импорт" или "DirectQuery", а затем нажмите кнопку "ОК", чтобы продолжить. Дополнительные сведения: Подключение с помощью дополнительных параметров
Соединитель Google BigQuery (Идентификатор Microsoft Entra ID) поддерживает подключение через учетную запись Идентификатора Microsoft Entra. Нажмите кнопку "Войти" , чтобы продолжить.
После входа выберите Подключение, чтобы продолжить.
После успешного подключения откроется окно навигатора и отображает данные, доступные на сервере. Выберите данные в навигаторе. Затем выберите преобразование данных в Power Query или Load , чтобы загрузить данные в Power BI Desktop.

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

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

В интерфейсе получения данных выполните поиск по Google, а затем выберите Google BigQuery (Идентификатор Microsoft Entra). Дополнительные сведения: где получить данные
В диалоговом окне Google BigQuery (Идентификатор Microsoft Entra) может потребоваться создать новое подключение или выбрать существующее подключение. Если вы создаете новое подключение, введите идентификатор проекта выставления счетов. Если вы используете локальные данные, выберите локальный шлюз данных.
Если вы хотите использовать дополнительные параметры, выберите дополнительные параметры. Дополнительные сведения: Подключение с помощью дополнительных параметров
После входа нажмите кнопку "Далее ", чтобы продолжить.
После успешного подключения откроется окно навигатора и отображает данные, доступные на сервере. Выберите данные в навигаторе. Затем нажмите кнопку "Далее ", чтобы преобразовать данные в 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.

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

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

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

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

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

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

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, выполните приведенные действия.

В служба Power BI выберите портал Администратор из списка параметров.
Включите параметр единого входа Google BigQuery.

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

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

В служба Power BI выберите портал Администратор из списка параметров.
В разделе "Параметры интеграции" включите единый вход Azure AD для шлюза.

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

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