Tablestore:多次元インデックスの作成

デフォルト設定での多次元インデックスの作成

次の例は、多次元インデックスを作成する方法を示しています。インデックスには、Col_Keyword (KEYWORD 型)、Col_Long (LONG 型)、Col_Vector (VECTOR 型) の 3 つのカラムが含まれています。データはデータテーブルのプライマリキーによって事前ソートされ、有効期限はありません。

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 (KEYWORD 型)、Col_Long (LONG 型)、Col_Text (TEXT 型)、Timestamp (LONG 型) の 4 つのカラムが含まれています。データは 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);
}

多次元インデックスの作成とライフサイクルの設定

次の例は、多次元インデックスを作成する方法を示しています。インデックスには、Col_Keyword (KEYWORD 型) と Col_Long (LONG 型) の 2 つのカラムが含まれています。多次元インデックスのライフサイクルは 7 日間に設定されています。

// Tablestore SDK for Java 5.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);
}

多次元インデックスの作成と仮想カラムの指定

次の例は、2 つのカラム (Col_Keyword (KEYWORD 型) と Col_Long (LONG 型)) を含む多次元インデックスを作成する方法を示しています。このインデックスには、データテーブルの Col_Keyword カラムにマッピングされる Col_Keyword_Virtual_Long (LONG 型) と、データテーブルの Col_Long カラムにマッピングされる Col_Long_Virtual_Keyword (KEYWORD 型) の 2 つの仮想カラムも含まれています。

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_Keyword_Virtual_Long", FieldType.LONG) 
             // フィールドが仮想カラムであるかどうかを指定します。
            .setVirtualField(true) 
             // 仮想カラムに対応するデータテーブル内のフィールド。
            .setSourceFieldName("Col_Keyword"), 
        new FieldSchema("Col_Long", FieldType.LONG),
        new FieldSchema("Col_Long_Virtual_Keyword", FieldType.KEYWORD)
            .setVirtualField(true)
            .setSourceFieldName("Col_Long")));
    request.setIndexSchema(indexSchema);
    // クライアントを呼び出して多次元インデックスを作成します。
    client.createSearchIndex(request); 
}

多次元インデックス作成時のまとめとハイライトの有効化

次の例は、多次元インデックスを作成する方法を示しています。インデックスには、Col_Keyword (KEYWORD 型)、Col_Long (LONG 型)、Col_Text (TEXT 型) の 3 つのカラムが含まれています。Col_Text カラムでは、まとめとハイライト機能が有効になっています。

private static void createSearchIndexWithHighlighting(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).setIndex(true).setEnableHighlighting(true)
    ));
    request.setIndexSchema(indexSchema);
    // クライアントを呼び出して多次元インデックスを作成します。
    client.createSearchIndex(request); 
}