diff --git a/source/_integrations/recorder.markdown b/source/_integrations/recorder.markdown index 3a8f822a855..dea4d589b75 100644 --- a/source/_integrations/recorder.markdown +++ b/source/_integrations/recorder.markdown @@ -19,9 +19,17 @@ This integration constantly saves data. If you use the default configuration, th -Home Assistant uses [SQLAlchemy](https://www.sqlalchemy.org/), which is an Object Relational Mapper (ORM). This means that you can use **any** SQL backend for the recorder that is supported by SQLAlchemy, like [MySQL](https://www.mysql.com/), [MariaDB](https://mariadb.org/), [PostgreSQL](https://www.postgresql.org/), or [MS SQL Server](https://www.microsoft.com/en-us/sql-server/). +Home Assistant uses [SQLAlchemy](https://www.sqlalchemy.org/), which is an Object Relational Mapper (ORM). This makes it possible to use a number of database solutions. -The default database engine is [SQLite](https://www.sqlite.org/) which does not require any configuration. The database is stored in your Home Assistant configuration directory ('/config/') and is named `home-assistant_v2.db`. +The supported database solutions are: +- [MariaDB](https://mariadb.org/) ≥ 10.3 +- [MySQL](https://www.mysql.com/) ≥ 8.0 +- [PostgreSQL](https://www.postgresql.org/) ≥ 12 +- [SQLite](https://www.sqlite.org/) ≥ 3.32.1 + +Although SQLAlchemy supports additional database solutions, it will behave differently on different databases, and features relied on by the recorder may work differently, or not at all, in different databases. + +The default, and recommended, database engine is [SQLite](https://www.sqlite.org/) which does not require any configuration. The database is stored in your Home Assistant configuration directory ('/config/') and is named `home-assistant_v2.db`. To change the defaults for the `recorder` integration in your installation, add the following to your `configuration.yaml` file: @@ -231,10 +239,10 @@ Call the service `recorder.enable` to start again saving events and states to th The following database engines are tested when major changes are made to the recorder. Other database engines do not have an active core maintainer at this time and may require additional work to maintain. -- SQLite 3.32.1+ -- MariaDB 10.3+ -- MySQL 5.7+ -- PostgreSQL 12+ +- SQLite ≥ 3.32.1 +- MariaDB ≥ 10.3 +- MySQL ≥ 8.0 +- PostgreSQL ≥ 12 ## Custom database engines @@ -278,13 +286,6 @@ PostgreSQL (Socket): PostgreSQL (Custom socket dir): description: > `postgresql://@/DB_NAME?host=/path/to/dir` -MS SQL Server: - description: > - `mssql+pyodbc://username:password@SERVER_IP:1433/DB_NAME?charset=utf8&driver=DRIVER` -Oracle: - description: > - `oracle+cx_oracle://username:password@SERVER_IP:1521/DB_NAME?encoding=UTF-8&nencoding=UTF-8` - {% endconfiguration_basic %}