これはアーカイブされた TiDB のドキュメントであり、更新は行われていません。最新の LTS バージョンのドキュメントを表示する ↗

TiDB Cloudと Vercel の統合

ヴェルセルはフロントエンド開発者向けのプラットフォームであり、イノベーターがインスピレーションの瞬間に作成するために必要なスピードと信頼性を提供します。

Vercel でTiDB Cloudを使用すると、MySQL 互換のリレーショナルモデルを使用して新しいフロントエンドアプリケーションをより迅速に構築し、回復力、拡張性、および最高レベルのデータプライバシーとセキュリティのために構築されたプラットフォームで自信を持ってアプリを成長させることができます。

このガイドでは、次のいずれかの方法を使用して、 TiDB Cloudクラスターを Vercel プロジェクトに接続する方法について説明します。

TiDB Cloud Vercel 統合を介して接続する
環境変数を手動で構成して接続する

前提条件

接続する前に、次の前提条件が満たされていることを確認してください。

Vercel アカウントと Vercel プロジェクト

Vercel にアカウントとプロジェクトが必要です。持っていない場合は、次の Vercel ドキュメントを参照して作成してください。

新しい個人アカウントの作成または新しいチームの作成。
Vercel でプロジェクトの作成を使用するか、デプロイするアプリケーションがない場合は、 TiDB Cloudスターターテンプレートを使用して試すことができます。

1 つの Vercel プロジェクトは、1 つのTiDB Cloudクラスターにのみ接続できます。統合を変更するには、まず現在のクラスターを切断してから、新しいクラスターに接続する必要があります。

TiDB Cloudアカウントと TiDB クラスター

TiDB Cloudにアカウントとクラスターが必要です。持っていない場合は、 TiDB クラスターを作成するを参照してください。

Vercel と統合するには、組織への「所有者」アクセス、またはTiDB Cloudのターゲットプロジェクトへの「メンバー」アクセスが必要です。詳細については、メンバーの役割を構成するを参照してください。

1 つのTiDB Cloudクラスターで複数の Vercel プロジェクトに接続できます。

TiDB Cloudでトラフィックフィルターに許可されているすべての IP アドレス

Dedicated Tier クラスターの場合、クラスターのトラフィックフィルターがすべての IP アドレス ( 0.0.0.0/0に設定) の接続を許可していることを確認してください。これは、Vercel のデプロイで動的 IP アドレスが使用されるためです。 TiDB Cloud Vercel 統合を使用する場合、TiDB TiDB Cloudは、統合ワークフローでクラスターに0.0.0.0/0トラフィックフィルターを自動的に追加します (存在しない場合)。

サーバーレス層クラスターでは、デフォルトですべての IP アドレスの接続が許可されるため、トラフィックフィルターを構成する必要はありません。

TiDB Cloud Vercel 統合を介して接続する

TiDB Cloud Vercel インテグレーション経由で接続するには、 Vercel の統合マーケットプレイスからTiDB Cloud統合ページに移動します。この方法を使用すると、接続するクラスターを選択でき、 TiDB Cloudは Vercel プロジェクトに必要なすべての環境変数を自動的に生成します。

詳細な手順は次のとおりです。

TiDB Cloud Vercel 統合ページの右上にある [**統合の追加] を**クリックします。 [ TiDB Cloudの追加] ダイアログが表示されます。
ドロップダウンリストで統合の範囲を選択し、[続行] をクリックします。
統合を追加するVercelプロジェクトを選択し、[続行] をクリックします。
統合に必要な権限を確認し、 ADD INTEGRATIONをクリックします。次に、 TiDB Cloudコンソールの統合ページに移動します。
左側で、ターゲットの Vercel プロジェクトを選択し、使用する Vercel プロジェクトのフレームワークを作成します。フレームワークがリストされていない場合は、[一般] を選択します。異なるフレームワークは、異なる環境変数を決定します。
右側で、クラスター情報を提供した後、ターゲットのTiDB Cloudクラスターを選択します。各TiDB Cloudクラスターは組織とプロジェクトに属します。
[**統合を追加して Vercel に戻る] を**クリックします。
Vercel ダッシュボードに戻り、Vercel プロジェクトに移動し、[**設定]** > [環境変数] をクリックして、環境変数が自動的に追加されていることを確認します。
変数が追加されていれば、接続は完了です。

統合セットアップを完了し、 TiDB Cloudクラスターを Vercel プロジェクトに正常に接続すると、接続に必要な情報がプロジェクトの環境変数に自動的に設定されます。

全般的

TIDB_HOST
TIDB_PORT
TIDB_USER
TIDB_PASSWORD

Dedicated Tier クラスターの場合、ルート CA はこの変数に設定されます。

TIDB_SSL_CA

プリズマ

DATABASE_URL

環境変数を手動で設定して接続する

この方法を使用するには、 セキュリティ設定ダイアログで [どこからでもアクセスを許可する] トラフィックフィルタを設定し、パスワードを保存していることを確認してください。

標準接続を介してTiDB Cloudクラスターに接続するの手順に従って、TiDB クラスターの接続情報を取得します。
Vercel ダッシュボード > Vercel プロジェクト >設定>環境変数に移動し、TiDB クラスターの接続情報に従って各環境変数値を宣言するに進みます。

以下は、 TiDB Cloud Dedicated Tier クラスターの接続変数の例です。

var connection = mysql.createConnection({
  host: '<your_host>',
  port: 4000,
  user: 'root',
  password: '<your_password>',
  database: 'test',
  ssl: {
    ca: fs.readFileSync('ca.pem'),
    minVersion: 'TLSv1.2',
    rejectUnauthorized: true
  }
});

Vercel では、次のように変数を宣言できます。プロジェクトの必要に応じて名前をカスタマイズできます。

名前= TIDB_HOST値 = <your_host>
名前= TIDB_PORT値 = 4000
名前= TIDB_USER値 = ルート
名前= TIDB_PASSWORD値 = <your_password>
名前= TIDB_SSL_CA値 = <content_of_ca.pem>

接続の構成

TiDB Cloud Vercel 統合をインストールしている場合は、統合内で接続を追加または削除できます。

Vercel ダッシュボードで、[統合] をクリックします。
TiDB Cloudエントリで [管理] をクリックします。
[**構成]**をクリックします。
[**プロジェクトの追加]**または [削除]をクリックして、接続を追加または削除します。

接続を削除すると、統合ワークフローによって設定された環境変数も Vercel プロジェクトから削除されます。トラフィックフィルターとTiDB Cloudクラスターのデータは影響を受けません。