重要

このページは英語版のページを機械翻訳しています。原文はこちらからご覧ください。

Hibernate で TiDB に接続する

TiDB は MySQL 互換データベースであり、休止状態は人気のあるオープンソースJava ORM です。バージョン6.0.0.Beta2以降、Hibernate は TiDB 言語をサポートしており、これは TiDB 機能によく適合します。

このチュートリアルでは、TiDB と Hibernate を使用して次のタスクを実行する方法を学習できます。

環境をセットアップします。
Hibernate を使用して TiDB クラスターに接続します。
アプリケーションをビルドして実行します。オプションで、基本的な CRUD 操作のサンプルコードスニペットを見つけることができます。

注記：
このチュートリアルは、TiDB サーバーレス、TiDB 専用、および TiDB セルフホストで動作します。

前提条件

このチュートリアルを完了するには、次のものが必要です。

Java開発キット (JDK) 17以降。ビジネスや個人の要件に基づいてOpenJDKまたはオラクルJDKを選択できます。
メイビン 3.8以上。
ギット。
TiDB クラスター。

TiDB クラスターがない場合は、次のように作成できます。

(推奨) TiDB サーバーレスクラスターの作成に従って、独自のTiDB Cloudクラスターを作成します。
ローカルテスト TiDB クラスターをデプロイまたは本番TiDB クラスターをデプロイに従ってローカルクラスターを作成します。

TiDB クラスターがない場合は、次のように作成できます。

(推奨) TiDB サーバーレスクラスターの作成に従って、独自のTiDB Cloudクラスターを作成します。
ローカルテスト TiDB クラスターをデプロイまたは本番TiDB クラスターをデプロイに従ってローカルクラスターを作成します。

サンプルアプリを実行して TiDB に接続する

このセクションでは、サンプルアプリケーションコードを実行して TiDB に接続する方法を説明します。

ステップ 1: サンプルアプリリポジトリのクローンを作成する

ターミナルウィンドウで次のコマンドを実行して、サンプルコードリポジトリのクローンを作成します。

git clone https://github.com/tidb-samples/tidb-java-hibernate-quickstart.git
cd tidb-java-hibernate-quickstart

ステップ 2: 接続情報を構成する

選択した TiDB デプロイメントオプションに応じて、TiDB クラスターに接続します。

TiDB Serverless
TiDB Dedicated
TiDB Self-Hosted

クラスターページに移動し、ターゲットクラスターの名前をクリックして、その概要ページに移動します。
右上隅にある「接続」をクリックします。接続ダイアログが表示されます。
接続ダイアログの設定が動作環境と一致していることを確認してください。
- エンドポイントタイプはPublicに設定されます
- ブランチはmainに設定されています
- [接続先] はGeneralに設定されています
- オペレーティングシステムが環境に一致します。
ヒント：
プログラムが Windows Subsystem for Linux (WSL) で実行されている場合は、対応する Linux ディストリビューションに切り替えます。
「パスワードの生成」をクリックして、ランダムなパスワードを作成します。
ヒント：
以前にパスワードを作成したことがある場合は、元のパスワードを使用するか、 「パスワードのリセット」をクリックして新しいパスワードを生成できます。
次のコマンドを実行してenv.sh.exampleをコピーし、名前をenv.shに変更します。
```
cp env.sh.example env.sh
```
対応する接続文字列をコピーしてenv.shファイルに貼り付けます。結果の例は次のとおりです。
```
export TIDB_HOST='{host}'  # e.g. gateway01.ap-northeast-1.prod.aws.tidbcloud.com
export TIDB_PORT='4000'
export TIDB_USER='{user}'  # e.g. xxxxxx.root
export TIDB_PASSWORD='{password}'
export TIDB_DB_NAME='test'
export USE_SSL='true'
```
プレースホルダー{} 、接続ダイアログから取得した接続パラメーターに必ず置き換えてください。
TiDB サーバーレスには安全な接続が必要です。したがって、 USE_SSL ～ trueの値を設定する必要があります。
env.shファイルを保存します。

クラスターページに移動し、ターゲットクラスターの名前をクリックして、その概要ページに移動します。
右上隅にある「接続」をクリックします。接続ダイアログが表示されます。
「どこからでもアクセスを許可」をクリックし、 「TiDB クラスター CA のダウンロード」をクリックして CA 証明書をダウンロードします。
接続文字列の取得方法の詳細については、 TiDB専用標準接続を参照してください。
次のコマンドを実行してenv.sh.exampleをコピーし、名前をenv.shに変更します。
```
cp env.sh.example env.sh
```
対応する接続文字列をコピーしてenv.shファイルに貼り付けます。結果の例は次のとおりです。
```
export TIDB_HOST='{host}'  # e.g. tidb.xxxx.clusters.tidb-cloud.com
export TIDB_PORT='4000'
export TIDB_USER='{user}'  # e.g. root
export TIDB_PASSWORD='{password}'
export TIDB_DB_NAME='test'
export USE_SSL='false'
```
プレースホルダー{} 、接続ダイアログから取得した接続パラメーターに必ず置き換えてください。
env.shファイルを保存します。

次のコマンドを実行してenv.sh.exampleをコピーし、名前をenv.shに変更します。
```
cp env.sh.example env.sh
```
対応する接続文字列をコピーしてenv.shファイルに貼り付けます。結果の例は次のとおりです。
```
export TIDB_HOST='{host}'
export TIDB_PORT='4000'
export TIDB_USER='root'
export TIDB_PASSWORD='{password}'
export TIDB_DB_NAME='test'
export USE_SSL='false'
```
必ずプレースホルダー{}接続パラメーターに置き換えて、 USE_SSLをfalseに設定してください。 TiDB をローカルで実行している場合、デフォルトのホストアドレスは127.0.0.1で、パスワードは空です。
env.shファイルを保存します。

ステップ 3: コードを実行して結果を確認する

次のコマンドを実行してサンプルコードを実行します。
```
make
```
予想される出力.txtチェックして、出力が一致するかどうかを確認します。

サンプルコードスニペット

次のサンプルコードスニペットを参照して、独自のアプリケーション開発を完了できます。

完全なサンプルコードとその実行方法については、 tidb-samples/tidb-java-hibernate-quickstartリポジトリを確認してください。

TiDB に接続する

Hibernate 構成ファイルを編集しますhibernate.cfg.xml :

<?xml version='1.0' encoding='utf-8'?>
<!DOCTYPE hibernate-configuration PUBLIC
        "-//Hibernate/Hibernate Configuration DTD 3.0//EN"
        "http://www.hibernate.org/dtd/hibernate-configuration-3.0.dtd">
<hibernate-configuration>
    <session-factory>

        <!-- Database connection settings -->
        <property name="hibernate.connection.driver_class">com.mysql.cj.jdbc.Driver</property>
        <property name="hibernate.dialect">org.hibernate.dialect.TiDBDialect</property>
        <property name="hibernate.connection.url">${tidb_jdbc_url}</property>
        <property name="hibernate.connection.username">${tidb_user}</property>
        <property name="hibernate.connection.password">${tidb_password}</property>
        <property name="hibernate.connection.autocommit">false</property>

        <!-- Required so a table can be created from the 'PlayerDAO' class -->
        <property name="hibernate.hbm2ddl.auto">create-drop</property>

        <!-- Optional: Show SQL output for debugging -->
        <property name="hibernate.show_sql">true</property>
        <property name="hibernate.format_sql">true</property>
    </session-factory>
</hibernate-configuration>

${tidb_jdbc_url} 、 ${tidb_user} 、および${tidb_password}必ず TiDB クラスターの実際の値に置き換えてください。次に、次の関数を定義します。

public SessionFactory getSessionFactory() {
    return new Configuration()
            .configure("hibernate.cfg.xml")
            .addAnnotatedClass(${your_entity_class})
            .buildSessionFactory();
}

この関数を使用する場合、 ${your_entity_class}独自のデータエンティティクラスに置き換える必要があります。複数のエンティティクラスの場合は、それぞれに.addAnnotatedClass(${your_entity_class})ステートメントを追加する必要があります。前述の関数は、Hibernate を構成する 1 つの方法にすぎません。設定で問題が発生した場合、または Hibernate について詳しく知りたい場合は、 Hibernateの公式ドキュメントを参照してください。

データの挿入または更新

try (Session session = sessionFactory.openSession()) {
    session.persist(new PlayerBean("id", 1, 1));
}

詳細については、データの挿入およびデータを更新するを参照してください。

クエリデータ

try (Session session = sessionFactory.openSession()) {
    PlayerBean player = session.get(PlayerBean.class, "id");
    System.out.println(player);
}

詳細については、クエリデータを参照してください。

データの削除

try (Session session = sessionFactory.openSession()) {
    session.remove(new PlayerBean("id", 1, 1));
}

詳細については、データの削除を参照してください。

次のステップ

Hibernate の詳しい使い方をHibernate のドキュメントから学びましょう。
TiDB アプリケーション開発のSQLパフォーマンスの最適化プラクティスについて取引、開発者ガイドの章 ( データの挿入など) データを更新する参照データの削除単一テーブルの読み取りください。
プロフェッショナルとしてTiDB 開発者コースを学び、試験合格後にTiDB 認定獲得します。
Java開発者向けのコースを通じてJavaから TiDB を操作するを学びます。

助けが必要？

不和またはサポートチケットを作成するについて質問してください。