linghengqian commented on code in PR #37735: URL: https://github.com/apache/shardingsphere/pull/37735#discussion_r2688948874
########## docs/document/content/user-manual/shardingsphere-jdbc/optional-plugins/_index.en.md: ########## @@ -8,51 +8,57 @@ Implemented plugins are not included. Retrievable at https://central.sonatype.co SPI and existing implementation classes of SPI corresponding to all plugins can be retrieved at https://shardingsphere.apache.org/document/current/cn/dev-manual/. -All the built-in plugins for ShardingSphere-JDBC are listed below in the form of 'groupId:artifactId'. +If `org.apache.shardingsphere:shardingsphere-jdbc` requires optional plugins, you need to download the JAR containing its SPI implementation and its dependencies from Maven Central. -- `org.apache.shardingsphere:shardingsphere-authority-core`, the user authority to load the logical core -- `org.apache.shardingsphere:shardingsphere-cluster-mode-core`, the persistent definition core of cluster mode configuration information -- `org.apache.shardingsphere:shardingsphere-db-discovery-core`, high availability core -- `org.apache.shardingsphere:shardingsphere-encrypt-core`, data encryption core -- `org.apache.shardingsphere:shardingsphere-infra-context`, the kernel operation and metadata refresh mechanism of Context -- `org.apache.shardingsphere:shardingsphere-mask-core`, data masking core -- `org.apache.shardingsphere:shardingsphere-database-exception-mysql`, MySQL implementation of database gateway -- `org.apache.shardingsphere:shardingsphere-parser-core`, SQL parsing core -- `org.apache.shardingsphere:shardingsphere-database-exception-postgresql`, PostgreSQL implementation of database -- `org.apache.shardingsphere:shardingsphere-readwrite-splitting-core`, read-write splitting core -- `org.apache.shardingsphere:shardingsphere-shadow-core`, shadow library core -- `org.apache.shardingsphere:shardingsphere-sharding-core`, data sharding core -- `org.apache.shardingsphere:shardingsphere-single-core`, single-table (only the only table that exists in all sharded data sources) core -- `org.apache.shardingsphere:shardingsphere-sql-federation-core`, federation query executor core -- `org.apache.shardingsphere:shardingsphere-sql-parser-mysql`, MySQL dialect implementation of SQL parsing -- `org.apache.shardingsphere:shardingsphere-sql-parser-postgresql`, PostgreSQL dialect implementation of SQL parsing -- `org.apache.shardingsphere:shardingsphere-sql-parser-opengauss`, OpenGauss dialect implementation of SQL parsing -- `org.apache.shardingsphere:shardingsphere-sql-parser-oracle`, Oracle dialect implementation of SQL parsing -- `org.apache.shardingsphere:shardingsphere-sql-parser-sqlserver`, SQL Server dialect implementation of SQL parsing -- `org.apache.shardingsphere:shardingsphere-sql-parser-doris`， Doris dialect implementation of SQL parsing -- `org.apache.shardingsphere:shardingsphere-sql-parser-presto`， Presto dialect implementation of SQL parsing -- `org.apache.shardingsphere:shardingsphere-sql-parser-sql92`,the SQL 92 dialect implementation of SQL parsing -- `org.apache.shardingsphere:shardingsphere-standalone-mode-core`, the persistence definition core of single-machine mode configuration information -- `org.apache.shardingsphere:shardingsphere-standalone-mode-repository-jdbc-h2`, H2 implementation of persistent definition of configuration information in stand-alone mode -- `org.apache.shardingsphere:shardingsphere-traffic-core`, traffic governance core -- `org.apache.shardingsphere:shardingsphere-transaction-core`, XA Distributed Transaction Manager Core +The following lists all optional plugins in the format of `groupId:artifactId`. -If ShardingSphere-JDBC needs to use optional plugins, you need to download the JAR containing its SPI implementation and its dependent JARs from Maven Central. - -All optional plugins are listed below in the form of `groupId:artifactId`. - -- Cluster mode configuration information persistence definition - - `org.apache.shardingsphere:shardingsphere-cluster-mode-repository-zookeeper`, Zookeeper based persistence - - `org.apache.shardingsphere:shardingsphere-cluster-mode-repository-etcd`, Etcd based persistence -- XA transaction manager provider definition - - `org.apache.shardingsphere:shardingsphere-transaction-xa-narayana`, XA distributed transaction manager based on Narayana -- Row Value Expressions definition - - `org.apache.shardingsphere:shardingsphere-infra-expr-espresso`，Row Value Expressions that uses the Groovy syntax based on GraalVM Truffle's Espresso implementation -- Database type identification - - `org.apache.shardingsphere:shardingsphere-infra-database-hive`, Adaptation of jdbcURL for `JDBC support` of Hive, and metadata loading implementation - - `org.apache.shardingsphere:shardingsphere-infra-database-presto`, Adaptation of jdbcURL for `JDBC support` of Presto, and metadata loading implementation -- SQL parsing - - `org.apache.shardingsphere:shardingsphere-parser-sql-engine-clickhouse`, ClickHouse dialect implementation of SQL parsing - - `org.apache.shardingsphere:shardingsphere-parser-sql-engine-hive`， Hive dialect implementation of SQL parsing +- Database dialect adaptation + - `org.apache.shardingsphere:shardingsphere-jdbc-dialect-postgresql`, dialect and compatibility adaptation for Postgres + - `org.apache.shardingsphere:shardingsphere-jdbc-dialect-mysql`, dialect and compatibility adaptation for MySQL + - `org.apache.shardingsphere:shardingsphere-jdbc-dialect-sqlserver`, dialect and compatibility adaptation for MS SQL Server + - `org.apache.shardingsphere:shardingsphere-jdbc-dialect-mariadb`, dialect and compatibility adaptation for MariaDB + - `org.apache.shardingsphere:shardingsphere-jdbc-dialect-presto`, dialect and compatibility adaptation for Presto + - `org.apache.shardingsphere:shardingsphere-jdbc-dialect-oracle`, dialect and compatibility adaptation for Oracle Database Free and Oracle-XE + - `org.apache.shardingsphere:shardingsphere-jdbc-dialect-firebird`, dialect and compatibility adaptation for Firebird + - `org.apache.shardingsphere:shardingsphere-jdbc-dialect-clickhouse`, dialect and compatibility adaptation for Clickhouse + - `org.apache.shardingsphere:shardingsphere-jdbc-dialect-opengauss`, dialect and compatibility adaptation for openGauss + - `org.apache.shardingsphere:shardingsphere-jdbc-dialect-doris`, dialect and compatibility adaptation for Doris FE + - `org.apache.shardingsphere:shardingsphere-jdbc-dialect-hive`, dialect and compatibility adaptation for HiveServer2 +- Data Source Connection Pool + - `org.apache.shardingsphere:shardingsphere-infra-data-source-pool-hikari`, provides connection pool creation and property adaptation implementation for `dataSources.<data_source_name>.dataSourceClassName=com.zaxxer.hikari.HikariDataSource` +- Permissions and authentication implementation + - `org.apache.shardingsphere:shardingsphere-authority-simple`, provides permission and authentication implementation with `authority.privilege.type=ALL_PERMITTED` + - `org.apache.shardingsphere:shardingsphere-authority-simple`, provides permission and authentication implementation with `authority.privilege.type=DATABASE_PERMITTED` Review Comment: Fixed. ########## docs/document/content/user-manual/shardingsphere-jdbc/optional-plugins/_index.cn.md: ########## @@ -7,52 +7,57 @@ ShardingSphere 默认情况下仅包含核心 SPI 的实现，在 Git Source 存 实现的插件未包含在内。可在 https://central.sonatype.com/ 进行检索。 所有插件对应的 SPI 和 SPI 的已有实现类均可在 https://shardingsphere.apache.org/document/current/cn/dev-manual/ 检索。 - -下以 `groupId:artifactId` 的表现形式列出 ShardingSphere-JDBC 所有的内置插件。 - -- `org.apache.shardingsphere:shardingsphere-authority-core`，用户权限加载逻辑核心 -- `org.apache.shardingsphere:shardingsphere-cluster-mode-core`，集群模式配置信息持久化定义核心 -- `org.apache.shardingsphere:shardingsphere-db-discovery-core`，高可用核心 -- `org.apache.shardingsphere:shardingsphere-encrypt-core`，数据加密核心 -- `org.apache.shardingsphere:shardingsphere-infra-context`， Context 的内核运行与元数据刷新机制 -- `org.apache.shardingsphere:shardingsphere-mask-core`，数据脱敏核心 -- `org.apache.shardingsphere:shardingsphere-database-exception-mysql`， 数据库网关的 MySQL 实现 -- `org.apache.shardingsphere:shardingsphere-parser-core`， SQL 解析核心 -- `org.apache.shardingsphere:shardingsphere-database-exception-postgresql`，数据库网关的 PostgreSQL 实现 -- `org.apache.shardingsphere:shardingsphere-readwrite-splitting-core`，读写分离核心 -- `org.apache.shardingsphere:shardingsphere-shadow-core`，影子库核心 -- `org.apache.shardingsphere:shardingsphere-sharding-core`，数据分片核心 -- `org.apache.shardingsphere:shardingsphere-single-core`，单表（所有的分片数据源中仅唯一存在的表）核心 -- `org.apache.shardingsphere:shardingsphere-sql-federation-core`，联邦查询执行器核心 -- `org.apache.shardingsphere:shardingsphere-sql-parser-mysql`， SQL 解析的 MySQL 方言实现 -- `org.apache.shardingsphere:shardingsphere-sql-parser-postgresql`， SQL 解析的 PostgreSQL 方言实现 -- `org.apache.shardingsphere:shardingsphere-sql-parser-opengauss`， SQL 解析的 OpenGauss 方言实现 -- `org.apache.shardingsphere:shardingsphere-sql-parser-oracle`， SQL 解析的 Oracle 方言解析实现 -- `org.apache.shardingsphere:shardingsphere-sql-parser-sqlserver`， SQL 解析的 SQL Server 方言实现 -- `org.apache.shardingsphere:shardingsphere-sql-parser-doris`， SQL 解析的 Doris 方言实现 -- `org.apache.shardingsphere:shardingsphere-sql-parser-presto`， SQL 解析的 Presto 方言实现 -- `org.apache.shardingsphere:shardingsphere-sql-parser-sql92`， SQL 解析的 SQL 92 方言实现 -- `org.apache.shardingsphere:shardingsphere-standalone-mode-core`，单机模式配置信息持久化定义核心 -- `org.apache.shardingsphere:shardingsphere-standalone-mode-repository-jdbc-h2`，单机模式配置信息持久化定义的 H2 实现 -- `org.apache.shardingsphere:shardingsphere-traffic-core`，流量治理核心 -- `org.apache.shardingsphere:shardingsphere-transaction-core`， XA 分布式事务管理器核心 - -如果 ShardingSphere-JDBC 需要使用可选插件，需要在 Maven Central 下载包含其 SPI 实现的 JAR 和其依赖的 JAR。 - -下以 `groupId:artifactId` 的表现形式列出所有的可选插件。 - -- 集群模式配置信息持久化定义 - - `org.apache.shardingsphere:shardingsphere-cluster-mode-repository-zookeeper`，基于 Zookeeper 的持久化实现 - - `org.apache.shardingsphere:shardingsphere-cluster-mode-repository-etcd`，基于 Etcd 的持久化实现 -- XA 分布式事务管理器 - - `org.apache.shardingsphere:shardingsphere-transaction-xa-narayana`，基于 Narayana 的 XA 分布式事务管理器 +如果 `org.apache.shardingsphere:shardingsphere-jdbc` 需要使用可选插件，需要在 Maven Central 下载包含其 SPI 实现的 JAR 和其依赖的 JAR。 + +下以 `groupId:artifactId` 的表现形式，列出所有可选插件。 + +- 数据库方言适配 + - `org.apache.shardingsphere:shardingsphere-jdbc-dialect-postgresql`，面向 Postgres 的方言与兼容性适配 + - `org.apache.shardingsphere:shardingsphere-jdbc-dialect-mysql`，面向 MySQL 的方言与兼容性适配 + - `org.apache.shardingsphere:shardingsphere-jdbc-dialect-sqlserver`，面向 MS SQL Server 的方言与兼容性适配 + - `org.apache.shardingsphere:shardingsphere-jdbc-dialect-mariadb`，面向 MariaDB 的方言与兼容性适配 + - `org.apache.shardingsphere:shardingsphere-jdbc-dialect-presto`，面向 Presto 的方言与兼容性适配 + - `org.apache.shardingsphere:shardingsphere-jdbc-dialect-oracle`，面向 Oracle Database Free 和 Oracle-XE 的方言与兼容性适配 + - `org.apache.shardingsphere:shardingsphere-jdbc-dialect-firebird`，面向 Firebird 的方言与兼容性适配 + - `org.apache.shardingsphere:shardingsphere-jdbc-dialect-clickhouse`，面向 Clickhouse 的方言与兼容性适配 + - `org.apache.shardingsphere:shardingsphere-jdbc-dialect-opengauss`，面向 openGauss 的方言与兼容性适配 + - `org.apache.shardingsphere:shardingsphere-jdbc-dialect-doris`，面向 Doris FE 的方言与兼容性适配 + - `org.apache.shardingsphere:shardingsphere-jdbc-dialect-hive`，面向 HiveServer2 的方言与兼容性适配 +- 数据源连接池 + - `org.apache.shardingsphere:shardingsphere-infra-data-source-pool-hikari`，提供 `dataSources.<data_source_name>.dataSourceClassName=com.zaxxer.hikari.HikariDataSource` 的连接池创建与属性适配实现 +- 权限与认证实现 + - `org.apache.shardingsphere:shardingsphere-authority-simple`，提供 `authority.privilege.type=ALL_PERMITTED` 的权限与认证实现 + - `org.apache.shardingsphere:shardingsphere-authority-simple`，提供 `authority.privilege.type=DATABASE_PERMITTED` 的权限与认证实现 Review Comment: Fixed. -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected]
