Driverまたは ORM を選択
TiDB は MySQL プロトコルと高い互換性がありますが、一部の機能は MySQL と互換性がありません。
例えば:
TiDB でサポートされていない機能:
- ストアド プロシージャと関数
- トリガー
FOREIGN KEY
制約
MySQL とは異なる機能:
- 自動インクリメント ID: 自動インクリメント列は、TiDB 内でグローバルに一意です。それらは単一の TiDBサーバー上では増分ですが、必ずしも複数の TiDB サーバー間で増分されたり、順次割り当てられるとは限りません。
互換性の相違点の完全なリストについては、 MySQL の互換性を参照してください。
ジャワ
TiDB は、Java に対して次の 2 つのサポート レベルを提供します。
- 完全: このドライバーまたは ORM を使用しても、既知の問題がないことを示します。
- 検証済み: TiDB と MySQL の互換性の違いにより、このドライバーまたは ORM を使用するとエラーが発生する可能性があることを示します。
Java ドライバー
JDBC
サポートレベル:フル
MySQL ドキュメントに従って、Java JDBC ドライバーをダウンロードして構成できます。
ノート:
JDBC 5.1 の最新バージョンであるバージョン 5.1.49 を使用することを強くお勧めします。現在のバージョン 8.0.29 には未解決のバグがあるため、TiDB の使用時にスレッドがハングする可能性があります。 MySQL JDBC 8.0 がこの修正をマージするまで、バージョン 8.0 にアップグレードしないことをお勧めします。
完全なアプリケーションを構築する方法の例については、 TiDB と JDBC を使用して単純な CRUD アプリを構築するを参照してください。
Java ORM フレームワーク
休止状態
サポートレベル: Full
ノート:
現在、Hibernate はネストされたトランザクションをサポートしないを実行します。 v6.2.0 以降、TiDB はセーブポイントをサポートしています。
Spring Data JPA
などのフレームワークを使用している場合は、@Transactional
でPropagation.NESTED
トランザクション伝播オプションを使用しないでください。つまり、@Transactional( propagation = Propagation.NESTED)
を設定しないでください。
アプリケーションの異なる依存関係間の複雑な関係を手動で管理することを避けるために、 グラドルまたはメイヴンを使用して、間接的なものを含むアプリケーションのすべての依存関係を取得できます。 Hibernate 6.0.0.Beta2
以降のみが TiDB ダイアレクトをサポートすることに注意してください。
Mavenを使用している場合は、次を<dependencies></dependencies>
に追加します。
<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>
Gradleを使用している場合は、以下をdependencies
に追加します。
implementation 'org.hibernate:hibernate-core:6.0.0.CR2'
implementation 'mysql:mysql-connector-java:5.1.49'
- Hibernate を使用してネイティブ Java で TiDB アプリケーションを構築する例については、 TiDB と Java を使用して単純な CRUD アプリを構築するを参照してください。
- Spring Data JPA または Hibernate を使用して Spring で TiDB アプリケーションを構築する例については、 Spring Boot を使用して TiDB アプリケーションを構築するを参照してください。
さらに、 ハイバネート構成ファイル : org.hibernate.dialect.TiDBDialect
で TiDB ダイアレクトを指定する必要があります。これは、Hibernate 6.0.0.Beta2
以降でのみサポートされています。 Hibernate
バージョンが6.0.0.Beta2
より前の場合は、最初にアップグレードしてください。
ノート:
バージョン
Hibernate
をアップグレードできない場合は、代わりにMySQL 5.7ダイアレクトorg.hibernate.dialect.MySQL57Dialect
を使用してください。ただし、この設定により、予測できない結果が生じたり、 シーケンスなどの TiDB 固有の機能が一部失われたりする可能性があります。