Django を使用して TiDB に接続する

TiDB は MySQL 互換データベースであり、 ジャンゴは Python の人気のある Web フレームワークであり、強力なオブジェクト リレーショナル マッパー (ORM) ライブラリが含まれています。

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

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

注記：

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

前提条件

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

• Python 3.8以降 。
• ギット 。
• TiDB クラスター。

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

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

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

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

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

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

git clone https://github.com/tidb-samples/tidb-python-django-quickstart.git
cd tidb-python-django-quickstart

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

次のコマンドを実行して、サンプル アプリに必要なパッケージ (Django、django-tidb、mysqlclient など) をインストールします。

pip install -r requirements.txt

mysqlclient でインストールの問題が発生した場合は、 mysqlclientの公式ドキュメントを参照してください。

django-tidbとは何ですか?

django-tidbは、TiDB と Django の間の互換性の問題を解決する Django 用の TiDB 方言です。

django-tidbをインストールするには、Django のバージョンと一致するバージョンを選択します。たとえば、 django==4.2.*使用している場合は、 django-tidb==4.2.*をインストールします。マイナー バージョンは同じである必要はありません。最新のマイナー バージョンを使用することをお勧めします。

詳細については、 django-tidb リポジトリを参照してください。

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

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

• TiDB Serverless
• TiDB Dedicated
• TiDB Self-Hosted

ステップ 4: データベースを初期化する

プロジェクトのルート ディレクトリで次のコマンドを実行してデータベースを初期化します。

python manage.py migrate

ステップ 5: サンプル アプリケーションを実行する

1. アプリケーションを開発モードで実行します。

   python manage.py runserver
   

   アプリケーションはデフォルトでポート8000で実行されます。別のポートを使用するには、コマンドにポート番号を追加します。以下は例です。

   python manage.py runserver 8080
   

2. アプリケーションにアクセスするには、ブラウザを開いてhttp://localhost:8000/に進みます。サンプル アプリケーションでは、次のことができます。

   • 新しいプレーヤーを作成します。
   • プレーヤーを一括作成します。
   • すべてのプレーヤーをビュー。
   • プレーヤーを更新します。
   • プレーヤーを削除します。
   • 2 人のプレイヤー間で商品を交換します。

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

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

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

TiDB に接続する

ファイルsample_project/settings.pyに、次の構成を追加します。

DATABASES = {
    "default": {
        "ENGINE": "django_tidb",
        "HOST": ${tidb_host},
        "PORT": ${tidb_port},
        "USER": ${tidb_user},
        "PASSWORD": ${tidb_password},
        "NAME": ${tidb_db_name},
        "OPTIONS": {
            "charset": "utf8mb4",
        },
    }
}

TIDB_CA_PATH = ${ca_path}
if TIDB_CA_PATH:
    DATABASES["default"]["OPTIONS"]["ssl_mode"] = "VERIFY_IDENTITY"
    DATABASES["default"]["OPTIONS"]["ssl"] = {
        "ca": TIDB_CA_PATH,
    }

${tidb_host} 、 ${tidb_port} 、 ${tidb_user} 、 ${tidb_password} 、 ${tidb_db_name} 、および${ca_path}を TiDB クラスターの実際の値に置き換える必要があります。

データモデルを定義する

from django.db import models

class Player(models.Model):
    name = models.CharField(max_length=32, blank=False, null=False)
    coins = models.IntegerField(default=100)
    goods = models.IntegerField(default=1)
    created_at = models.DateTimeField(auto_now_add=True)
    updated_at = models.DateTimeField(auto_now=True)

詳細については、 ジャンゴモデルを参照してください。

データの挿入

# insert a single object
player = Player.objects.create(name="player1", coins=100, goods=1)

# bulk insert multiple objects
Player.objects.bulk_create([
    Player(name="player1", coins=100, goods=1),
    Player(name="player2", coins=200, goods=2),
    Player(name="player3", coins=300, goods=3),
])

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

クエリデータ

# get a single object
player = Player.objects.get(name="player1")

# get multiple objects
filtered_players = Player.objects.filter(name="player1")

# get all objects
all_players = Player.objects.all()

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

データを更新する

# update a single object
player = Player.objects.get(name="player1")
player.coins = 200
player.save()

# update multiple objects
Player.objects.filter(coins=100).update(coins=200)

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

データの削除

# delete a single object
player = Player.objects.get(name="player1")
player.delete()

# delete multiple objects
Player.objects.filter(coins=100).delete()

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

次のステップ

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

助けが必要？

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