Tablestore:Tablestore SDK の使用

デフォルト設定を使用して検索インデックスを作成する

次のサンプルコードは、デフォルト設定を使用して検索インデックスを作成する方法の例を示しています。この例では、検索インデックスは、キーワード型の Col_Keyword フィールド、ロング型の Col_Long フィールド、およびベクトル型の Col_Vector フィールドで構成されています。検索インデックスのデータは、データテーブルのプライマリキーに基づいて事前ソートされ、期限切れになりません。

private static void createSearchIndex(SyncClient client) {
    CreateSearchIndexRequest request = new CreateSearchIndexRequest();
    // データテーブルの名前を指定します。
    request.setTableName("<TABLE_NAME>"); 
    // 検索インデックスの名前を指定します。
    request.setIndexName("<SEARCH_INDEX_NAME>"); 
    IndexSchema indexSchema = new IndexSchema();
    indexSchema.setFieldSchemas(Arrays.asList(
            // フィールドの名前と型を指定します。
            new FieldSchema("Col_Keyword", FieldType.KEYWORD), 
            new FieldSchema("Col_Long", FieldType.LONG),
            // ベクトルの型を指定します。
            new FieldSchema("Col_Vector", FieldType.VECTOR).setIndex(true)
                    // 次元数を 4 に設定し、ベクトルの距離測定アルゴリズムをドット積アルゴリズムに設定します。
                    .setVectorOptions(new VectorOptions(VectorDataType.FLOAT_32, 4, VectorMetricType.DOT_PRODUCT))
    ));
    request.setIndexSchema(indexSchema);
    // クライアントを呼び出して検索インデックスを作成します。
    client.createSearchIndex(request); 
}

検索インデックスを作成するときに事前ソート設定を行う

次のサンプルコードは、indexSort パラメータを指定して検索インデックスを作成する方法の例を示しています。この例では、検索インデックスは、キーワード型の Col_Keyword フィールド、ロング型の Col_Long フィールド、テキスト型の Col_Text フィールド、およびロング型の Timestamp フィールドで構成されています。検索インデックスのデータは、Timestamp フィールドに基づいて事前ソートされます。

private static void createSearchIndexWithIndexSort(SyncClient client) {
    CreateSearchIndexRequest request = new CreateSearchIndexRequest();
    // データテーブルの名前を指定します。
    request.setTableName("<TABLE_NAME>"); 
    // 検索インデックスの名前を指定します。
    request.setIndexName("<SEARCH_INDEX_NAME>"); 
    IndexSchema indexSchema = new IndexSchema();
    indexSchema.setFieldSchemas(Arrays.asList(
            new FieldSchema("Col_Keyword", FieldType.KEYWORD),
            new FieldSchema("Col_Long", FieldType.LONG),
            new FieldSchema("Col_Text", FieldType.TEXT),
            new FieldSchema("Timestamp", FieldType.LONG)
                    .setEnableSortAndAgg(true)));
    // Timestamp フィールドに基づいてデータを事前ソートします。
    indexSchema.setIndexSort(new Sort(
            Arrays.<Sort.Sorter>asList(new FieldSort("Timestamp", SortOrder.ASC))));
    request.setIndexSchema(indexSchema);
    // クライアントを呼び出して検索インデックスを作成します。
    client.createSearchIndex(request);
}

検索インデックスを作成するときに TTL を指定する

次のサンプルコードは、TTL を指定して検索インデックスを作成する方法の例を示しています。この例では、検索インデックスは、キーワード型の Col_Keyword フィールドとロング型の Col_Long フィールドで構成されています。検索インデックスの TTL は 7 日間です。

// 検索インデックスを作成するには、Tablestore SDK for Java V5.12.0 以降を使用してください。
public static void createIndexWithTTL(SyncClient client) {
    int days = 7;
    CreateSearchIndexRequest request = new CreateSearchIndexRequest();
    // データテーブルの名前を指定します。
    request.setTableName("<TABLE_NAME>");
    // 検索インデックスの名前を指定します。
    request.setIndexName("<SEARCH_INDEX_NAME>");
    IndexSchema indexSchema = new IndexSchema();
    indexSchema.setFieldSchemas(Arrays.asList(
            // フィールドの名前と型を指定します。
            new FieldSchema("Col_Keyword", FieldType.KEYWORD), 
            new FieldSchema("Col_Long", FieldType.LONG)));
    request.setIndexSchema(indexSchema);
    // 検索インデックスの TTL を指定します。
    request.setTimeToLiveInDays(days);
    // クライアントを呼び出して検索インデックスを作成します。
    client.createSearchIndex(request);
}

検索インデックスの詳細をクエリする

次のサンプルコードは、有効期限 (TTL)、作成時刻、同期ステータス、フィールド情報など、検索インデックスの詳細をクエリする方法の例を示しています。

private static DescribeSearchIndexResponse describeSearchIndex(SyncClient client) {
    DescribeSearchIndexRequest request = new DescribeSearchIndexRequest();
    // データテーブルの名前を指定します。
    request.setTableName("<TABLE_NAME>"); 
    // 検索インデックスの名前を指定します。
    request.setIndexName("<INDEX_NAME>"); 
    DescribeSearchIndexResponse response = client.describeSearchIndex(request);
    // レスポンスの詳細を表示します。
    System.out.println(response.jsonize()); 
    // 検索インデックス内のデータの同期ステータスを表示します。
    System.out.println(response.getSyncStat().getSyncPhase().name());
    return response;
}

検索インデックスのリストをクエリする

次のサンプルコードは、テーブルに作成された検索インデックスをリストする方法の例を示しています。

private static List<SearchIndexInfo> listSearchIndex(SyncClient client) {
    ListSearchIndexRequest request = new ListSearchIndexRequest();
    // データテーブルの名前を指定します。
    request.setTableName("<TABLE_NAME>"); 
    // データテーブルに作成されたすべての検索インデックスをクエリします。
    return client.listSearchIndex(request).getIndexInfos();
}

検索インデックスの TTL を変更する

検索インデックスを削除する

private static void deleteSearchIndex(SyncClient client) {
    DeleteSearchIndexRequest request = new DeleteSearchIndexRequest();
    request.setTableName("<TABLE_NAME>"); // データテーブルの名前を指定します。
    request.setIndexName("<SEARCH_INDEX_NAME>"); // 検索インデックスの名前を指定します。
    client.deleteSearchIndex(request); // クライアントを呼び出して検索インデックスを削除します。
}