gaussdb-guide.md
... ...
@@ -1,67 +1,72 @@
1
-# gaussdb高斯数据库参考手册
1
+# GaussDB 高斯数据库参考手册
2 2
3
-## 1. DBeaver客户端连接高斯数据库
3
+## 1. 使用 DBeaver 客户端连接 GaussDB 数据库
4 4
5
-**以下是使用DBeaver客户端连接高斯数据库（GaussDB）的详细步骤：**
5
+以下是使用 DBeaver 客户端连接 GaussDB 数据库的详细步骤：
6 6
7
-1. 获取驱动包
7
+### 1.1 获取驱动包
8 8
9
-- 根据高斯数据库的版本，下载对应版本的驱动包。
10
-- 解压驱动包，找到`gaussdbjdbc.jar`文件。
9
+- 根据 GaussDB 数据库的版本，下载对应版本的驱动包。
10
+- 解压驱动包，找到 `gaussdbjdbc.jar` 文件。
11 11
12
-2. 安装DBeaver客户端
12
+### 1.2 安装 DBeaver 客户端
13 13
14
+- 访问 [DBeaver 官网](https://dbeaver.io/)，下载适合您操作系统的安装包并完成安装。
14 15
15
-- 访问DBeaver官网，下载适合操作系统的安装包并完成安装。
16
-
17
- 3. 配置驱动
18
-
19
-- 打开DBeaver，选择“数据库”->“驱动管理器”，点击“新建”。
20
-
21
-- 在“设置”页签中，输入驱动名称（如“GaussDB”），选择驱动类型为“Generic”，填写类名为`com.huawei.gaussdb.jdbc.Driver`，URL模板为空，默认端口为`8000`。
22
-
23
-- 在“库”页签中，点击“添加文件”，选择`gaussdbjdbc.jar`文件，点击“找到类”以识别驱动类。
16
+### 1.3 配置驱动
24 17
18
+1. 打开 DBeaver，选择 **“数据库”** -> **“驱动管理器”**，点击 **“新建”**。
19
+2. 在 **“设置”** 页签中：
20
+ - 输入驱动名称（如 **“GaussDB”**）。
21
+ - 选择驱动类型为 **“Generic”**。
22
+ - 填写类名为 `com.huawei.gaussdb.jdbc.Driver`。
23
+ - URL 模板为空。
24
+ - 默认端口为 `8000`。
25
+3. 在 **“库”** 页签中：
26
+ - 点击 **“添加文件”**，选择 `gaussdbjdbc.jar` 文件。
27
+ - 点击 **“找到类”** 以识别驱动类。
25 28
26 29
![image-20250409161636762](./uploads/Home/gaussdb_1.png)
27 30
28
-![image-20250409161738656](./uploads/Home/gaussdb_2.png)
29 31
30
- 4. 创建数据库连接
32
+![image-20250409161636762](./uploads/Home/gaussdb_2.png)
33
+
34
+### 1.4 创建数据库连接
31 35
32
-- 在DBeaver主界面，点击“新建数据库连接”，选择刚才配置的“GaussDB”驱动，点击“下一步”。
36
+1. 在 DBeaver 主界面，点击 **“新建数据库连接”**，选择刚才配置的 **“GaussDB”** 驱动，点击 **“下一步”**。
37
+2. 输入数据库的主机 IP 地址、端口（通常是 `8000`）、数据库名、用户名和密码。
38
+3. 点击 **“测试连接”**，若显示 **“已连接”**，则说明连接成功，点击 **“完成”**。
33 39
34
-- 输入数据库的主机IP地址、端口（通常是`8000`）、数据库名、用户名和密码。
40
+![image-20250409161636762](./uploads/Home/gaussdb_3.png)
35 41
36
-- 点击“测试连接”，若显示“已连接”，则说明连接成功，点击“完成”。
42
+### 1.5 使用 DBeaver 操作数据库
37 43
38
- ![image-20250409161828110](./uploads/Home/gaussdb_3.png)
44
+连接成功后，您可以在 DBeaver 中浏览数据库结构、执行 SQL 查询、导入导出数据等。如果在连接过程中遇到问题，可以参考 GaussDB 的官方文档或 DBeaver 的官方文档。
39 45
40
- 5. 使用DBeaver操作数据库
41
-
42
-连接成功后，可以在DBeaver中浏览数据库结构、执行SQL查询、导入导出数据等。
43
-如果在连接过程中遇到问题，可以参考高斯数据库的官方文档或DBeaver的官方文档。
46
+---
44 47
48
+## 2. GaussDB Maven 驱动下载
45 49
46
- 6. GaussDB Maven驱动下载
50
+### 2.1 GaussDB 驱动
47 51
48
-**1. GaussDB驱动**
49
-下载地址:[http://192.168.168.156:8081/repository/maven-releases/com/huawei/gaussdb/gaussdbjdbc/5.0.0/gaussdbjdbc-5.0.0.jar](http://192.168.168.156:8081/repository/maven-releases/com/huawei/gaussdb/gaussdbjdbc/5.0.0/gaussdbjdbc-5.0.0.jar)
52
+下载地址：
53
+[http://192.168.168.156:8081/repository/maven-releases/com/huawei/gaussdb/gaussdbjdbc/5.0.0/gaussdbjdbc-5.0.0.jar](http://192.168.168.156:8081/repository/maven-releases/com/huawei/gaussdb/gaussdbjdbc/5.0.0/gaussdbjdbc-5.0.0.jar)
50 54
55
+Maven 依赖配置：
51 56
```xml
52
- <dependency>
53
- <groupId>com.huawei.gaussdb</groupId>
54
- <artifactId>gaussdbjdbc</artifactId>
55
- <version>5.0.0</version>
56
- </dependency>
57
+<dependency>
58
+ <groupId>com.huawei.gaussdb</groupId>
59
+ <artifactId>gaussdbjdbc</artifactId>
60
+ <version>5.0.0</version>
61
+</dependency>
57 62
```
58 63
64
+### 2.2 dbcp.properties 示例
59 65
60
-**2. dbcp.properties 示例:**
61 66
```yaml
62
-########DBCP##########
67
+######## DBCP ##########
63 68
64
-########gaussdb iiot########
69
+######## GaussDB iiot ########
65 70
driverClassName=com.huawei.gaussdb.jdbc.Driver
66 71
url=jdbc:gaussdb://ip:8000,ip:8000,ip:8000/tpcc?currentSchema=snest_changwen&autoBalance=true&refreshCNIpListTime=3&prepareThreshold=1&batchMode=on&fetchsize=10&loggerLevel=OFF
67 72
username=***
... ...
@@ -69,7 +74,6 @@ password=***
69 74
validationQuery=SELECT 1
70 75
gaussdbDeployment=Distributed
71 76
72
-
73 77
initialSize=5
74 78
maxActive=30
75 79
minIdle=5
... ...
@@ -84,41 +88,35 @@ poolPreparedStatements: true
84 88
maxOpenPreparedStatements: 20
85 89
connectionProperties:druid.stat.sql.MaxSize=100;
86 90
87
-
88
-
89
-########oceanbase########
90
-#driverClassName=com.mysql.cj.jdbc.Driver
91
-#url=jdbc:mysql://ip:2881/snest_changwen?rewriteBatchedStatements=TRUE&allowMultiQueries=TRUE&useLocalSessionState=TRUE&useUnicode=TRUE&characterEncoding=utf-8&socketTimeout=10000&connectTimeout=30000&zeroDateTimeBehavior=convertToNull&allowPublicKeyRetrieval=true
92
-#username=***
93
-#password=***
94
-
95
-
96
-
97
-########Oracle########
98
-#driverClassName=oracle.jdbc.OracleDriver
99
-#url=jdbc:oracle:thin:@ip:1521:ORCLCDB
100
-#username=C##***
101
-#password=***
102
-#validationQuery=SELECT 'x' FROM DUAL
103
-
104
-
105
-########postgresql########
106
-#driverClassName=org.postgresql.Driver
107
-#url=jdbc:postgresql://ip:5432/postgres?currentSchema=snest_changwen&encoding=UTF-8&timezone=UTC
108
-#username=***
109
-#password=***
110
-#validationQuery=SELECT 1
111
-
112
-
91
+######## OceanBase ########
92
+# driverClassName=com.mysql.cj.jdbc.Driver
93
+# url=jdbc:mysql://ip:2881/snest_changwen?rewriteBatchedStatements=TRUE&allowMultiQueries=TRUE&useLocalSessionState=TRUE&useUnicode=TRUE&characterEncoding=utf-8&socketTimeout=10000&connectTimeout=30000&zeroDateTimeBehavior=convertToNull&allowPublicKeyRetrieval=true
94
+# username=***
95
+# password=***
96
+
97
+######## Oracle ########
98
+# driverClassName=oracle.jdbc.OracleDriver
99
+# url=jdbc:oracle:thin:@ip:1521:ORCLCDB
100
+# username=C##***
101
+# password=***
102
+# validationQuery=SELECT 'x' FROM DUAL
103
+
104
+######## PostgreSQL ########
105
+# driverClassName=org.postgresql.Driver
106
+# url=jdbc:postgresql://ip:5432/postgres?currentSchema=snest_changwen&encoding=UTF-8&timezone=UTC
107
+# username=***
108
+# password=***
109
+# validationQuery=SELECT 1
113 110
```
114 111
112
+---
115 113
116
-## 7. GaussDB环境配置示例
114
+## 3. GaussDB 环境配置示例
117 115
118
-**1. dbcp.properties 示例:**
119
-```properties
116
+### 3.1 dbcp.properties 示例
120 117
121
-########DBCP##########
118
+```properties
119
+######## DBCP ##########
122 120
initialSize=5
123 121
maxActive=2000
124 122
minIdle=5
... ...
@@ -134,22 +132,19 @@ maxOpenPreparedStatements: 20
134 132
connectionProperties:druid.stat.sql.MaxSize=100;
135 133
keepAlive=true
136 134
137
-
138
-########gaussdb########
135
+######## GaussDB ########
139 136
driverClassName=com.huawei.gaussdb.jdbc.Driver
140 137
url=jdbc:gaussdb://127.0.0.1:8000,127.0.0.1:8000,127.0.0.1:8000/tpcc?currentSchema=snest_jichen&autoBalance=true&refreshCNIpListTime=3&prepareThreshold=1&batchMode=on&fetchsize=10&loggerLevel=OFF
141 138
username=******
142 139
password=******
143 140
validationQuery=SELECT 1
144 141
gaussdbDeployment=Distributed
145
-
146 142
```
147 143
144
+### 3.2 Spring 配置文件适配
148 145
149
-**2. spring配置文件添加参数适配高斯自定义SQL列字段别名转换**
146
+在 `application-dev.properties` 文件中添加以下参数，以适配 GaussDB 自定义 SQL 列字段别名转换：
150 147
151
-application-dev.properties添加:
152
-```
148
+```properties
153 149
orm.sql.wrap_camelcase_alias=true
154
-
155
-```
... ...
\ No newline at end of file
0
+```