pandas.read_sql

pandas.read_sql(sql, con, index_col=None, coerce_float=True, params=None, parse_dates=None, columns=None, chunksize=None)

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

Параметры:

sql : строка SQL-запрос или SQLAlchemy Selectable (select или text объект) для выполнения или имя таблицы базы данных. con : SQLAlchemy connectable(engine/connection) или URI строки базы данных или соединение DBAPI2 (режим по умолчанию) Использование SQLAlchemy позволяет использовать любую базу данных, поддерживаемую этой библиотекой. Если объект DBAPI2, поддерживается только sqlite3. index_col : строка или список строк, необязательно, по умолчанию: None Столбец(ы) для установки в качестве индекса(MultiIndex) coerce_float : boolean, по умолчанию True Попытка преобразовать значения в нестроковые, нечисловые объекты (например, decimal.Decimal) в числа с плавающей запятой, полезно для наборов результатов SQL params : список, кортеж или словарь, необязательно, по умолчанию: None Список параметров для передачи методу execute. Синтаксис передачи параметров зависит от драйвера базы данных. Проверьте документацию драйвера базы данных, чтобы узнать, какой из пяти стилей синтаксиса, описанных в PEP 249’s paramstyle, поддерживается. Например, для psycopg2 используется %(name)s, поэтому используйте params={‘name’ : ‘value’} 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 : целое число, по умолчанию None Если указано, возвращает итератор, где chunksize является количеством строк, включённых в каждый фрагмент.

Возвращает:

DataFrame

См. также

read_sql_table

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

read_sql_query

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

Примечания

Эта функция является удобной обёрткой вокруг read_sql_table и read_sql_query (и для обратной совместимости) и будет делегировать конкретной функции в зависимости от предоставленного ввода (имя таблицы базы данных или SQL-запрос). Делегируемая функция может иметь более специфические заметки о своей функциональности, не указанные здесь.