Proxy 启动

启动步骤

  1. 下载 ShardingSphere-Proxy 的最新发行版。
  2. 如果使用 docker,可以执行 docker pull shardingsphere/shardingsphere-proxy 获取镜像。详细信息请参考Docker镜像
  3. 解压缩后修改 conf/server.yaml和以 config- 前缀开头的文件,如:conf/config-xxx.yaml 文件,进行分片规则、读写分离规则配置。配置方式请参考配置手册
  4. Linux 操作系统请运行 bin/start.sh,Windows 操作系统请运行 bin/start.bat 启动 ShardingSphere-Proxy。如需配置启动端口、配置文件位置,可参考快速入门

使用 PostgreSQL

  1. 使用任何 PostgreSQL 的客户端连接。如: psql -U root -h 127.0.0.1 -p 3307

使用 MySQL/openGauss

  1. 将 MySQL/openGauss 的 JDBC 驱动程序复制至目录 ext-lib/
  2. 使用任何 MySQL/openGauss 的客户端连接。如: mysql -u root -h 127.0.0.1 -P 3307gsql

使用自定义分片算法

当用户需要使用自定义的分片算法类时,无法再通过简单的行表达式在 YAML 文件进行配置。可通过以下方式配置使用自定义分片算法。

  1. 实现 ShardingAlgorithm 接口定义的算法实现类。
  2. 将上述 Java 文件打包成 jar 包。
  3. 将上述 jar 包拷贝至 ShardingSphere-Proxy 解压后的 ext-lib/ 目录。
  4. 将上述自定义算法实现类的 Java 文件引用配置在 YAML 文件中,具体可参考配置规则

注意事项

  1. ShardingSphere-Proxy 默认使用 3307 端口,可以通过启动脚本追加参数作为启动端口号。如: bin/start.sh 3308
  2. ShardingSphere-Proxy 使用 conf/server.yaml 配置注册中心、认证信息以及公用属性。
  3. ShardingSphere-Proxy 支持多逻辑数据源,每个以 config- 前缀命名的 YAML 配置文件,即为一个逻辑数据源。