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=)[источник]#

Прочитать таблицу базы данных SQL в DataFrame.

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

Параметры:
table_namestr

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

conSQLAlchemy connectable или str

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

схемаstr, по умолчанию None

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

index_colstr или список str, опционально, по умолчанию: None

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

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

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

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

  • Список имён столбцов для парсинга как даты.

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

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

столбцысписок, по умолчанию None

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

chunksizeint, по умолчанию None

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

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

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

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

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

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

Возвращает:
DataFrame или Iterator[DataFrame]

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

Смотрите также

read_sql_query

Прочитать SQL-запрос в DataFrame.

read_sql

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

Примечания

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

Примеры

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