Skip to content

Latest commit

 

History

History
229 lines (195 loc) · 8.5 KB

installation.MD

File metadata and controls

229 lines (195 loc) · 8.5 KB

datasource 插件安装

  1. 将插件、数据库驱动 放到 <NACOS_HOME>/plugins 目录
io.github.bes2008.solution.nacosplugins:nacosplugin-all:jar:VERSION
  1. 在application.properties中配置数据库

以postgresql 数据库为例，修改 <NACOS_HOME>/conf/application.properties ：

# PostgreSQL
spring.sql.init.platform=postgresql
db.num=1
db.url.0=jdbc:postgresql://localhost:5432/db1?currentSchema=nacos
db.user.0=postgresql
db.password.0=postgresql
db.pool.config.driverClassName=org.postgresql.Driver
  1. 初始数据库schema

使用DBeaver、 数据库 CLI 等工具，连接到数据库，执行相关schema初始化。脚本位置：

代码仓库的nacosplugin-datasource-sqlscripts/resources/sql/ 目录下
  1. 启动nacos访问

自定义配置

为了更好的适配各种数据为库，插件提供了如下自定义配置：

  • spring.sql.plugin.builtin.enabled: 是否启用内置的datasource插件，只针对于 derby, mysql数据库，默认值为 true。nacos介质中默认提供了 derby, mysql 的mapper。如果你不想使用默认的mapper或者nacos提供的 mapper 有bug时，可以将该配置设置为 false。
  • db.sql.identifier.quoted.mode: 指定创建数据库表的DDL语句中，使用的表名、字段名使用引号的情况。每个数据库的情况并不统一，本插件会根据 nacosplugin-datasource-sqlscript模拟中提供的ddl脚本，指定默认值，当没有使用nacosplugin-datasource-sqlscript提供的ddl脚本时，可能需要配置。可选值有3个：
    • QUOTED：代表了所有的表名、字段都使用了引号。
    • UNQUOTED：代表了所有的表名、字段都没有使用引号。
    • MIXED：代表了表名、字段名，有的使用了引号，有的没有使用引号。
  • db.sql.compatibility.type：指定数据库所采用的兼容模式，目前主要解决兼容ORACLE模式时，会自动将 '' 设定为 NULL的情况。从功能上来看，主要解决的是Oracle兼容模式下，在nacos的public租户下创建配置，查询不到的情况。如果不会在nacos的public租户下创建配置时，可以不关注该配置。默认情况下，也都根据数据库本身的默认兼容模式做了配置。可选值有：
    • oracle：当创建数据库时，指定兼容了Oracle模式时。
    • postgresql: 当创建数据库时，指定兼容了postgresql (简称PG) 模式时。
    • mysql: 当创建数据库时，指定兼容了 mysql 模式时。
    • sqlserver: 当创建数据库时，指定兼容了 sqlserver 模式时。
    • teradata: 当创建数据库时，指定兼容了 teradata 模式时。

数据库支持

PostgreSQL

  1. postgresql 相关依赖要放全，且要与服务端兼容，建议 >= 42.2.0 版本。
  2. 使用Oracle JDK 8，使用 OpenJDK 8可能会遇到 PostgreSQL SCRAM 认证相关问题
  3. 驱动下载地址
  4. JDBC 配置
# PostgreSQL
spring.sql.init.platform=postgresql
db.num=1
db.url.0=jdbc:postgresql://localhost:5432/db1?currentSchema=nacos
db.user.0=postgresql
db.password.0=postgresql
db.pool.config.driverClassName=org.postgresql.Driver

DM

  1. jdbc驱动选择：
+ 在JDK8上运行时，选择：com.dameng:DmJdbcDriver18:8.1.3.140
+ 在JDK7上运行时，选择：com.dameng:DmJdbcDriver17:8.1.3.140
+ 在JDK6上运行时，选择：com.dameng:DmJdbcDriver16:8.1.3.140
  1. SQL脚本的执行

使用 DBeaver 连接到达梦数据库上时，一次只能执行一条SQL语句。

想要执行SQL脚本文件，需要提供的命令行工具：${dmdbms}/disql

./disql SYSDBA/dameng777@localhost:5236 \`./create-schema.sql
./disql SYSDBA/dameng777@localhost:5236 \`./create-tables.sql
  1. JDBC 配置
# DM
spring.sql.init.platform=dm
db.num=1
db.url.0=jdbc:dm://localhost:5236?schema=nacos
db.user.0=SYSDBA
db.password.0=dameng777
db.pool.config.driverClassName=dm.jdbc.driver.DmDriver
  1. 注意事项
1） 要指定数据库忽略大小写

Kingbase

  1. jdbc配置
spring.sql.init.platform=kingbase
db.num=1
db.url.0=jdbc:kingbase8://localhost:5432/theDb?currentSchema=nacos&clientEncoding=utf8
db.user.0=username
db.password.0=thePassword
db.pool.config.driverClassName=com.kingbase8.Driver

magicdata

  1. jdbc配置
spring.sql.init.platform=magicdata
db.num=1
db.url.0=jdbc:besmagicdata://localhost:3660/theDb?currentSchema=nacos&clientEncoding=utf8
db.user.0=username
db.password.0=thePassword
db.pool.config.driverClassName=com.bes.magicdata.Driver
# 需要根据实际情况配置，对于magicdata默认配置为 oracle
db.sql.compatibility.type=postgresql

SqlServer

  1. jdbc 驱动选择： 参考微软官方说明，建议选择12.4.1版本
  2. 使用database而不是schema
在SqlServer中，每个Database都会默认创建一堆固定的schema，执行sql时，默认就会使用一个名为 dbo的schema。
虽然也可以通过SQL方式创建 自定义的schema，但无法在session中指定默认schema的，所以不要使用schema，而是使用database。
  1. jdbc 配置
# SqlServer
spring.sql.init.platform=sqlserver
db.num=1
db.url.0=jdbc:sqlserver://localhost:1433;databaseName=nacos;encrypt=false
db.user.0=sa
db.password.0=SA123456Pswd
db.pool.config.driverClassName=com.microsoft.sqlserver.jdbc.SQLServerDriver

MySQL

  1. schema初始化
mysql --password=root_password --host=localhost --port=3306 --user root < create_schema.sql
mysql --password=root_password --host=localhost --port=3306 --user root < create_tables.sql
  1. JDBC配置
# MySQL
spring.sql.init.platform=mysql
db.num=1
db.url.0=jdbc:mysql://localhost:3306/nacos?characterEncoding=utf8&connectTimeout=1000&socketTimeout=30000&autoReconnect=true&useUnicode=true&useSSL=false&serverTimezone=UTC&allowPublicKeyRetrieval=true&useServerPrepStmts=true&allowPublicKeyRetrieval=true
db.user.0=root
db.password.0=root_password
db.pool.config.driverClassName=com.mysql.cj.jdbc.Driver
# mysql默认使用nacos 内置的mysql插件，如果要禁用内置mysql插件，可以添加下面的配置
spring.sql.plugin.builtin.enabled=false
  1. 版本限制
nacos_version >= 2.3.0 时，支持将mysql替换为本插件。

Oracle

  1. 脚本执行
# 先用 system 创建 "C##NACOS" 用户
sqlplus system/Oracle123_Pswd@localhost:1521/FREE @./create-schema.sql
# 再用 "C##NACOS" 用户创建表
sqlplus C##NACOS/NACOS_PASSWORD@localhost:1521/FREE @./create-tables.sql
  1. jdbc配置
# Oracle
spring.sql.init.platform=oracle
db.num=1
# 在oracle中，schema就是用户名，所以不需要另外指定schema
db.url.0=jdbc:oracle:thin:@//localhost:1521/FREE
db.user.0=C##NACOS
db.password.0=NACOS_PASSWORD
db.pool.config.driverClassName=oracle.jdbc.OracleDriver
  1. 目前使用Oracle的问题
  • 目前nacos 适配Oracle已完毕，但在启动过程中，nacos.log中会有报错，这个错误并不影响 oracle 数据库上使用。
    • 问题原因：是 nacos 启动是会判定 config_info_tag, config_info_beta表是否存在。 这个方法是直接定死的使用了limit 1，没有通过插件的方式。
    • 问题归属：这个属于 nacos 的Bug，已在 github 上提交了相关问题。
    • 问题版本：<=2.4.1，已于 nacos 2.4.2 版本修复
    • 影响范围：只会影响到dump接口，功能不受影响

Derby

  1. 配置
# derby 默认使用 nacos 内置的 derby 插件，如果要禁用内置 derby 插件，可以添加下面的配置
spring.sql.plugin.builtin.enabled=false
  1. 启动
# 必须以 standalone 模式启动时，且不配置为其它数据库的情况下，才会启用 derby数据库
<NACOS_HOME>/bin/startup.sh -m standalone
  1. 版本限制
nacos_version >= 2.3.0 时，支持将 derby 替换为本插件。

OpenGauss

  1. 配置
# OpenGauss
spring.sql.init.platform=opengauss
#spring.sql.plugin.builtin.enabled=false
db.num=1
db.url.0=jdbc:postgresql://localhost:15432/postgres?currentSchema=gaussdb&reWriteBatchedInserts=true
db.user.0=gaussdb
db.password.0=thePassword@123
db.pool.config.driverClassName=org.postgresql.Driver
# 需要根据实际情况配置，对于OpenGauss默认配置为 oracle
db.sql.compatibility.type=postgresql