Narayana Transaction

Import Maven Dependency

  1. <properties>
  2.     <narayana.version>5.9.1.Final</narayana.version>
  3.     <jboss-transaction-spi.version>7.6.0.Final</jboss-transaction-spi.version>
  4.     <jboss-logging.version>3.2.1.Final</jboss-logging.version>
  5. </properties>
  7. <dependency>
  8.     <groupId>org.apache.shardingsphere</groupId>
  9.     <artifactId>shardingsphere-jdbc-core</artifactId>
  10.     <version>${shardingsphere.version}</version>
  11. </dependency>
  13. <!-- Import if using XA transaction -->
  14. <dependency>
  15.     <groupId>org.apache.shardingsphere</groupId>
  16.     <artifactId>shardingsphere-transaction-xa-core</artifactId>
  17.     <version>${shardingsphere.version}</version>
  18. </dependency>
  20. <dependency>
  21.     <groupId>org.apache.shardingsphere</groupId>
  22.     <artifactId>shardingsphere-transaction-xa-narayana</artifactId>
  23.     <version>${shardingsphere.version}</version>
  24. </dependency>
  25. <dependency>
  26.     <groupId>org.jboss.narayana.jta</groupId>
  27.     <artifactId>jta</artifactId>
  28.     <version>${narayana.version}</version>
  29. </dependency>
  30. <dependency>
  31.     <groupId>org.jboss.narayana.jts</groupId>
  32.     <artifactId>narayana-jts-integration</artifactId>
  33.     <version>${narayana.version}</version>
  34. </dependency>
  35. <dependency>
  36.     <groupId>org.jboss</groupId>
  37.     <artifactId>jboss-transaction-spi</artifactId>
  38.     <version>${jboss-transaction-spi.version}</version>
  39. </dependency>
  40. <dependency>
  41.     <groupId>org.jboss.logging</groupId>
  42.     <artifactId>jboss-logging</artifactId>
  43.     <version>${jboss-logging.version}</version>
  44. </dependency>

Customize Configuration Items

Add jbossts-properties.xml in classpath of the application to customize Narayana configuration.

Please refer to Narayana official documentation for more details.

Configure XA Transaction Manager Type

Yaml:

  1. - !TRANSACTION
  2.   defaultType: XA
  3.   providerType: Narayana

SpringBoot:

  1. spring:
  2.   shardingsphere:
  3.     props:
  4.       xa-transaction-manager-type: Narayana

Spring Namespace:

  1. <shardingsphere:data-source id="xxx" data-source-names="xxx" rule-refs="xxx">
  2.     <props>
  3.         <prop key="xa-transaction-manager-type">Narayana</prop>
  4.     </props>
  5. </shardingsphere:data-source>