pandas.DataFrame.to_gbq
-
DataFrame.to_gbq(self, 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. Используйте модуль logging для настройки уровня подробности вместо этого.
-
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.
-
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.25.0/reference/api/pandas.DataFrame.to_gbq.html