# dask.dataframe.read_sql

### dask.dataframe.read_sql(sql, con, index_col, \*\*kwargs)

Read SQL query or database table into a DataFrame.

This function is a convenience wrapper around `read_sql_table` and
`read_sql_query`. It will delegate to the specific function depending
on the provided input. A SQL query will be routed to `read_sql_query`,
while a database table name will be routed to `read_sql_table`.
Note that the delegated function might have more specific notes about
their functionality not listed here.

* **Parameters:**
  **sql**
  : Name of SQL table in database or SQL query to be executed. TextClause is not supported

  **con**
  : Full sqlalchemy URI for the database connection

  **index_col**
  : Column which becomes the index, and defines the partitioning. Should
    be a indexed column in the SQL server, and any orderable type. If the
    type is number or time, then partition boundaries can be inferred from
    `npartitions` or `bytes_per_chunk`; otherwise must supply explicit
    `divisions`.
* **Returns:**
  dask.dataframe

#### SEE ALSO
[`read_sql_table`](dask.dataframe.read_sql_table.html.md#dask.dataframe.read_sql_table)
: Read SQL database table into a DataFrame.

[`read_sql_query`](dask.dataframe.read_sql_query.html.md#dask.dataframe.read_sql_query)
: Read SQL query into a DataFrame.

<!-- !! processed by numpydoc !! -->
