Tablestore:検索インデックスを作成する

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

次のサンプルコードは、デフォルト設定を使用して検索インデックスを作成する方法の例を示しています。この例では、検索インデックスは、Keyword 型の Col_Keyword フィールド、Long 型の Col_Long フィールド、Vector 型の 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 パラメータを指定して検索インデックスを作成する

次のサンプルコードは、indexSort パラメータを指定して検索インデックスを作成する方法の例を示しています。この例では、検索インデックスは、Keyword 型の Col_Keyword フィールド、Long 型の Col_Long フィールド、Text 型の Col_Text フィールド、Long 型の 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 を指定して検索インデックスを作成する方法の例を示しています。この例では、検索インデックスは、Keyword 型の Col_Keyword フィールドと Long 型の 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);
}

仮想列を指定して検索インデックスを作成する

次のサンプルコードは、仮想列を指定して検索インデックスを作成する方法の例を示しています。この例では、検索インデックスは、Keyword 型の Col_Keyword フィールドと Long 型の Col_Long フィールドで構成されています。さらに、Long 型の Col_Keyword_Virtual_Long と Keyword 型の Col_Long_Virtual_Keyword という仮想列が作成されます。Col_Keyword_Virtual_Long フィールドはデータテーブルの Col_Keyword 列にマッピングされ、Col_Long_Virtual_Keyword フィールドはデータテーブルの Col_Long 列にマッピングされます。

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);
}

ハイライト機能を有効にして検索インデックスを作成する

次のサンプルコードは、ハイライト機能を有効にして検索インデックスを作成する方法の例を示しています。この例では、検索インデックスは、Keyword 型の Col_Keyword フィールド、Long 型の Col_Long フィールド、Text 型の Col_Text フィールドで構成されています。さらに、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),
            // Col_Text フィールドでハイライト機能を有効にします。
            new FieldSchema("Col_Text", FieldType.TEXT).setIndex(true).setEnableHighlighting(true)
    ));
    request.setIndexSchema(indexSchema);
    // クライアントを呼び出して検索インデックスを作成します。
    client.createSearchIndex(request);
}