简介 #
YAML 提供通过配置文件的方式与 DBPlusEngine-Driver 交互。 配合治理模块一同使用时，持久化在配置中心的配置均为 YAML 格式。
说明： YAML 配置文件支持配置内容超过 3MB。
YAML 配置是最常见的配置方式，可以省略编程的复杂度，简化用户配置。
使用步骤 #
引入 Maven 依赖 #
<dependency>
<groupId>org.apache.shardingsphere</groupId>
<artifactId>shardingsphere-jdbc-core</artifactId>
<version>${shardingsphere.version}</version>
</dependency>
配置 YAML #
DBPlusEngine-Driver 的 YAML 配置文件通过 Schema 名称、运行模式、数据源集合、规则集合以及属性配置组成。
# JDBC 中的数据源的别名。在集群模式，使用该参数联通 DBPlusEngine-Driver 与 DBPlusEngine-Proxy 共同使用。
# 默认值：logic_db
schemaName (?):
mode:
dataSources:
rules:
- !FOO_XXX
...
- !BAR_XXX
...
props:
key_1: value_1
key_2: value_2
模式详情请参见模式配置。
数据源详情请参见数据源配置。
规则详情请参见规则配置。
构建数据源 #
通过 YamlShardingSphereDataSourceFactory 工厂创建的 ShardingSphereDataSource 实现自 JDBC 的标准接口 DataSource。
File yamlFile = // 指定 YAML 文件路径
DataSource dataSource = YamlShardingSphereDataSourceFactory.createDataSource(yamlFile);
使用数据源 #
使用方式同 Java API。
语法说明 #
!! 表示实例化该类
! 表示自定义别名
- 表示可以包含一个或多个
[] 表示数组，可以与减号相互替换使用