重要

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

Spring Boot を使用して TiDB に接続する

TiDB は MySQL 互換データベースであり、 Java用の人気の春オープンソースコンテナフレームワークです。このドキュメントでは Spring の使用方法としてスプリングブーツを使用します。

このチュートリアルでは、TiDB を JPA プロバイダーとしてSpring Data JPAおよび休止状態とともに使用して、次のタスクを実行する方法を学習できます。

環境をセットアップします。
Hibernate と Spring Data JPA を使用して 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-springboot-jpa-quickstart.git
cd tidb-java-springboot-jpa-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
```
別のターミナルセッションでリクエストスクリプトを実行します。
```
make request
```
予想される出力.txtチェックして、出力が一致するかどうかを確認します。

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

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

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

TiDB に接続する

構成ファイルapplication.ymlを編集します。

spring:
  datasource:
    url: ${TIDB_JDBC_URL:jdbc:mysql://localhost:4000/test}
    username: ${TIDB_USER:root}
    password: ${TIDB_PASSWORD:}
    driver-class-name: com.mysql.cj.jdbc.Driver
  jpa:
    show-sql: true
    database-platform: org.hibernate.dialect.TiDBDialect
    hibernate:
      ddl-auto: create-drop

構成後、環境変数TIDB_JDBC_URL 、 TIDB_USER 、およびTIDB_PASSWORDを TiDB クラスターの実際の値に設定します。構成ファイルは、これらの環境変数のデフォルト設定を提供します。環境変数を設定しない場合、デフォルト値は次のとおりです。

TIDB_JDBC_URL ： "jdbc:mysql://localhost:4000/test"
TIDB_USER ： "root"
TIDB_PASSWORD ： ""

データ管理: `@Repository`

Spring Data JPA は@Repositoryインターフェイスを通じてデータを管理します。 JpaRepositoryによって提供される CRUD 操作を使用するには、 JpaRepositoryインターフェイスを拡張する必要があります。

@Repository
public interface PlayerRepository extends JpaRepository<PlayerBean, Long> {
}

その後、 PlayerRepositoryを必要とするクラスで自動依存関係注入に@Autowired使用できます。これにより、CRUD関数を直接使用できるようになります。以下は例です。

@Autowired
private PlayerRepository playerRepository;

データの挿入または更新

playerRepository.save(player);

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

クエリデータ

PlayerBean player = playerRepository.findById(id).orElse(null);

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

データの削除

playerRepository.deleteById(id);

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

次のステップ

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

助けが必要？

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