すべてのプロダクト
Search
ドキュメントセンター

Tablestore:1 行の削除

最終更新日:Mar 31, 2026

Tablestore Python SDK を使用して、Tablestore テーブルから 1 行のデータを削除します。

前提条件

Tablestore クライアントの初期化

メソッド

def delete_row(self, table_name, row=None, condition=None, return_type=None, transaction_id=None, **kwargs)

パラメーター

パラメーター

説明

table_name (必須)

str

テーブル名です。

row (必須)

Row

削除対象の行です。

  • primary_key (必須)List[Tuple]: プライマリキーに関する情報で、プライマリキー列の名前とその値を含みます。

    • プライマリキー列で有効なデータの型: STRING、INTEGER、BINARY。

    • プライマリキー列の数および型は、テーブル定義と一致している必要があります。

condition (任意)

Condition

削除条件です。詳細については、「条件付き更新」をご参照ください。

return_type (任意)

ReturnType

戻り値の型です。

  • RT_NONE (デフォルト): 何も返されません。

  • RT_PK: プライマリキー列が返されます。

transaction_id (任意)

str

ローカルトランザクションの一意の ID です。詳細については、「ローカルトランザクション」をご参照ください。

サンプルコード

以下のサンプルコードでは、test_table テーブルからプライマリキーの値が row1 の行を削除します。

try:
    # プライマリキーを構築します。
    primary_key = [('id', 'row1')]

    # 削除対象の行を構築します。
    row = Row(primary_key)

    # delete_row を呼び出して行を削除します。
    consumed, return_row = client.delete_row('test_table', row)
    print('読み取り CU コスト: %s' % consumed.read)
    print('書き込み CU コスト: %s' % consumed.write)
except Exception as e:
    print("行の削除に失敗しました。エラー: %s" % e)

よくある質問

Tablestore Python SDK 6.0.0 を使用して 1 行を削除する際にエラーが発生する

この問題を解決するには、以下のいずれかのソリューションを適用してください。

  • Tablestore Python SDK を最新バージョンにアップグレードします。

  • 削除メソッドのパラメーターを変更します。

    # テーブル名を設定します。
    table_name = '<TABLE_NAME>'
    # 行のプライマリキーを構築します。
    primary_key = [('gid', 1), ('uid', '101')]
    condition = Condition('IGNORE')
    try:
        consumed, return_row = client.delete_row(table_name, primary_key, condition)
        print('削除に成功しました。消費された書き込み CU: %s' % consumed.write)
    # クライアント例外(通常はパラメーターの誤りやネットワーク障害)を処理します。
    except OTSClientError as e:
        print("行の削除に失敗しました。HTTP ステータス: %d、エラーメッセージ: %s" % (e.get_http_status(), e.get_error_message()))
    # サーバー例外(通常はパラメーターの誤りや速度制限エラー)を処理します。
    except OTSServiceError as e:
        print("行の削除に失敗しました。HTTP ステータス: %d、エラーコード: %s、エラーメッセージ: %s、リクエスト ID: %s" % (
        e.get_http_status(), e.get_error_code(), e.get_error_message(), e.get_request_id()))

関連トピック

データの一括更新