本节主要介绍如何通过二进制发布包启动 ShardingSphere-Proxy。
使用二进制发布包启动 Proxy,需要环境具备 Java JRE 8 或更高版本。
在下载页面获取。
conf/server.yaml
ShardingSphere-Proxy 运行模式在 server.yaml
中配置,配置格式与 ShardingSphere-JDBC 一致,请参考模式配置。
其他配置项请参考:
conf/config-*.yaml
修改 conf
目录下以 config-
前缀开头的文件,如:conf/config-sharding.yaml
文件,进行分片规则、读写分离规则配置。配置方式请参考配置手册。config-*.yaml
文件的 *
部分可以任意命名。
ShardingSphere-Proxy 支持配置多个逻辑数据源,每个以 config-
前缀命名的 YAML 配置文件,即为一个逻辑数据源。
如果后端连接 PostgreSQL 或 openGauss 数据库,不需要引入额外依赖。
如果后端连接 MySQL 数据库,请下载 mysql-connector-java-5.1.47.jar 或者 mysql-connector-java-8.0.11.jar,并将其放入 ext-lib
目录。
ShardingSphere-Proxy 默认集成 ZooKeeper Curator 客户端,集群模式使用 ZooKeeper 无须引入其他依赖。
如果集群模式使用 Etcd,需要将 Etcd 的客户端驱动程序 jetcd-core 0.5.0 复制至目录 ext-lib
。
与 ShardingSphere-JDBC 使用方式相同。 具体可参考分布式事务。
当用户需要使用自定义的算法类时,可通过以下方式配置使用自定义算法,以分片为例:
1. 实现 `ShardingAlgorithm` 接口定义的算法实现类。
2. 在项目 `resources` 目录下创建 `META-INF/services` 目录。
3. 在 `META-INF/services` 目录下新建文件 `org.apache.shardingsphere.sharding.spi.ShardingAlgorithm`
4. 将实现类的全限定类名写入至文件 `org.apache.shardingsphere.sharding.spi.ShardingAlgorithm`
5. 将上述 Java 文件打包成 jar 包。
6. 将上述 jar 包拷贝至 `ext-lib` 目录。
7. 将上述自定义算法实现类的 Java 文件引用配置在 YAML 文件中,具体可参考[配置规则](/cn/user-manual/shardingsphere-proxy/yaml-config/)。
Linux/macOS 操作系统请运行 bin/start.sh
,Windows 操作系统请运行 bin/start.bat
启动 ShardingSphere-Proxy。默认监听端口 3307
,默认配置目录为 Proxy 内的 conf
目录。启动脚本可以指定监听端口、配置文件所在目录,命令如下:
bin/start.sh [port] [/path/to/conf]
执行 MySQL / PostgreSQL / openGauss 的客户端命令直接操作 ShardingSphere-Proxy 即可。
使用 MySQL 客户端连接 ShardingSphere-Proxy:
mysql -h${proxy_host} -P${proxy_port} -u${proxy_username} -p${proxy_password}
使用 PostgreSQL 客户端连接 ShardingSphere-Proxy:
psql -h ${proxy_host} -p ${proxy_port} -U ${proxy_username}
使用 openGauss 客户端连接 ShardingSphere-Proxy:
gsql -r -h ${proxy_host} -p ${proxy_port} -U ${proxy_username} -W ${proxy_password}
完整配置请参考 ShardingSphere 仓库中的示例: https://github.com/apache/shardingsphere/tree/master/examples/shardingsphere-proxy-example