Java SDK で仮想カラム機能を使用する - Tablestore - Alibaba Cloud ドキュメントセンター

仮想カラム機能を使用すると、Tablestore のストレージ構造やデータを変更することなく、多次元インデックスのスキーマを変更したり、新しい多次元インデックスを作成したりすることで、新しいフィールドやデータ型をクエリできます。

前提条件

Tablestore クライアントが初期化されていること。詳細については、「Tablestore クライアントの初期化」をご参照ください。
データテーブルが作成されており、次の条件を満たしていること。詳細については、「データテーブルの作成」をご参照ください。
- バージョンの最大数が 1 であること。
- 生存時間 (TTL) が -1 であるか、データテーブルの更新が禁止されていること。

注意事項

仮想カラムは、文字列型と他のデータ型との間の変換をサポートしています。変換ルールについての詳細は、次の表をご参照ください。

データテーブルのフィールドタイプ	仮想カラムのフィールドタイプ
文字列	Keyword (および配列)
	FuzzyKeyword (および配列)
	Text (および配列)
	Long (および配列)
	Double (および配列)
	Date (および配列)
	IP (および配列)
	Geo-point (および配列)
Long	Keyword
	FuzzyKeyword
	Text
	Date
Double	Keyword
	FuzzyKeyword
	Text

仮想カラムは検索文でのみ使用できます。`ColumnsToGet` でカラム値を返すために使用することはできません。カラム値を返すには、仮想カラムがマップされている元のカラムを指定する必要があります。

パラメーター

詳細については、「多次元インデックスの作成」をご参照ください。

例

多次元インデックスを作成する際に仮想カラムを指定します。

次の例では、`Col_Keyword` と `Col_Long` の 2 つのカラムを持つ多次元インデックスを作成します。この例では、データテーブルの `Col_Keyword` カラムにマップされる `Col_Keyword_Virtual_Long` と、データテーブルの `Col_Long` カラムにマップされる `Col_Long_Virtual_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_Long_Virtual_Keyword` カラムの値が "1000" である行をクエリする方法を示します。クエリは、一致した行の総数とそれらの行のサブセットを返します。

private static void query(SyncClient client) {
    SearchQuery searchQuery = new SearchQuery();
    TermsQuery termsQuery = new TermsQuery(); // クエリタイプを TermsQuery に設定します。
    termsQuery.setFieldName("Col_Long_Virtual_Keyword"); // 一致させるフィールドを設定します。
    termsQuery.addTerm(ColumnValue.fromString("1000")); // 一致させる値を設定します。
    searchQuery.setQuery(termsQuery);
    searchQuery.setGetTotalCount(true); // 一致した行の総数を返します。
    SearchRequest searchRequest = new SearchRequest("<TABLE_NAME>", "<SEARCH_INDEX_NAME>", searchQuery);
    SearchRequest.ColumnsToGet columnsToGet = new SearchRequest.ColumnsToGet();
    columnsToGet.setReturnAll(true); // すべてのカラムを返します。仮想カラムは返されません。
    searchRequest.setColumnsToGet(columnsToGet);

    SearchResponse resp = client.search(searchRequest);
    System.out.println("TotalCount: " + resp.getTotalCount()); // この応答の行数ではなく、一致した行の総数。
    System.out.println("Row: " + resp.getRows());
}

Tablestore:仮想カラム

前提条件

注意事項

パラメーター

例

関連ドキュメント