gaussdb-guide.md
... ...
@@ -0,0 +1,132 @@
1
+GaussDB参考手册
2
+
3
+
4
+## 1. DBeaver客户端连接高斯数据库
5
+**操作步骤**
6
+
7
+1.以下是使用DBeaver客户端连接高斯数据库（GaussDB）的详细步骤：
8
+
9
+1. 获取驱动包
10
+根据高斯数据库的版本，下载对应版本的驱动包。
11
+解压驱动包，找到gaussdbjdbc.jar文件。
12
+2. 安装DBeaver客户端
13
+访问DBeaver官网，下载适合操作系统的安装包并完成安装。
14
+3. 配置驱动
15
+打开DBeaver，选择“数据库”->“驱动管理器”，点击“新建”。
16
+
17
+在“设置”页签中，输入驱动名称（如“GaussDB”），选择驱动类型为“Generic”，填写类名为com.huawei.gaussdb.jdbc.Driver，URL模板为空，默认端口为8000。
18
+
19
+在“库”页签中，点击“添加文件”，选择gaussdbjdbc.jar文件，点击“找到类”以识别驱动类。
20
+
21
+image-20250409161636762
22
+
23
+image-20250409161738656
24
+
25
+4. 创建数据库连接
26
+在DBeaver主界面，点击“新建数据库连接”，选择刚才配置的“GaussDB”驱动，点击“下一步”。
27
+
28
+输入数据库的主机IP地址、端口（通常是8000）、数据库名、用户名和密码。
29
+
30
+点击“测试连接”，若显示“已连接”，则说明连接成功，点击“完成”。
31
+
32
+image-20250409161828110
33
+
34
+5. 使用DBeaver操作数据库
35
+连接成功后，可以在DBeaver中浏览数据库结构、执行SQL查询、导入导出数据等。
36
+如果在连接过程中遇到问题，可以参考高斯数据库的官方文档或DBeaver的官方文档。
37
+
38
+6. GaussDB Maven驱动下载
39
+1. GaussDB驱动 下载地址:http://192.168.168.156:8081/repository/maven-releases/com/huawei/gaussdb/gaussdbjdbc/5.0.0/gaussdbjdbc-5.0.0.jar
40
+
41
+ <dependency>
42
+ <groupId>com.huawei.gaussdb</groupId>
43
+ <artifactId>gaussdbjdbc</artifactId>
44
+ <version>5.0.0</version>
45
+ </dependency>
46
+2. dbcp.properties 示例:
47
+
48
+########DBCP##########
49
+
50
+########gaussdb iiot########
51
+driverClassName=com.huawei.gaussdb.jdbc.Driver
52
+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
53
+username=***
54
+password=***
55
+validationQuery=SELECT 1
56
+gaussdbDeployment=Distributed
57
+
58
+
59
+initialSize=5
60
+maxActive=30
61
+minIdle=5
62
+maxWait=6000
63
+filters=stat
64
+timeBetweenEvictionRunsMillis=60000
65
+minEvictableIdleTimeMillis=300000
66
+testOnBorrow=false
67
+testOnReturn=false
68
+testWhileIdle=true
69
+poolPreparedStatements: true
70
+maxOpenPreparedStatements: 20
71
+connectionProperties:druid.stat.sql.MaxSize=100;
72
+
73
+
74
+
75
+########oceanbase########
76
+#driverClassName=com.mysql.cj.jdbc.Driver
77
+#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
78
+#username=***
79
+#password=***
80
+
81
+
82
+
83
+########Oracle########
84
+#driverClassName=oracle.jdbc.OracleDriver
85
+#url=jdbc:oracle:thin:@ip:1521:ORCLCDB
86
+#username=C##***
87
+#password=***
88
+#validationQuery=SELECT 'x' FROM DUAL
89
+
90
+
91
+########postgresql########
92
+#driverClassName=org.postgresql.Driver
93
+#url=jdbc:postgresql://ip:5432/postgres?currentSchema=snest_changwen&encoding=UTF-8&timezone=UTC
94
+#username=***
95
+#password=***
96
+#validationQuery=SELECT 1
97
+
98
+## 2. GaussDB环境配置示例
99
+
100
+1. dbcp.properties 示例:
101
+
102
+
103
+########DBCP##########
104
+initialSize=5
105
+maxActive=2000
106
+minIdle=5
107
+filters=stat
108
+maxWait=6000
109
+timeBetweenEvictionRunsMillis=60000
110
+minEvictableIdleTimeMillis=1800000
111
+testOnBorrow=false
112
+testOnReturn=false
113
+testWhileIdle=true
114
+poolPreparedStatements: true
115
+maxOpenPreparedStatements: 20
116
+connectionProperties:druid.stat.sql.MaxSize=100;
117
+keepAlive=true
118
+
119
+
120
+########gaussdb########
121
+driverClassName=com.huawei.gaussdb.jdbc.Driver
122
+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
123
+username=******
124
+password=******
125
+validationQuery=SELECT 1
126
+gaussdbDeployment=Distributed
127
+2. spring配置文件添加参数适配高斯自定义SQL列字段别名转换
128
+
129
+application-dev.properties添加:
130
+
131
+orm.sql.wrap_camelcase_alias=true
132
+