diff --git a/docs/getting-started/install/config.md b/docs/getting-started/install/config.md index a4db4b5f..48cc6ebe 100644 --- a/docs/getting-started/install/config.md +++ b/docs/getting-started/install/config.md @@ -119,7 +119,7 @@ Web 服务相关: | `spring.r2dbc.url` | 数据库连接地址,详细可查阅下方的 `数据库配置` | -- | | `spring.r2dbc.username` | 数据库用户名 | -- | | `spring.r2dbc.password` | 数据库密码 | -- | -| `spring.sql.init.platform` | 数据库平台名称,支持 `postgresql`、`mysql`、`mariadb`、`oracle`、`h2` | -- | +| `spring.sql.init.platform` | 数据库平台名称,支持 `postgresql`、`mysql`、`mariadb`、`h2` | -- | 数据库配置: @@ -128,60 +128,8 @@ Web 服务相关: | PostgreSQL | `r2dbc:pool:postgresql://{HOST}:{PORT}/{DATABASE}` | postgresql | | MySQL | `r2dbc:pool:mysql://{HOST}:{PORT}/{DATABASE}` | mysql | | MariaDB | `r2dbc:pool:mariadb://{HOST}:{PORT}/{DATABASE}` | mariadb | -| Oracle(付费版) | `r2dbc:pool:oracle://{HOST}:{PORT}/{DATABASE}` | oracle | | H2 Database | `r2dbc:h2:file:///${halo.work-dir}/db/halo-next?MODE=MySQL&DB_CLOSE_ON_EXIT=FALSE` | h2 | -:::warning[商城版需要注意] -由于商城版的数据结构与 Halo 其他版本不同,所以暂时仅支持 PostgreSQL、MySQL、MariaDB、H2。 -::: - -
- Oracle 用户需要注意 - -由于 Oracle 数据库各个版本的差异,目前很难统一提供自动执行的 SQL 脚本,所以配置 Oracle 数据库连接之前,需要先手动创建数据库以及执行表创建脚本。以下是具体步骤: - -1. 在 Oracle 数据库中创建数据库,比如 `halo`。 -2. 添加 Halo 的启动参数 `--spring.sql.init.mode=never`。 -3. 执行创建表的 SQL 脚本,下面提供两种脚本,可以按照 Oracle 数据库的版本自行选择: - - 如果你的 Oracle 数据库不支持 `IF NOT EXISTS` 语法: - - ```sql - DECLARE - table_count INTEGER; - BEGIN - SELECT COUNT(*) - INTO table_count - FROM all_tables - WHERE table_name = 'EXTENSIONS'; - - IF table_count = 0 THEN - EXECUTE IMMEDIATE ' - CREATE TABLE extensions - ( - name VARCHAR2(255) NOT NULL, - data BLOB, - version NUMBER, - CONSTRAINT pk_name PRIMARY KEY (name) - )'; - END IF; - END; - / - ``` - - 如果你的 Oracle 数据库支持 `IF NOT EXISTS` 语法: - - ```sql - CREATE TABLE IF NOT EXISTS EXTENSIONS ( - NAME VARCHAR2(255) NOT NULL, - DATA BLOB, - VERSION NUMBER, - CONSTRAINT PK_NAME PRIMARY KEY ( NAME ) - ); - ``` - -
- ## Redis 集成 :::note diff --git a/docs/getting-started/install/jar-file.md b/docs/getting-started/install/jar-file.md index 57a4d130..408eb015 100644 --- a/docs/getting-started/install/jar-file.md +++ b/docs/getting-started/install/jar-file.md @@ -116,7 +116,7 @@ description: 使用 JAR 与 Java 运行 Halo:数据库要求、启动参数与 | `spring.r2dbc.url` | 数据库连接地址,详细可查阅下方的 `配置对应关系` | | `spring.r2dbc.username` | 数据库用户名 | | `spring.r2dbc.password` | 数据库密码 | - | `spring.sql.init.platform` | 数据库平台名称,支持 `postgresql`、`mysql`、`mariadb`、`oracle`、`h2` | + | `spring.sql.init.platform` | 数据库平台名称,支持 `postgresql`、`mysql`、`mariadb`、`h2` | 配置对应关系: @@ -125,60 +125,8 @@ description: 使用 JAR 与 Java 运行 Halo:数据库要求、启动参数与 | PostgreSQL(推荐) | `r2dbc:pool:postgresql://{HOST}:{PORT}/{DATABASE}` | postgresql | | MySQL | `r2dbc:pool:mysql://{HOST}:{PORT}/{DATABASE}` | mysql | | MariaDB | `r2dbc:pool:mariadb://{HOST}:{PORT}/{DATABASE}` | mariadb | - | Oracle(付费版) | `r2dbc:pool:oracle://{HOST}:{PORT}/{DATABASE}` | oracle | | H2 Database | `r2dbc:h2:file:///${halo.work-dir}/db/halo-next?MODE=MySQL&DB_CLOSE_ON_EXIT=FALSE` | h2 | - :::warning[商城版需要注意] - 由于商城版的数据结构与 Halo 其他版本不同,所以暂时仅支持 PostgreSQL、MySQL、MariaDB、H2。 - ::: - -
- Oracle 用户需要注意 - - 由于 Oracle 数据库各个版本的差异,目前很难统一提供自动执行的 SQL 脚本,所以配置 Oracle 数据库连接之前,需要先手动创建数据库以及执行表创建脚本。以下是具体步骤: - - 1. 在 Oracle 数据库中创建数据库,比如 `halo`。 - 2. 添加 Halo 的启动参数 `--spring.sql.init.mode=never`。 - 3. 执行创建表的 SQL 脚本,下面提供两种脚本,可以按照 Oracle 数据库的版本自行选择: - - 如果你的 Oracle 数据库不支持 `IF NOT EXISTS` 语法: - - ```sql - DECLARE - table_count INTEGER; - BEGIN - SELECT COUNT(*) - INTO table_count - FROM all_tables - WHERE table_name = 'EXTENSIONS'; - - IF table_count = 0 THEN - EXECUTE IMMEDIATE ' - CREATE TABLE extensions - ( - name VARCHAR2(255) NOT NULL, - data BLOB, - version NUMBER, - CONSTRAINT pk_name PRIMARY KEY (name) - )'; - END IF; - END; - / - ``` - - 如果你的 Oracle 数据库支持 `IF NOT EXISTS` 语法: - - ```sql - CREATE TABLE IF NOT EXISTS EXTENSIONS ( - NAME VARCHAR2(255) NOT NULL, - DATA BLOB, - VERSION NUMBER, - CONSTRAINT PK_NAME PRIMARY KEY ( NAME ) - ); - ``` - -
- :::info - HOST:数据库服务地址,如 `localhost` - PORT:数据库服务端口,如 `3306` diff --git a/docs/getting-started/install/slots/_docker-args.md b/docs/getting-started/install/slots/_docker-args.md index 23da99d3..c753f352 100644 --- a/docs/getting-started/install/slots/_docker-args.md +++ b/docs/getting-started/install/slots/_docker-args.md @@ -3,7 +3,7 @@ | `spring.r2dbc.url` | 数据库连接地址,详细可查阅下方的 `数据库配置` | | `spring.r2dbc.username` | 数据库用户名 | | `spring.r2dbc.password` | 数据库密码 | -| `spring.sql.init.platform` | 数据库平台名称,支持 `postgresql`、`mysql`、`mariadb`、`oracle`、`h2` | +| `spring.sql.init.platform` | 数据库平台名称,支持 `postgresql`、`mysql`、`mariadb`、`h2` | | `halo.external-url` | 外部访问链接,如果需要在公网访问,需要配置为实际访问地址 | 数据库配置: @@ -13,56 +13,4 @@ | PostgreSQL(推荐) | `r2dbc:pool:postgresql://{HOST}:{PORT}/{DATABASE}` | postgresql | | MySQL | `r2dbc:pool:mysql://{HOST}:{PORT}/{DATABASE}` | mysql | | MariaDB | `r2dbc:pool:mariadb://{HOST}:{PORT}/{DATABASE}` | mariadb | -| Oracle(付费版) | `r2dbc:pool:oracle://{HOST}:{PORT}/{DATABASE}` | oracle | | H2 Database | `r2dbc:h2:file:///${halo.work-dir}/db/halo-next?MODE=MySQL&DB_CLOSE_ON_EXIT=FALSE` | h2 | - -:::warning[商城版需要注意] -由于商城版的数据结构与 Halo 其他版本不同,所以暂时仅支持 PostgreSQL、MySQL、MariaDB、H2。 -::: - -
- Oracle 用户需要注意 - -由于 Oracle 数据库各个版本的差异,目前很难统一提供自动执行的 SQL 脚本,所以配置 Oracle 数据库连接之前,需要先手动创建数据库以及执行表创建脚本。以下是具体步骤: - -1. 在 Oracle 数据库中创建数据库,比如 `halo`。 -2. 添加 Halo 的启动参数 `--spring.sql.init.mode=never`。 -3. 执行创建表的 SQL 脚本,下面提供两种脚本,可以按照 Oracle 数据库的版本自行选择: - - 如果你的 Oracle 数据库不支持 `IF NOT EXISTS` 语法: - - ```sql - DECLARE - table_count INTEGER; - BEGIN - SELECT COUNT(*) - INTO table_count - FROM all_tables - WHERE table_name = 'EXTENSIONS'; - - IF table_count = 0 THEN - EXECUTE IMMEDIATE ' - CREATE TABLE extensions - ( - name VARCHAR2(255) NOT NULL, - data BLOB, - version NUMBER, - CONSTRAINT pk_name PRIMARY KEY (name) - )'; - END IF; - END; - / - ``` - - 如果你的 Oracle 数据库支持 `IF NOT EXISTS` 语法: - - ```sql - CREATE TABLE IF NOT EXISTS EXTENSIONS ( - NAME VARCHAR2(255) NOT NULL, - DATA BLOB, - VERSION NUMBER, - CONSTRAINT PK_NAME PRIMARY KEY ( NAME ) - ); - ``` - -
diff --git a/docs/getting-started/prepare.md b/docs/getting-started/prepare.md index ed763ff8..c6415ae9 100644 --- a/docs/getting-started/prepare.md +++ b/docs/getting-started/prepare.md @@ -72,14 +72,9 @@ Halo 目前支持以下数据库: - MySQL - MariaDB - H2 -- Oracle 其中,H2 不需要单独运行,其他数据库需要单独安装并配置。一般情况下,推荐按照 [使用 Docker Compose 部署](./install/docker-compose.md) 文档将 Halo 和数据库容器编排在一起。 -:::warning[商城版需要注意] -由于商城版的数据结构与 Halo 其他版本不同,所以暂时仅支持 PostgreSQL、MySQL、MariaDB、H2。 -::: - :::warning 不推荐在生产环境使用默认的 H2 数据库,这可能因为操作不当导致数据文件损坏。如果因为某些原因(如内存不足以运行独立数据库)必须要使用,建议按时[备份数据](../user-guide/backup.md)。 :::