Skip to content

Remove Oracle database install docs #599

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
ruibaby merged 1 commit into from
Jun 1, 2026
Merged

Remove Oracle database install docs #599

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
54 changes: 1 addition & 53 deletions docs/getting-started/install/config.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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` | -- |

数据库配置：

Expand All @@ -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。
:::

<details>
<summary>Oracle 用户需要注意</summary>

由于 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 )
);
```

</details>

## Redis 集成

:::note
Expand Down
54 changes: 1 addition & 53 deletions docs/getting-started/install/jar-file.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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` |

配置对应关系：

Expand All @@ -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。
:::

<details>
<summary>Oracle 用户需要注意</summary>

由于 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 )
);
```

</details>

:::info
- HOST：数据库服务地址，如 `localhost`
- PORT：数据库服务端口，如 `3306`
Expand Down
54 changes: 1 addition & 53 deletions docs/getting-started/install/slots/_docker-args.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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` | 外部访问链接，如果需要在公网访问，需要配置为实际访问地址 |

数据库配置：
Expand All @@ -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。
:::

<details>
<summary>Oracle 用户需要注意</summary>

由于 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 )
);
```

</details>
5 changes: 0 additions & 5 deletions docs/getting-started/prepare.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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)。
:::
Expand Down
Loading