Proxy 启动
启动步骤
- 下载 ShardingSphere-Proxy 的最新发行版。
- 如果使用 docker,可以执行
docker pull shardingsphere/shardingsphere-proxy
获取镜像。详细信息请参考Docker镜像。 - 解压缩后修改
conf/server.yaml
和以config-
前缀开头的文件,如:conf/config-xxx.yaml
文件,进行分片规则、读写分离规则配置。配置方式请参考配置手册。 - Linux 操作系统请运行
bin/start.sh
,Windows 操作系统请运行bin/start.bat
启动 ShardingSphere-Proxy。如需配置启动端口、配置文件位置,可参考快速入门。
使用 PostgreSQL
- 使用任何 PostgreSQL 的客户端连接。如:
psql -U root -h 127.0.0.1 -p 3307
使用 MySQL
- 将 MySQL 的 JDBC 驱动程序复制至目录
ext-lib/
。 - 使用任何 MySQL 的客户端连接。如:
mysql -u root -h 127.0.0.1 -P 3307
使用自定义分片算法
当用户需要使用自定义的分片算法类时,无法再通过简单的行表达式在 YAML 文件进行配置。可通过以下方式配置使用自定义分片算法。
- 实现
ShardingAlgorithm
接口定义的算法实现类。 - 将上述 Java 文件打包成 jar 包。
- 将上述 jar 包拷贝至 ShardingSphere-Proxy 解压后的
conf/lib-ext
目录。 - 将上述自定义算法实现类的 Java 文件引用配置在 YAML 文件中,具体可参考配置规则。
注意事项
- ShardingSphere-Proxy 默认使用 3307 端口,可以通过启动脚本追加参数作为启动端口号。如:
bin/start.sh 3308
- ShardingSphere-Proxy 使用
conf/server.yaml
配置注册中心、认证信息以及公用属性。 - ShardingSphere-Proxy 支持多逻辑数据源,每个以
config-
前缀命名的 YAML 配置文件,即为一个逻辑数据源。