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.

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

Параметры:

sql : string or SQLAlchemy Selectable (select or text object) SQL-запрос для выполнения или имя таблицы. con : SQLAlchemy connectable (engine/connection) or database string URI или соединение DBAPI2 (режим по умолчанию) Использование SQLAlchemy позволяет использовать любую базу данных, поддерживаемую этой библиотекой. Если объект DBAPI2, поддерживается только sqlite3. index_col : string or list of strings, optional, default: None Столбец(ы) для установки в качестве индекса (MultiIndex). coerce_float : boolean, default True Попытка преобразовать значения объектов, не являющихся строками и не являющихся числами (например, decimal.Decimal), в числа с плавающей точкой, что полезно для наборов результатов SQL. params : list, tuple or dict, optional, default: None Список параметров для передачи в метод execute. Синтаксис передачи параметров зависит от драйвера базы данных. Обратитесь к документации драйвера вашей базы данных, чтобы узнать, какой из пяти стилей синтаксиса, описанных в PEP 249’s paramstyle, поддерживается. Например, для psycopg2 используется %(name)s, поэтому используйте params={‘name’ : ‘value’} parse_dates : list or dict, default: None Список имён столбцов для разбора в даты. Словарь {column_name: format string}, где строка формата совместима с strftime в случае парсинга строковых времен, или является одним из (D, s, ns, ms, us) в случае парсинга целочисленных временных меток. Словарь {column_name: arg dict}, где аргумент dict соответствует ключевым аргументам pandas.to_datetime(). Особенно полезно с базами данных без родной поддержки Datetime, такими как SQLite. columns : list, default: None Если указано, верните итератор, где chunksize — число строк, которые нужно включить в каждый фрагмент. chunksize : int, default None Список имён столбцов для выбора из SQL-таблицы (используется только при чтении таблицы).

Возвращает:

DataFrame

См. также

read_sql_table

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

read_sql_query

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