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) SQL-запрос для выполнения. con : SQLAlchemy connectable(engine/connection), строка 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 используется %(имя)s, поэтому используйте params={‘имя’ : ‘значение’} 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.