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=<no_default>)[исходный код]

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

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

Параметры:

table_name:str

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

con:SQLAlchemy connectable or str

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

schema:str, default None

Имя схемы SQL в базе данных, к которой выполняется запрос (если СУБД поддерживает такую возможность). Если значение равно None, используется схема по умолчанию (значение по умолчанию).

index_col:str or list of str, optional, default: None

Столбец(ы), которые следует использовать в качестве индекса (MultiIndex).

coerce_float:bool, default True

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

parse_dates:list or dict, default None

• Список имен столбцов, которые следует интерпретировать как даты.

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

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

columns:list, default None

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

chunksize:int, default None

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

dtype_backend:{‘numpy_nullable’, ‘pyarrow’}, default ‘numpy_nullable’

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

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

• "pyarrow": возвращает DataFrame с типами данных nullable на основе pyarrow ArrowDtype.

Добавлено в версии 2.0.

Возвращает:

DataFrame or Iterator[DataFrame]

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

См. также

read_sql_query

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

read_sql

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

Примечания

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

Примеры

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