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)[源代码]#
将SQL查询读入DataFrame。
返回与查询字符串的结果集对应的DataFrame。可以选择提供一个 index_col 参数使用其中一列作为索引，否则将使用默认的整数索引。
- 参数
- sql字符串SQL查询或SQLAlChemy可选(SELECT或Text对象)
要执行的SQL查询。
- conSQLAlChemy可连接、字符串或SQLITE3连接
通过使用SQLAlChemy，可以使用该库支持的任何数据库。如果是DBAPI2对象，则仅支持sqlite3。
- index_col字符串或字符串列表，可选，默认：无
要设置为索引(多索引)的列。
- coerce_float布尔值，默认为True
尝试将非字符串、非数值对象(如Decimal.Decimal)的值转换为浮点。对SQL结果集非常有用。
- params列表、元组或字典，可选，默认：无
要传递给Execute方法的参数列表。用于传递参数的语法依赖于数据库驱动程序。请查看您的数据库驱动程序文档，了解PEP 249的参数样式中描述的五种语法样式中支持哪一种。例.对于心理拷贝2，使用%(Name)s，因此使用Params={‘name’：‘Value’}。
- parse_dates列表或词典，默认：无
要解析为日期的列名的列表。
判决的日期
{{column_name: format string}}其中，在解析字符串时间的情况下，格式字符串与strftime兼容，或者在解析整数时间戳的情况下，格式字符串是(D、s、ns、ms、us)之一。判决的日期
{{column_name: arg dict}}，其中arg dict对应于的关键字参数pandas.to_datetime()对于没有本机DATETIME支持的数据库(如SQLite)尤其有用。
- chunksizeInt，默认为无
如果指定，则返回迭代器，其中 chunksize 是要包含在每个块中的行数。
- dtype列的类型名称或字典
数据或列的数据类型。例如np.flat64或{‘a’：np.flat64，‘b’：np.int32，‘c’：‘Int64’}。
1.3.0 新版功能.
- 退货
- DataFrame或迭代器 [DataFrame]
参见
read_sql_table将SQL数据库表读入DataFrame。
read_sql将SQL查询或数据库表读入DataFrame。
注意事项
任何具有时区信息的日期时间值都是通过 parse_dates 参数将转换为UTC。