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 : string SQL query or SQLAlchemy Selectable (select or text object) SQL-запрос, подлежащий выполнению. con : SQLAlchemy connectable(engine/connection), database string URI, или соединение sqlite3 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. chunksize : int, default None Если указано, возвращается итератор, где chunksize является количеством строк, включаемых в каждый фрагмент.

Возвращаемое значение:

DataFrame

См. также

read_sql_table

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

read_sql

Примечания

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