pandas.DataFrame.to_gbq
-
DataFrame.to_gbq(destination_table, project_id=None, chunksize=None, reauth=False, if_exists='fail', auth_local_webserver=False, table_schema=None, location=None, progress_bar=True, credentials=None, verbose=None, private_key=None)[source] -
Запись DataFrame в таблицу Google BigQuery.
Для этой функции требуется пакет pandas-gbq.
См. руководство по аутентификации с Google BigQuery для инструкций по аутентификации.
Параметры: -
destination_table : str -
Имя таблицы для записи в формате
dataset.tablename. -
project_id : str, optional -
Идентификатор проекта учетной записи Google BigQuery. Необязательно, если доступен из среды.
-
chunksize : int, optional -
Количество строк, вставляемых в каждом фрагменте из DataFrame. Установлено в значение
None, чтобы загрузить весь DataFrame сразу. -
reauth : bool, default False -
Принудительная повторная аутентификация пользователя в Google BigQuery. Это полезно, если используются несколько учетных записей.
-
if_exists : str, default ‘fail’ -
Поведение при существовании целевой таблицы. Значение может быть одним из:
-
'fail' -
Если таблица существует, ничего не делать.
-
'replace' -
Если таблица существует, удалить ее, создать заново и вставить данные.
-
'append' -
Если таблица существует, вставить данные. Создать, если не существует.
-
-
auth_local_webserver : bool, default False -
Использование локального потока веб-сервера вместо потока консоли при получении учетных данных пользователя.
Новое в версии 0.2.0 pandas-gbq.
-
table_schema : list of dicts, optional -
Список полей BigQuery-таблицы, которым соответствуют столбцы DataFrame, например
[{'name': 'col1', 'type': 'STRING'},...]. Если схема не указана, она будет сгенерирована в соответствии с типами данных столбцов DataFrame. См. документацию API BigQuery по доступным именам поля.Новое в версии 0.3.1 pandas-gbq.
-
location : str, optional -
Расположение, где должна выполняться задача загрузки. См. документацию по расположениям BigQuery для получения списка доступных расположений. Расположение должно соответствовать расположению целевого набора данных.
Новое в версии 0.5.0 pandas-gbq.
-
progress_bar : bool, default True -
Использование библиотеки
tqdmдля отображения прогресс-бара загрузки по частям.Новое в версии 0.5.0 pandas-gbq.
-
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.
-
verbose : bool, deprecated -
Устарело в версии pandas-gbq 0.4.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 notebook на удаленном хосте).
См. также
-
pandas_gbq.to_gbq - Эта функция в библиотеке pandas-gbq.
-
pandas.read_gbq - Чтение DataFrame из Google BigQuery.
-
© 2008–2012, AQR Capital Management, LLC, Lambda Foundry, Inc. and PyData Development Team
Licensed under the 3-clause BSD License.
https://pandas.pydata.org/pandas-docs/version/0.24.2/reference/api/pandas.DataFrame.to_gbq.html