pandas.read_gbq

pandas.read_gbq(query, project_id=None, index_col=None, col_order=None, reauth=False, auth_local_webserver=False, dialect=None, location=None, configuration=None, credentials=None, private_key=None, verbose=None) [source]

Загрузка данных из Google BigQuery.

Для этой функции требуется пакет pandas-gbq.

См. руководство по аутентификации с Google BigQuery для инструкций по аутентификации.

Параметры:

query : str Запрос SQL для получения значений данных. project_id : str, optional Идентификатор проекта учетной записи Google BigQuery. Необязательно, если доступен из среды. index_col : str, optional Имя столбца результата для использования в качестве индекса в результирующей DataFrame. col_order : list(str), optional Список имен столбцов BigQuery в желаемом порядке для результирующей DataFrame. reauth : boolean, default False Принудительная повторная аутентификация пользователя Google BigQuery. Это полезно, если используются несколько учетных записей. auth_local_webserver : boolean, default False Использование локального потока веб-сервера вместо потока консоли при получении учетных данных пользователя. Новое в версии 0.2.0 pandas-gbq. dialect : str, default ‘legacy’ Примечание: значение по умолчанию будет изменено на ‘standard’ в будущей версии. Диалект синтаксиса SQL для использования. Значение может быть одним из: 'legacy' Использование устаревшего диалекта SQL BigQuery. Для получения дополнительной информации см. Справочник по BigQuery Legacy SQL. 'standard' Использование стандартного SQL BigQuery, совместимого со стандартом SQL 2011. Для получения дополнительной информации см. Справочник по BigQuery Standard SQL. Изменено в версии 0.24.0. location : str, optional Местоположение, где должен выполняться запрос задач. См. документацию по расположениям BigQuery для получения списка доступных расположений. Расположение должно соответствовать расположению любых наборов данных, используемых в запросе. Новое в версии 0.5.0 pandas-gbq. configuration : dict, optional Параметры конфигурации запроса для обработки задач. Например: configuration = {‘query’: {‘useQueryCache’: False}} Для получения дополнительной информации см. Справочник по BigQuery REST API. credentials : google.auth.credentials.Credentials, optional Учетные данные для доступа к Google API. Используйте этот параметр для переопределения учетных данных по умолчанию, например, для использования Compute Engine google.auth.compute_engine.Credentials или учетной записи сервиса google.oauth2.service_account.Credentials напрямую. Новое в версии 0.8.0 pandas-gbq. Новое в версии 0.24.0. private_key : str, deprecated Устарело в версии pandas-gbq 0.8.0. Используйте параметр credentials и google.oauth2.service_account.Credentials.from_service_account_info() или google.oauth2.service_account.Credentials.from_service_account_file() вместо него. Приватный ключ учетной записи сервиса в формате JSON. Может быть путем к файлу или содержимым строки. Это полезно для аутентификации удаленного сервера (например, Jupyter/IPython ноутбука на удаленном хосте). verbose : None, deprecated Устарело в версии pandas-gbq 0.4.0. Используйте модуль регистрации verbose : None, deprecated, чтобы настроить уровень подробности.

Возвращает:

df: DataFrame DataFrame, представляющий результаты запроса.

См. также

pandas_gbq.read_gbq

Эта функция в библиотеке pandas-gbq.

pandas.DataFrame.to_gbq

Запись DataFrame в Google BigQuery.