📣

TiDB Cloud Premium はパブリックプレビュー中です。エンタープライズワークロード向けの無制限のスケーリング、即時の弾力性、高度なセキュリティを提供します。このページは自動翻訳されたものです。原文はこちらからご覧ください。

Next.jsでmysql2を使用してTiDBに接続する

TiDBはMySQL互換のデータベースであり、 mysql2はNode.jsで広く使われているオープンソースのドライバです。

このチュートリアルでは、Next.jsでTiDBとmysql2を使用して以下のタスクを実行する方法を学びます。

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

注記
このチュートリアルは、 TiDB Cloud Starter、 TiDB Cloud Essential、 TiDB Cloud Premium、およびTiDB Self-Managedに対応しています。

前提条件

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

Node.js 18以降。
Git 。
TiDBクラスタ。

TiDBクラスタをお持ちでない場合は、以下の手順で作成できます。

TiDBに接続するには、サンプルアプリを実行してください。

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

注記
完全なコードスニペットと実行手順については、 tidb-nextjs-vercel-quickstart GitHubリポジトリを参照してください。

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

サンプルコードリポジトリをクローンするには、ターミナルウィンドウで以下のコマンドを実行してください。

git clone git@github.com:tidb-samples/tidb-nextjs-vercel-quickstart.git
cd tidb-nextjs-vercel-quickstart

ステップ2：依存関係をインストールする

サンプルアプリに必要なパッケージ（ mysql2を含む）をインストールするには、次のコマンドを実行してください。

npm install

ステップ3：接続情報の設定

選択したTiDBのデプロイオプションに応じて、TiDBに接続してください。

私のTiDBページに移動し、対象のTiDB Cloud StarterまたはEssentialインスタンスの名前をクリックして、概要ページに移動します。
右上隅の「接続」をクリックします。接続ダイアログが表示されます。
接続ダイアログの設定がご使用のオペレーティング環境と一致していることを確認してください。
- 接続タイプはPublicに設定されています。
- ブランチはmainに設定されています。
- Connect With はGeneralに設定されています。
- お使いの環境に合ったオペレーティングシステムを選択してください。
注記
Node.jsアプリケーションでは、SSL CA証明書を提供する必要はありません。Node.jsはTLS（SSL）接続を確立する際に、デフォルトで組み込みのMozilla CA証明書を使用するためです。
「パスワード生成」をクリックすると、ランダムなパスワードが生成されます。
ヒント
以前にパスワードを作成したことがある場合は、元のパスワードを使用するか、 「パスワードをリセット」をクリックして新しいパスワードを生成できます。
.env.exampleをコピーして.envに名前を変更するには、次のコマンドを実行します。
```
# Linux
cp .env.example .env
```
```
# Windows
Copy-Item ".env.example" -Destination ".env"
```
対応する接続文字列.envファイルにコピー＆ペーストしてください。例は以下のとおりです。
```
TIDB_HOST='{gateway-region}.aws.tidbcloud.com'
TIDB_PORT='4000'
TIDB_USER='{prefix}.root'
TIDB_PASSWORD='{password}'
TIDB_DB_NAME='test'
TIDB_ENABLE_SSL='true'
```
{}内のプレースホルダーを、接続ダイアログで取得した値に置き換えてください。
.envファイルを保存します。

私のTiDBページに移動し、対象のTiDB Cloud Premiumインスタンスの名前をクリックして概要ページに移動します。
左側のナビゲーションペインで、 [設定] > [ネットワーク]をクリックします。
ネットワークのページで、 [パブリックエンドポイント**を有効にする]をクリックし、次に[IP アドレスの追加]**をクリックします。
クライアントのIPアドレスがアクセスリストに追加されていることを確認してください。
左側のナビゲーションペインで「概要」をクリックすると、インスタンスの概要ページに戻ります。
右上隅の「接続」をクリックしてください。接続ダイアログが表示されます。
接続ダイアログで、 「接続タイプ」ドロップダウンリストから「パブリック」を選択します。
- 公開エンドポイントがまだ有効化中であることを示すメッセージが表示された場合は、処理が完了するまでお待ちください。
- まだパスワードを設定していない場合は、ダイアログの「ルートパスワードを設定」をクリックしてください。
- サーバー証明書を確認する必要がある場合、または接続に失敗して認証局（CA）証明書が必要な場合は、 「CA証明書」をクリックしてダウンロードしてください。
- パブリック接続タイプに加えて、 TiDB Cloud Premium はプライベートエンドポイント接続をサポートします。詳細については、 AWS PrivateLink経由でTiDB Cloud Premiumに接続します。を参照してください。
.env.exampleをコピーして.envに名前を変更するには、次のコマンドを実行します。
```
# Linux
cp .env.example .env
```
```
# Windows
Copy-Item ".env.example" -Destination ".env"
```
対応する接続文字列.envファイルにコピー＆ペーストしてください。例は以下のとおりです。
```
TIDB_HOST='{host}'  # e.g. tidb.xxxx.clusters.tidb-cloud.com
TIDB_PORT='4000'
TIDB_USER='{user}'  # e.g. root
TIDB_PASSWORD='{password}'
TIDB_DB_NAME='test'
TIDB_ENABLE_SSL='false'
```
{}内のプレースホルダーを、接続ダイアログで取得した値に置き換えてください。
.envファイルを保存します。

.env.exampleをコピーして.envに名前を変更するには、次のコマンドを実行します。
```
# Linux
cp .env.example .env
```
```
# Windows
Copy-Item ".env.example" -Destination ".env"
```
対応する接続文字列.envファイルにコピー＆ペーストしてください。例は以下のとおりです。
```
TIDB_HOST='{tidb_server_host}'
TIDB_PORT='4000'
TIDB_USER='root'
TIDB_PASSWORD='{password}'
TIDB_DB_NAME='test'
TIDB_ENABLE_SSL='false'
```
{}内のプレースホルダーを、 [接続]ウィンドウで取得した値に置き換えてください。TiDB をローカルで実行している場合、デフォルトのホストアドレスは127.0.0.1で、パスワードは空欄です。
.envファイルを保存します。

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

アプリケーションを起動します:
```
npm run dev
```
ブラウザを開いてhttp://localhost:3000にアクセスしてください。（実際のポート番号は端末で確認してください。デフォルトは3000です。）
サンプルコードを実行するには、 「SQLを実行」をクリックしてください。
ターミナルの出力を確認してください。出力が以下の例と似ていれば、接続は成功しています。
```
{
  "results": [
    {
      "Hello World": "Hello World"
    }
  ]
}
```

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

以下のサンプルコードスニペットを参考に、独自のアプリケーション開発を完成させてください。

完全なサンプルコードと実行方法については、 tidb-nextjs-vercel-quickstartリポジトリを参照してください。

TiDBに接続する

以下のコードは、環境変数で定義されたオプションを使用してTiDBへの接続を確立します。

// src/lib/tidb.js
import mysql from 'mysql2';

let pool = null;

export function connect() {
  return mysql.createPool({
    host: process.env.TIDB_HOST, // TiDB host, for example: {gateway-region}.aws.tidbcloud.com
    port: process.env.TIDB_PORT || 4000, // TiDB port, default: 4000
    user: process.env.TIDB_USER, // TiDB user, for example: {prefix}.root
    password: process.env.TIDB_PASSWORD, // The password of TiDB user.
    database: process.env.TIDB_DATABASE || 'test', // TiDB database name, default: test
    ssl: process.env.TIDB_ENABLE_SSL === 'true' ? {
      minVersion: 'TLSv1.2',
      rejectUnauthorized: true,
    } : null,
    connectionLimit: 1, // Setting connectionLimit to "1" in a serverless function environment optimizes resource usage, reduces costs, ensures connection stability, and enables seamless scalability.
    maxIdle: 1, // max idle connections, the default value is the same as `connectionLimit`
    enableKeepAlive: true,
  });
}

export function getPool() {
  if (!pool) {
    pool = createPool();
  }
  return pool;
}

データを挿入する

次のクエリは、単一のPlayerレコードを作成し、 ResultSetHeaderオブジェクトを返します。

const [rsh] = await pool.query('INSERT INTO players (coins, goods) VALUES (?, ?);', [100, 100]);
console.log(rsh.insertId);

詳細については、データを挿入するを参照してください。

クエリデータ

次のクエリは、ID Player 1 } レコードを返します。

const [rows] = await pool.query('SELECT id, coins, goods FROM players WHERE id = ?;', [1]);
console.log(rows[0]);

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

データの更新

以下のクエリは、 50の ID を持つ50にPlayerコインと1の商品を追加します。

const [rsh] = await pool.query(
    'UPDATE players SET coins = coins + ?, goods = goods + ? WHERE id = ?;',
    [50, 50, 1]
);
console.log(rsh.affectedRows);

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

データを削除する

以下のクエリは、IDがPlayerである1レコードを削除します。

const [rsh] = await pool.query('DELETE FROM players WHERE id = ?;', [1]);
console.log(rsh.affectedRows);

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

役立つメモ

接続プールを使用してデータベース接続を管理することで、接続の頻繁な確立と切断によって発生するパフォーマンスのオーバーヘッドを削減できます。
SQL インジェクションを回避するには、準備された声明を使用することをお勧めします。
複雑な SQL ステートメントがあまり含まれないシナリオでは、シークエライズ、 TypeORM 、またはプリズマなどの ORM フレームワークを使用すると、開発効率が大幅に向上します。

次のステップ

ORM と Next.js を使用して複雑なアプリケーションを構築する方法の詳細については、書店デモを参照してください。
node-mysql2 ドライバーの使用方法の詳細についてはnode-mysql2 のドキュメント参照してください。
開発者ガイドデータを挿入するデータの更新、データを削除する、「SQL パフォーマンス最適化」などの章単一表の読み取り読んで、TiDB アプリケーション取引 SQLパフォーマンス最適化。
プロフェッショナルなTiDB開発者向けコースコースを通じて学習し、試験に合格するとTiDB認定資格を取得します。