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

TiDB は MySQL 互換データベースであり、 mysqlクライアントは Python 用の人気のあるオープンソース ドライバーです。

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

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

注記：

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

前提条件

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

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

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

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

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

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

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

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

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

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

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

pip install -r requirements.txt

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

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

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

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

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

   python mysqlclient_example.py
   

2. 予想される出力.txtチェックして、出力が一致するかどうかを確認します。

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

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

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

TiDB に接続する

def get_mysqlclient_connection(autocommit:bool=True) -> MySQLdb.Connection:
    db_conf = {
        "host": ${tidb_host},
        "port": ${tidb_port},
        "user": ${tidb_user},
        "password": ${tidb_password},
        "database": ${tidb_db_name},
        "autocommit": autocommit
    }

    if ${ca_path}:
        db_conf["ssl_mode"] = "VERIFY_IDENTITY"
        db_conf["ssl"] = {"ca": ${ca_path}}

    return MySQLdb.connect(**db_conf)

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

データの挿入

with get_mysqlclient_connection(autocommit=True) as conn:
    with conn.cursor() as cur:
        player = ("1", 1, 1)
        cursor.execute("INSERT INTO players (id, coins, goods) VALUES (%s, %s, %s)", player)

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

クエリデータ

with get_mysqlclient_connection(autocommit=True) as conn:
    with conn.cursor() as cur:
        cur.execute("SELECT count(*) FROM players")
        print(cur.fetchone()[0])

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

データを更新する

with get_mysqlclient_connection(autocommit=True) as conn:
    with conn.cursor() as cur:
        player_id, amount, price="1", 10, 500
        cursor.execute(
            "UPDATE players SET goods = goods + %s, coins = coins + %s WHERE id = %s",
            (-amount, price, player_id),
        )

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

データの削除

with get_mysqlclient_connection(autocommit=True) as conn:
    with conn.cursor() as cur:
        player_id = "1"
        cursor.execute("DELETE FROM players WHERE id = %s", (player_id,))

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

便利なメモ

ドライバーまたは ORM フレームワークを使用していますか?

Python ドライバーはデータベースへの低レベルのアクセスを提供しますが、開発者は次のことを行う必要があります。

• データベース接続を手動で確立および解放します。
• データベーストランザクションを手動で管理します。
• データ行 ( mysqlclientではタプルとして表されます) をデータ オブジェクトに手動でマップします。

複雑な SQL ステートメントを記述する必要がない限り、開発にはSQLアルケミー 、 ピーウィー 、Django ORM などのORMフレームワークを使用することをお勧めします。それはあなたに役立ちます:

• 接続とトランザクションの管理のために定型コードを減らします。
• 多数の SQL ステートメントの代わりにデータ オブジェクトを使用してデータを操作します。

次のステップ

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

助けが必要？

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