Tablestore:仮想カラム

Tablestore コンソールで多次元インデックスを作成する際にフィールドを仮想カラムとして指定した後、その仮想カラムを使用してデータをクエリします。

1. [インデックス] タブに移動します。

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

   2. 上部のナビゲーションバーで、リージョンとリソースグループを選択します。

   3. [概要] ページで、管理するインスタンスの名前をクリックするか、インスタンスの [操作] 列にある [インスタンスの管理] をクリックします。

   4. [インスタンス詳細] タブの [テーブル] セクションで、多次元インデックスを作成するデータテーブルの名前をクリックします。[テーブルの管理] ページで、[インデックス] をクリックします。または、データテーブルの [操作] 列にある [インデックス] をクリックすることもできます。

2. [インデックス] タブで、[多次元インデックスの作成] をクリックします。

3. [インデックスの作成] ダイアログボックスで、多次元インデックスを作成する際に仮想カラムを指定します。

   

   1. デフォルトでは、システムが多次元インデックスの名前を生成します。多次元インデックスの名前を自分で指定することもできます。

   2. [スキーマ生成タイプ] パラメーターを設定します。

      • [スキーマ生成タイプ] を [手動] に設定した場合は、追加する各フィールドのフィールド名を入力し、フィールドタイプと配列を有効にするかどうかを指定します。

      • [スキーマ生成タイプ] を [自動生成] に設定した場合は、システムが自動的にデータテーブルのプライマリキー列と属性列をインデックスフィールドとして使用します。ビジネス要件に基づいて、システムが自動的に追加した各フィールドのフィールドタイプと配列を有効にするかどうかを指定します。

      説明

      [フィールド名] と [フィールドタイプ] の値は、データテーブルの値と一致する必要があります。データテーブルのフィールドタイプと多次元インデックスのフィールドタイプのマッピングについては、「データの型」をご参照ください。

   3. 仮想カラムを作成します。

      重要

      仮想カラムを作成するには、データテーブルにソースフィールドが含まれている必要があり、ソースフィールドのデータの型が仮想カラムのデータの型と一致している必要があります。

      1. アイコンをクリックします。

      2. [フィールド名] と [フィールドタイプ] パラメーターを設定します。

      3. フィールドの [仮想フィールド] を有効にし、[インデックスフィールド名] の値を指定します。

   4. 多次元インデックスのルーティングキー、生存時間 (TTL)、または事前ソートメソッドを指定する場合は、[詳細設定] を有効にします。詳細については、「多次元インデックスの作成」をご参照ください。

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

      多次元インデックスを作成した後、[インデックス] タブで多次元インデックスの [操作] 列にある [インデックス詳細] をクリックします。[インデックス詳細] ページで、[基本インデックス情報]、[インデックスメトリック]、[ルーティングキー]、[インデックスフィールド]、[事前ソート] の各セクションのパラメーター設定を表示します。

4. 仮想カラムを使用してデータをクエリします。

   1. 多次元インデックスの [操作] 列にある [データの管理] をクリックします。

   2. [検索] ダイアログボックスで、パラメーターを設定します。

      

      1. デフォルトでは、システムはすべての属性列を返します。特定の属性列を返すには、[すべての列] を無効にし、返したい属性列を指定します。属性列はカンマ (,) で区切ります。

      2. インデックスフィールドを選択し、[追加] をクリックしてインデックスフィールドをクエリ条件として追加します。インデックスフィールドのクエリタイプと値を指定します。このステップを繰り返して、ビジネス要件に基づいてクエリ条件を追加します。

      3. デフォルトでは、ソート機能は無効になっています。ソートを有効にするには、[ソート] を有効にし、クエリ結果のソート基準となるインデックスフィールドを追加して、ソートメソッドを設定します。

      4. デフォルトでは、集約機能は無効になっています。特定のフィールドの統計を収集する場合は、[統計の収集] を有効にし、統計を収集するフィールドを指定してから、統計の収集に必要な情報を設定します。

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

         クエリ条件を満たすデータが、[インデックス] タブで指定された順序で表示されます。

Tablestore SDK を使用して多次元インデックスを作成する際にフィールドを仮想カラムとして指定した後、その仮想カラムを使用してデータをクエリします。

1. 多次元インデックスを作成し、仮想カラムを指定します。

   説明

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

   次のサンプルコードは、Col_Keyword 列と Col_Long 列で構成される多次元インデックスを作成する例です。各列には仮想カラムがあります。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); 
   }

2. 仮想カラムを使用してデータをクエリします。

   次のサンプルコードは、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); // ReturnAll を true に設定して、仮想カラムを返さずにすべての列を返します。 
       searchRequest.setColumnsToGet(columnsToGet);
   
       SearchResponse resp = client.search(searchRequest);
       System.out.println("TotalCount: " + resp.getTotalCount()); // 返された行数ではなく、クエリ条件を満たす行の総数を表示するように指定します。 
       System.out.println("Row: " + resp.getRows());
   }