pandas.DataFrame.to_gbq#

DataFrame.to_gbq(destination_table, *, project_id=None, chunksize=None, повторная аутентификация=False, if_exists='fail', auth_local_webserver=True, table_schema=None, location=None, progress_bar=True, учётные данные=None)[источник]#

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

Устарело с версии 2.2.0: Пожалуйста, используйте pandas_gbq.to_gbq вместо этого.

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

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

Параметры:

destination_tablestr

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

project_idstr, optional

Идентификатор проекта Google BigQuery Account. Необязателен, если доступен из окружения.

chunksizeint, необязательный

Количество строк для вставки в каждый фрагмент из датафрейма. Установить на None загрузить весь датафрейм целиком.

повторная аутентификацияbool, по умолчанию False

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

if_existsstr, по умолчанию 'fail'

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

'fail': Если таблица существует, вызывает pandas_gbq.gbq.TableCreationError.
'replace': Если таблица существует, удалить её, создать заново и вставить данные.
'append': Если таблица существует, вставить данные. Создать, если не существует.

auth_local_webserverbool, по умолчанию True

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

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

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

table_schemaсписок словарей, опционально

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

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

locationstr, optional

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

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

progress_barbool, по умолчанию True

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

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

учётные данныеgoogle.auth.credentials.Credentials, опционально

Учетные данные для доступа к API Google. Используйте этот параметр для переопределения учетных данных по умолчанию, например, для использования Compute Engine google.auth.compute_engine.Credentials или Service Account 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)  