Driverまたは ORM を選択

ノート：

TiDB は、ドライバーと ORM に対して次の 2 つのサポート レベルを提供します。

• 完全: このドライバーまたは ORM を使用しても、既知の問題がないことを示します。
• 検証済み: TiDB と MySQL の互換性の違いにより、このドライバーまたは ORM を使用するとエラーが発生する可能性があることを示します。

詳細については、 TiDB がサポートするサードパーティ ツールを参照してください。

TiDB は MySQL プロトコルと高い互換性がありますが、一部の機能は MySQL と互換性がありません。

例えば：

• TiDB でサポートされていない機能:

  • ストアド プロシージャと関数
  • トリガー
  • FOREIGN KEY制約

• MySQL とは異なる機能:

  • 自動インクリメント ID: 自動インクリメント列は、TiDB 内でグローバルに一意です。それらは単一の TiDBサーバー上では増分ですが、必ずしも複数の TiDB サーバー間で増分されたり、順次割り当てられるとは限りません。

互換性の相違点の完全なリストについては、 MySQL の互換性を参照してください。

ジャワ

このセクションでは、Java でドライバーと ORM フレームワークを使用する方法について説明します。

Java ドライバー

<dependency>
  <groupId>io.github.lastincisor</groupId>
  <artifactId>mysql-connector-java</artifactId>
  <version>8.0.29-tidb-1.0.0</version>
</dependency>

<dependency>
  <groupId>io.github.lastincisor</groupId>
  <artifactId>mysql-connector-java</artifactId>
  <version>8.0.29-tidb-1.0.0</version>
</dependency>
<dependency>
    <groupId>org.bouncycastle</groupId>
    <artifactId>bcprov-jdk15on</artifactId>
    <version>1.67</version>
</dependency>
<dependency>
    <groupId>org.bouncycastle</groupId>
    <artifactId>bcpkix-jdk15on</artifactId>
    <version>1.67</version>
</dependency>

implementation group: 'io.github.lastincisor', name: 'mysql-connector-java', version: '8.0.29-tidb-1.0.0'
implementation group: 'org.bouncycastle', name: 'bcprov-jdk15on', version: '1.67'
implementation group: 'org.bouncycastle', name: 'bcpkix-jdk15on', version: '1.67'

Java ORM フレームワーク

ノート：

• 現在、Hibernate はネストされたトランザクションをサポートしないを実行します。

• v6.2.0 以降、TiDB はセーブポイントをサポートしています。 @TransactionalでPropagation.NESTEDトランザクション伝播オプションを使用する、つまり@Transactional(propagation = Propagation.NESTED)を設定するには、TiDB が v6.2.0 以降であることを確認してください。

<dependency>
    <groupId>org.hibernate.orm</groupId>
    <artifactId>hibernate-core</artifactId>
    <version>6.0.0.CR2</version>
</dependency>

<dependency>
    <groupId>mysql</groupId>
    <artifactId>mysql-connector-java</artifactId>
    <version>5.1.49</version>
</dependency>

implementation 'org.hibernate:hibernate-core:6.0.0.CR2'
implementation 'mysql:mysql-connector-java:5.1.49'

<dependency>
    <groupId>org.mybatis</groupId>
    <artifactId>mybatis</artifactId>
    <version>3.5.9</version>
</dependency>

<dependency>
    <groupId>mysql</groupId>
    <artifactId>mysql-connector-java</artifactId>
    <version>5.1.49</version>
</dependency>

implementation 'org.mybatis:mybatis:3.5.9'
implementation 'mysql:mysql-connector-java:5.1.49'

Java クライアントの負荷分散

tidb-loadbalance

サポートレベル:フル

tidb-loadbalanceは、アプリケーション側の負荷分散コンポーネントです。 tidb-loadbalance を使用すると、TiDBサーバーのノード情報を自動的に維持し、tidb-loadbalance ポリシーを使用してクライアントに JDBC 接続を分散できます。クライアント アプリケーションと TiDBサーバー間で直接 JDBC 接続を使用すると、負荷分散コンポーネントを使用するよりも高いパフォーマンスが得られます。

現在、tidb-loadbalance は次のポリシーをサポートしています: roundrobin、random、および weight。

ノート：

tidb-loadbalance はmysql-コネクタ-jと共に使用する必要があります。

Maven を使用する場合は、 pom.xmlファイルの<dependencies></dependencies>の要素本体に次の内容を追加します。

<dependency>
  <groupId>io.github.lastincisor</groupId>
  <artifactId>mysql-connector-java</artifactId>
  <version>8.0.29-tidb-1.0.0</version>
</dependency>
<dependency>
  <groupId>io.github.lastincisor</groupId>
  <artifactId>tidb-loadbalance</artifactId>
  <version>0.0.5</version>
</dependency>

Gradle を使用する場合は、次の内容をdependenciesに追加します。

implementation group: 'io.github.lastincisor', name: 'mysql-connector-java', version: '8.0.29-tidb-1.0.0'
implementation group: 'io.github.lastincisor', name: 'tidb-loadbalance', version: '0.0.5'

ゴラン

このセクションでは、Golang でドライバーと ORM フレームワークを使用する方法について説明します。

Golang ドライバー

go-sql-driver/mysql

サポートレベル:フル

Golang ドライバーをダウンロードして構成するには、 go-sql-driver/mysql ドキュメントを参照してください。

完全なアプリケーションを構築する方法の例については、 TiDB と Golang を使用して単純な CRUD アプリを構築するを参照してください。

Golang ORM フレームワーク

ゴーム

サポートレベル:フル

GORM は、Golang の一般的な ORM フレームワークです。アプリケーションのすべての依存関係を取得するには、 go getコマンドを使用できます。

go get -u gorm.io/gorm
go get -u gorm.io/driver/mysql

GORM を使用して TiDB アプリケーションを構築する例については、 TiDB と Golang を使用して単純な CRUD アプリを構築するを参照してください。