# Source.sql
URL: https://lsd.tools/docs/api-source-sql
Updated: 2026-07-17

## Parameters

| name | type | default | description |
|---|---|---|---|
| `db` | `str` | — | a connection string / DSN, e.g. `"sqlite:///mine.db"` |
| `query` | `str` | — | the SQL query whose result set becomes the `Table` |

## Example

```python
from lsdtools import Source

Source.sql("sqlite:///mine.db", "select * from holes")
```

## Notes

The query's result set is read into a `Table` when you call [`read()`](/docs/api-source-read).
A SQL source resolves to no files, so [`paths()`](/docs/api-source-paths) returns `[]`.

## See also

**API:** [file](/docs/api-source-file) · [of](/docs/api-source-of) · [read](/docs/api-source-read) · [paths](/docs/api-source-paths)

**Guides:** [Load steps](/docs/tools-load)