pandas.read_sql

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

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

Параметры:

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