基本的なCRUD操作

この例では、 pytidb （TiDBの公式Python SDK）を使用して、基本的なCRUD（作成、読み取り、更新、削除）操作を示します。

1. pytidbクライアントを使用してTiDBに接続します。
2. テキスト、ベクター、JSONの列を持つテーブルを作成します。
3. データに対して基本的なCRUD操作を実行します。

前提条件

始める前に、以下のものを用意してください。

• Python (>=3.10) : Python 3.10以降のバージョンをインストールしてください。
• TiDB Cloud Starterインスタンス: TiDB Cloudで無料のTiDB Cloud Starterインスタンスを作成できます。

実行方法

ステップ1. pytidbリポジトリをクローンする

git clone https://github.com/pingcap/pytidb.git
cd pytidb/examples/basic/

ステップ2. 必要なパッケージをインストールします

python -m venv .venv
source .venv/bin/activate
pip install -r reqs.txt

ステップ3．環境変数を設定する

1. TiDB Cloudコンソールで、私のTiDBページに移動し、ターゲットのTiDB Cloud Starterインスタンスの名前をクリックして、その概要ページに移動します。
2. 右上隅の「接続」をクリックします。接続ダイアログが表示され、接続パラメータが表示されます。
3. 接続パラメータに応じて環境変数を以下のように設定してください。

cat > .env <<EOF
TIDB_HOST={gateway-region}.prod.aws.tidbcloud.com
TIDB_PORT=4000
TIDB_USERNAME={prefix}.root
TIDB_PASSWORD={password}
TIDB_DATABASE=test
EOF

ステップ4．デモを実行する

python main.py

期待される出力:

=== CREATE TABLE ===
Table created

=== TRUNCATE TABLE ===
Table truncated

=== CREATE ===
Created 3 items

=== READ ===
ID: 1, Content: TiDB is a distributed SQL database, Metadata: {'category': 'database'}
ID: 2, Content: GPT-4 is a large language model, Metadata: {'category': 'llm'}
ID: 3, Content: LlamaIndex is a Python library for building AI-powered applications, Metadata: {'category': 'rag'}

=== UPDATE ===
Updated item #1
After update - ID: 1, Content: TiDB Cloud Starter is a fully-managed, auto-scaling cloud database service, Metadata: {'category': 'dbass'}

=== DELETE ===
Deleted item #2

=== FINAL STATE ===
ID: 1, Content: TiDB Cloud Starter is a fully-managed, auto-scaling cloud database service, Metadata: {'category': 'dbass'}
ID: 3, Content: LlamaIndex is a Python library for building AI-powered applications, Metadata: {'category': 'rag'}

=== COUNT ROWS ===
Number of rows: 2

=== DROP TABLE ===
Table dropped

Basic CRUD operations completed!

関連リソース

• ソースコード： GitHubでビュー