Tablestore:自動採番主キー列

1. 自動採番主キー列を持つデータテーブルを作成します。

   1. Tablestore コンソールにログインします。

   2. [概要] ページで、インスタンスの [アクション] 列にある [インスタンス管理] をクリックします。

   3. [インスタンス詳細] タブの [データテーブルリスト] セクションで、[データテーブルの作成] をクリックします。

   4. [データテーブルの作成] ダイアログボックスで、[データテーブル名] と [テーブルプライマリキー] を設定します。必要に応じて他のパラメーターを設定します。

      テーブルプライマリキーを設定するときは、パーティションキーではないプライマリキー列のタイプとして [自動インクリメント列] を選択します。

      説明

      パラメーター設定の詳細については、「データテーブル操作」をご参照ください。

   5. [作成] をクリックします。

2. データを書き込みます。

   1. [インスタンス詳細] タブの [データテーブルリスト] セクションで、データテーブル名をクリックします。

   2. [データ管理] タブで、[データの挿入] をクリックします。

   3. [データの挿入] ダイアログボックスで、プライマリキー値を入力し、必要に応じて属性列を追加します。

      自動インクリメント列の値を入力する必要はありません。データが書き込まれると、システムが自動的に値を生成します。複数の属性列を追加するには、 アイコンを複数回クリックし、各属性列の名前、タイプ、および値を設定します。

   4. [OK] をクリックします。

      システムは正常に書き込まれたデータを表示します。後続のデータ更新または読み取りのために、行の完全なプライマリキーを記録します。

1. 自動採番主キー列を持つデータテーブルを作成して使用します。

   1. create コマンドを実行してデータテーブルを作成します。詳細については、「テーブルを作成する」をご参照ください。

      次の例では、自動採番主キー列を持つ mytable という名前のデータテーブルを作成します。このテーブルには、uid (文字列型) と pid (整数型) の 2 つのプライマリキー列があります。2 番目のプライマリキー列 pid は、自動インクリメント列として設定されます。テーブル内のデータは有効期限が切れることはありません。

      create -t mytable --pk '[{"c":"uid", "t":"string"}, {"c":"pid", "t":"integer", "opt":"auto"}]'

   2. use --wc -t mytable コマンドを実行してデータテーブルを使用します。

2. put コマンドを実行してデータの行を書き込みます。詳細については、「新しいデータを挿入する」をご参照ください。

   説明

   データを書き込んだ後、完全なプライマリキー情報を取得するには、scan コマンドを実行して指定された行データを取得できます。詳細については、「データをスキャンする」または「データをエクスポートする」をご参照ください。

   次の例では、データテーブルにデータの行を挿入します。最初のプライマリキー列の値は "86" です。2 番目のプライマリキー列の値は null です。この行には、name (文字列型) と country (文字列型) の 2 つの属性列があります。

   put --pk '["86", null]' --attr '[{"c":"name", "v":"redchen"}, {"c":"country", "v":"china"}]'

自動採番主キー列機能は、Java SDK、Go SDK、Python SDK、Node.js SDK、.NET SDK、および PHP SDK で使用できます。このセクションでは、Java SDK を例として使用します。

次のサンプルコードは、test_table テーブルにデータの行を書き込み、その行のプライマリキー情報を取得して出力する方法の例を示しています。

public static void putRowTest(SyncClient client) {
    // プライマリキーを構築します。
    PrimaryKeyBuilder primaryKeyBuilder = PrimaryKeyBuilder.createPrimaryKeyBuilder();
    primaryKeyBuilder.addPrimaryKeyColumn("id", PrimaryKeyValue.fromString("row1"));
    // 自動採番主キー列の値をプレースホルダーに設定します。
    primaryKeyBuilder.addPrimaryKeyColumn("incr", PrimaryKeyValue.AUTO_INCREMENT);
    PrimaryKey primaryKey = primaryKeyBuilder.build();

    // 書き込む行データを構築します。
    RowPutChange rowPutChange = new RowPutChange("test_table", primaryKey);
    rowPutChange.addColumn("col1", ColumnValue.fromString("val1"));
    // 戻り値の型を RT_PK に設定して、書き込まれた行のプライマリキー情報を返します。
    rowPutChange.setReturnType(ReturnType.RT_PK);

    // putRow メソッドを呼び出して、データの行を書き込みます。
    PutRowRequest putRowRequest = new PutRowRequest();
    putRowRequest.setRowChange(rowPutChange);
    PutRowResponse putRowResponse = client.putRow(putRowRequest);

    // リクエスト ID と読み取り/書き込み CU 消費量を表示します。
    System.out.println("RequestId: " + putRowResponse.getRequestId());
    System.out.println("Read CU Cost: " + putRowResponse.getConsumedCapacity().getCapacityUnit().getReadCapacityUnit());
    System.out.println("Write CU Cost: " + putRowResponse.getConsumedCapacity().getCapacityUnit().getWriteCapacityUnit());

    // 返されたプライマリキー情報を取得して出力します。戻り値の型が RT_PK に設定されていない場合、プライマリキー情報は返されません。
    Row row = putRowResponse.getRow();
    if(row != null)
        System.out.println(row.getPrimaryKey().toString());
}