halo/docs
1
0
Fork 0
mirror of https://github.com/halo-dev/docs.git synced 2025-10-19 00:38:24 +00:00
Code Issues Packages Projects Releases Wiki Activity

docs: add database creation tips (#449)

Browse Source 
添加创建数据库的提示。

Fixes https://github.com/halo-dev/docs/issues/336

```release-note
None
```
This commit is contained in:
Ryan Wang
2024-10-28 15:32:04 +08:00
committed by GitHub
parent e4edfed6bc
commit 5ef6bc2712
5 changed files with 43 additions and 17 deletions
Download Patch File Download Diff File Expand all files Collapse all files

8
docs/getting-started/install/docker-compose.md
View File

@@ -226,6 +226,14 @@ import DockerRegistryList from "./slots/_docker-registry-list.md"
# 端口号 默认8090 # 端口号 默认8090
- --server.port=8090 - --server.port=8090
``` ```
:::info
使用外部数据库时，需要提前手动创建好数据库，以 MySQL 为例：
```sql
create database halo character set utf8mb4 collate utf8mb4_bin;
```
:::
</TabItem> </TabItem>
</Tabs> </Tabs>

21
docs/getting-started/install/jar-file.md
View File

@@ -110,26 +110,31 @@ title: 使用 JAR 文件部署
数据库配置说明： 数据库配置说明：
| 参数名 | 描述 | | 参数名 | 描述 |
|----------------------------|-------------------------------------------------------| | -------------------------- | ----------------------------------------------------------- |
| `spring.r2dbc.url` | 数据库连接地址，详细可查阅下方的 `配置对应关系` | | `spring.r2dbc.url` | 数据库连接地址，详细可查阅下方的 `配置对应关系` |
| `spring.r2dbc.username` | 数据库用户名 | | `spring.r2dbc.username` | 数据库用户名 |
| `spring.r2dbc.password` | 数据库密码 | | `spring.r2dbc.password` | 数据库密码 |
| `spring.sql.init.platform` | 数据库平台名称，支持 `postgresql`、`mysql`、`mariadb`、`h2` | | `spring.sql.init.platform` | 数据库平台名称，支持 `postgresql`、`mysql`、`mariadb`、`h2` |
配置对应关系： 配置对应关系：
| 链接方式 | 链接地址格式 | `spring.sql.init.platform` | | 链接方式 | 链接地址格式 | `spring.sql.init.platform` |
|-------------|------------------------------------------------------------------------------------|----------------------------| | ----------- | ---------------------------------------------------------------------------------- | -------------------------- |
| PostgreSQL | `r2dbc:pool:postgresql://{HOST}:{PORT}/{DATABASE}` | postgresql | | PostgreSQL | `r2dbc:pool:postgresql://{HOST}:{PORT}/{DATABASE}` | postgresql |
| MySQL | `r2dbc:pool:mysql://{HOST}:{PORT}/{DATABASE}` | mysql | | MySQL | `r2dbc:pool:mysql://{HOST}:{PORT}/{DATABASE}` | mysql |
| MariaDB | `r2dbc:pool:mariadb://{HOST}:{PORT}/{DATABASE}` | mariadb | | MariaDB | `r2dbc:pool:mariadb://{HOST}:{PORT}/{DATABASE}` | mariadb |
| H2 Database | `r2dbc:h2:file:///${halo.work-dir}/db/halo-next?MODE=MySQL&DB_CLOSE_ON_EXIT=FALSE` | h2 | | H2 Database | `r2dbc:h2:file:///${halo.work-dir}/db/halo-next?MODE=MySQL&DB_CLOSE_ON_EXIT=FALSE` | h2 |
:::info :::info
- HOST：数据库服务地址，如 `localhost` - HOST：数据库服务地址，如 `localhost`
- PORT：数据库服务端口，如 `3306` - PORT：数据库服务端口，如 `3306`
- DATABASE：数据库名称，如 `halo`，需要提前创建 - DATABASE：数据库名称，如 `halo`，需要提前创建，以 MySQL 为例：
```sql
create database halo character set utf8mb4 collate utf8mb4_bin;
```
::: :::
:::warning :::warning

2
docusaurus.config.js
View File

@@ -189,7 +189,7 @@ const config = {
prism: { prism: {
theme: darkCodeTheme, theme: darkCodeTheme,
darkTheme: darkCodeTheme, darkTheme: darkCodeTheme,
additionalLanguages: ["java"], additionalLanguages: ["java","sql"],
}, },
zoom: { zoom: {
selector: ".markdown :not(a) > img", selector: ".markdown :not(a) > img",

8
versioned_docs/version-2.20/getting-started/install/docker-compose.md
View File

@@ -226,6 +226,14 @@ import DockerRegistryList from "./slots/_docker-registry-list.md"
# 端口号 默认8090 # 端口号 默认8090
- --server.port=8090 - --server.port=8090
``` ```
:::info
使用外部数据库时，需要提前手动创建好数据库，以 MySQL 为例：
```sql
create database halo character set utf8mb4 collate utf8mb4_bin;
```
:::
</TabItem> </TabItem>
</Tabs> </Tabs>

21
versioned_docs/version-2.20/getting-started/install/jar-file.md
View File

@@ -110,26 +110,31 @@ title: 使用 JAR 文件部署
数据库配置说明： 数据库配置说明：
| 参数名 | 描述 | | 参数名 | 描述 |
|----------------------------|-------------------------------------------------------| | -------------------------- | ----------------------------------------------------------- |
| `spring.r2dbc.url` | 数据库连接地址，详细可查阅下方的 `配置对应关系` | | `spring.r2dbc.url` | 数据库连接地址，详细可查阅下方的 `配置对应关系` |
| `spring.r2dbc.username` | 数据库用户名 | | `spring.r2dbc.username` | 数据库用户名 |
| `spring.r2dbc.password` | 数据库密码 | | `spring.r2dbc.password` | 数据库密码 |
| `spring.sql.init.platform` | 数据库平台名称，支持 `postgresql`、`mysql`、`mariadb`、`h2` | | `spring.sql.init.platform` | 数据库平台名称，支持 `postgresql`、`mysql`、`mariadb`、`h2` |
配置对应关系： 配置对应关系：
| 链接方式 | 链接地址格式 | `spring.sql.init.platform` | | 链接方式 | 链接地址格式 | `spring.sql.init.platform` |
|-------------|------------------------------------------------------------------------------------|----------------------------| | ----------- | ---------------------------------------------------------------------------------- | -------------------------- |
| PostgreSQL | `r2dbc:pool:postgresql://{HOST}:{PORT}/{DATABASE}` | postgresql | | PostgreSQL | `r2dbc:pool:postgresql://{HOST}:{PORT}/{DATABASE}` | postgresql |
| MySQL | `r2dbc:pool:mysql://{HOST}:{PORT}/{DATABASE}` | mysql | | MySQL | `r2dbc:pool:mysql://{HOST}:{PORT}/{DATABASE}` | mysql |
| MariaDB | `r2dbc:pool:mariadb://{HOST}:{PORT}/{DATABASE}` | mariadb | | MariaDB | `r2dbc:pool:mariadb://{HOST}:{PORT}/{DATABASE}` | mariadb |
| H2 Database | `r2dbc:h2:file:///${halo.work-dir}/db/halo-next?MODE=MySQL&DB_CLOSE_ON_EXIT=FALSE` | h2 | | H2 Database | `r2dbc:h2:file:///${halo.work-dir}/db/halo-next?MODE=MySQL&DB_CLOSE_ON_EXIT=FALSE` | h2 |
:::info :::info
- HOST：数据库服务地址，如 `localhost` - HOST：数据库服务地址，如 `localhost`
- PORT：数据库服务端口，如 `3306` - PORT：数据库服务端口，如 `3306`
- DATABASE：数据库名称，如 `halo`，需要提前创建 - DATABASE：数据库名称，如 `halo`，需要提前创建，以 MySQL 为例：
```sql
create database halo character set utf8mb4 collate utf8mb4_bin;
```
::: :::
:::warning :::warning