Narayana Transaction

Background

Apache ShardingSphere provides XA transactions that integrate with the Narayana implementation.

Prerequisites

Introducing Maven dependency

  1. <properties>
  2.     <narayana.version>5.12.4.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. <!-- This module is required when using XA transactions -->
  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>

Procedure

  1. Configure Narayana
  2. Set the XA transaction type

Sample

Configure Narayana

Narayana configuration items can be customized by adding jbossts-properties.xml to the project’s classpath.

See Narayana’s Official Documentation for more details.

Set the XA transaction type

Yaml:

  1. transaction:
  2.   defaultType: XA
  3.   providerType: Narayana