pandas.read_sql_query

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

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

Возвращает DataFrame, соответствующий результату строки запроса. Допускается использование параметра index_col для выбора одного из столбцов в качестве индекса, иначе будет использован индекс по умолчанию, основанный на целых числах.

Параметры:

sql : строка SQL запроса или SQLAlchemy Selectable (select или text объект) для выполнения. con : SQLAlchemy connectable(engine/connection) или строка URI базы данных или подключение sqlite3 DBAPI2. Использование SQLAlchemy позволяет использовать любую базу данных, поддерживаемую этой библиотекой. Если объект DBAPI2, поддерживается только sqlite3. index_col : строка или список строк, необязательно, по умолчанию: None Столбец(ы) для установки в качестве индекса (MultiIndex) coerce_float : булево значение, по умолчанию 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}, где аргумент-словарь соответствует ключевым аргументам pandas.to_datetime(). Особенно полезно для баз данных без собственной поддержки Datetime, таких как SQLite chunksize : целое число, по умолчанию None Если указано, возвращает итератор, где chunksize - это количество строк, включаемых в каждый фрагмент.

Возвращает:

DataFrame

См. также

read_sql_table

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

read_sql

Замечания

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