pandas.read_sql_table

pandas.read_sql_table(table_name, con, schema=None, index_col=None, coerce_float=True, parse_dates=None, columns=None, chunksize=None, dtype_backend=_NoDefault.no_default)[source]

Чтение таблицы SQL базы данных в DataFrame.

Принимая имя таблицы и соединение SQLAlchemy, возвращает DataFrame. Эта функция не поддерживает соединения DBAPI.

Параметры:

table_name:str

Имя таблицы SQL в базе данных.

con:SQLAlchemy connectable или str

В качестве str может быть указан URI базы данных. Режим подключения DBAPI для SQLite не поддерживается.

schema:str, по умолчанию None

Имя SQL схемы в базе данных для запроса (если база данных поддерживает это). Использует схему по умолчанию, если None (по умолчанию).

index_col:str или список str, необязательно, по умолчанию: None

Столбец(ы) для установки в качестве индекса (MultiIndex).

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

Попытка преобразовать значения объектов нестрокового, нечислового типа (например, decimal.Decimal) в числа с плавающей точкой. Может привести к потере точности.

parse_dates:список или словарь, по умолчанию None

• Список имен столбцов для разбора как дат.

• Словарь {column_name: format string}, где строка формата совместима со strftime при разборе строковых времен или является одной из (D, s, ns, ms, us) при разборе целочисленных временных меток.

• Словарь {column_name: arg dict}, где аргумент dict соответствует ключевым аргументам pandas.to_datetime(). Особенно полезно с базами данных без встроенной поддержки Datetime, такими как SQLite.

columns:список, по умолчанию None

Список имен столбцов для выбора из таблицы SQL.

chunksize:int, по умолчанию None

Если указано, возвращает итератор, где chunksize — количество строк, включаемых в каждый фрагмент.

dtype_backend:{‘numpy_nullable’, ‘pyarrow’}, по умолчанию ‘numpy_nullable’

Применяемый к полученному DataFrame бэкенд для типа данных (еще экспериментальная функция). Поведение следующее:

• "numpy_nullable": возвращает DataFrame с поддержкой типов nullable (по умолчанию).

• "pyarrow": возвращает DataFrame с nullable ArrowDtype на основе pyarrow.

Новое в версии 2.0.

Возвращает:

DataFrame или Iterator[DataFrame]

Таблица SQL возвращается как двумерная структура данных с маркированными осями.

См. также

read_sql_query

Чтение SQL запроса в DataFrame.

read_sql

Чтение SQL запроса или таблицы базы данных в DataFrame.

Примечания

Любые значения datetime с информацией о часовом поясе будут преобразованы в UTC.

Примеры

>>> pd.read_sql_table('table_name', 'postgres:///db_name')