Skip to content

Add cross-references between database docs and SQL integration #45147

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
c0ffeeca7 merged 2 commits into from
May 4, 2026
Merged

Add cross-references between database docs and SQL integration #45147

Show file tree
Hide file tree
Changes from 1 commit
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
e45839d
Add cross-references between database docs and SQL integration
mik-laj May 2, 2026
a6122ba
fixup! Add cross-references between database docs and SQL integration
mik-laj May 2, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 6 additions & 0 deletions source/_docs/backend/database.markdown
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -263,4 +263,10 @@ group.all_switches 8018

If you don't want to keep certain entities, you can delete them permanently by using the [actions provided by the recorder](/integrations/recorder/#action-purge_entities).

### Use the SQL sensor for live queries

Beyond manual exploration, you can run SQL queries directly inside Home Assistant using the [SQL](/integrations/sql/) {% term integration %}. It connects to the same recorder database by default and lets you expose query results as sensor entities, or call queries from automations using the `sql.query` action — no external tools needed.

### Data Science Portal

For a more interactive way of working with the database, check the [Data Science Portal](https://data.home-assistant.io/).
2 changes: 1 addition & 1 deletion source/_integrations/sql.markdown
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -202,7 +202,7 @@ result:

See [supported engines](/integrations/recorder/#custom-database-engines) for which you can connect with this integration.

The SQL integration will connect to the Home Assistant Recorder database if "Database URL" has not been specified.
The SQL integration will connect to the Home Assistant Recorder database if "Database URL" has not been specified. For a full overview of available tables, columns, and indexes in that database, see the [Database](/docs/backend/database/) documentation.

There is no explicit configuration required for attributes. The integration will set all columns returned by the query as attributes.

Expand Down
Loading