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 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}, где словарь 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 запрос). Делегированная функция может иметь более конкретные примечания о своей функциональности, которые здесь не указаны.