Hibernate で TiDB に接続する

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

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

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

注記:

このチュートリアルは、TiDB サーバーレス、TiDB 専用、および 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
  1. クラスターページに移動し、ターゲット クラスターの名前をクリックして、その概要ページに移動します。

  2. 右上隅にある「接続」をクリックします。接続ダイアログが表示されます。

  3. 接続ダイアログの設定が動作環境と一致していることを確認してください。

    • エンドポイント タイプはPublicに設定されます

    • ブランチはmainに設定されています

    • [接続先]Generalに設定されています

    • オペレーティング システムが環境に一致します。

    ヒント:

    プログラムが Windows Subsystem for Linux (WSL) で実行されている場合は、対応する Linux ディストリビューションに切り替えます。

  4. 「パスワードの生成」をクリックして、ランダムなパスワードを作成します。

    ヒント:

    以前にパスワードを作成したことがある場合は、元のパスワードを使用するか、 「パスワードのリセット」をクリックして新しいパスワードを生成できます。

  5. 次のコマンドを実行してenv.sh.exampleをコピーし、名前をenv.shに変更します。

    cp env.sh.example env.sh
  6. 対応する接続​​文字列をコピーして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_SSLtrueの値を設定する必要があります。

  7. env.shファイルを保存します。

  1. クラスターページに移動し、ターゲット クラスターの名前をクリックして、その概要ページに移動します。

  2. 右上隅にある「接続」をクリックします。接続ダイアログが表示されます。

  3. 「どこからでもアクセスを許可」をクリックし、 「TiDB クラスター CA のダウンロード」をクリックして CA 証明書をダウンロードします。

    接続文字列の取得方法の詳細については、 TiDB専用標準接続を参照してください。

  4. 次のコマンドを実行してenv.sh.exampleをコピーし、名前をenv.shに変更します。

    cp env.sh.example env.sh
  5. 対応する接続​​文字列をコピーして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'

    プレースホルダー{} 、接続ダイアログから取得した接続パラメーターに必ず置き換えてください。

  6. env.shファイルを保存します。

  1. 次のコマンドを実行してenv.sh.exampleをコピーし、名前をenv.shに変更します。

    cp env.sh.example env.sh
  2. 対応する接続​​文字列をコピーして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_SSLfalseに設定してください。 TiDB をローカルで実行している場合、デフォルトのホスト アドレスは127.0.0.1で、パスワードは空です。

  3. env.shファイルを保存します。

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

  1. 次のコマンドを実行してサンプル コードを実行します。

    make
  2. 予想される出力.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)); }

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

次のステップ

助けが必要?

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

このページは役に立ちましたか?