pandas.DataFrame.to_gbq

DataFrame.to_gbq(destination_table, *, project_id=None, chunksize=None, reauth=False, if_exists='fail', auth_local_webserver=True, table_schema=None, location=None, progress_bar=True, credentials=None)[source]

Запись DataFrame в таблицу Google BigQuery.

Устарело начиная с версии 2.2.0: Пожалуйста, используйте pandas_gbq.to_gbq.

Эта функция требует пакета pandas-gbq.

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

Параметры:

destination_table:str

Имя таблицы для записи в формате dataset.tablename.

project_id:str, необязательно

Идентификатор проекта учетной записи Google BigQuery. Необязательно, если доступно из среды.

chunksize:int, необязательно

Количество строк для вставки в каждом блоке из DataFrame. Установите в None для загрузки всего DataFrame сразу.

reauth:bool, по умолчанию False

Принудительно выполнить повторную аутентификацию в Google BigQuery у пользователя. Это полезно, если используются несколько учетных записей.

if_exists:str, по умолчанию ‘fail’

Поведение при существовании целевой таблицы. Значение может быть одним из:

'fail'

Если таблица существует, генерируется исключение pandas_gbq.gbq.TableCreationError.

'replace'

Если таблица существует, она удаляется, создается заново и в неё вставляются данные.

'append'

Если таблица существует, в неё вставляются данные. Создается, если не существует.

auth_local_webserver:bool, по умолчанию True

Использовать поток локального веб-сервера вместо потока консоли при получении учетных данных пользователя.

Новое в версии 0.2.0 pandas-gbq.

Изменено в версии 1.5.0: Значение по умолчанию изменено на True. Google устарела auth_local_webserver = False “внеполосный” (скопировать-вставить) поток.

table_schema:list of dicts, optional

Список полей таблицы BigQuery, с которыми соответствуют столбцы DataFrame, например, [{'name': 'col1', 'type': 'STRING'},...]. Если схема не указана, она будет сгенерирована в соответствии с типами данных столбцов DataFrame. См. документацию API BigQuery о доступных именах поля.

Новое в версии 0.3.1 pandas-gbq.

location:str, optional

Расположение, где должна выполняться задача загрузки. См. документацию Google BigQuery по расположениям для получения списка доступных расположений. Расположение должно соответствовать расположению целевого набора данных.

Новое в версии 0.5.0 pandas-gbq.

progress_bar:bool, по умолчанию 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.

См. также

pandas_gbq.to_gbq

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

read_gbq

Чтение DataFrame из Google BigQuery.

Примеры

Пример взят из документации Google BigQuery

>>> project_id = "my-project"
>>> table_id = 'my_dataset.my_table'
>>> df = pd.DataFrame({
...                   "my_string": ["a", "b", "c"],
...                   "my_int64": [1, 2, 3],
...                   "my_float64": [4.0, 5.0, 6.0],
...                   "my_bool1": [True, False, True],
...                   "my_bool2": [False, True, False],
...                   "my_dates": pd.date_range("now", periods=3),
...                   }
...                   )

>>> df.to_gbq(table_id, project_id=project_id)