pandas.read_sql_query

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

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

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

Параметры

sql:строка SQL-запрос или SQLAlchemy Selectable (select или text объект)

SQL-запрос, который необходимо выполнить.

con:SQLAlchemy соединение, строка или соединение sqlite3

Использование 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 — количество строк в каждом фрагменте.

dtype:Имя типа или словарь столбцов

Тип данных для данных или столбцов. Например, np.float64 или {‘a’: np.float64, ‘b’: np.int32, ‘c’: ‘Int64’}.

Добавлена в версии 1.3.0.

Возвращает

DataFrame или Iterator[DataFrame]

См. также

read_sql_table

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

read_sql

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

Примечания

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