pandas.read_sql_query

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

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

Возвращает DataFrame, соответствующий результату строки запроса. Можно указать параметр index_col, чтобы использовать один из столбцов в качестве индекса, иначе будет использован индекс по умолчанию (целые числа).

Параметры:

sql : строка SQL-запроса или SQLAlchemy Selectable (объект select или text) для выполнения. con : SQLAlchemy connectable (движок/соединение) или URI базы данных или соединение sqlite3 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 chunksize : целое число, по умолчанию None Если указано, возвращает итератор, где chunksize — количество строк, включаемых в каждый фрагмент.

Возвращает:

DataFrame

См. также

read_sql_table

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

read_sql

Примечания

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