NoSQLインデックスのクエリ

Catalystでは、インデックスのプライマリキーを使用してアイテムを識別し、NoSQLインデックスをクエリしてデータを取得できます。インデックスを使用すると、メインテーブルのプライマリキーを使用せずにテーブルデータに対して代替クエリを実行できます。Catalystコンソールからインデックスを構成できます。そのため、インデックスのパーティションキーのみ、またはパーティションキーとソートキーの組み合わせを使用してアイテムを取得できます。

属性、必要な値、および使用するサポートされている演算子を指定して、アイテムを識別するキー条件を定義できます。サポートされる演算子のリストおよびCatalystコンソールからのクエリに関するヘルプセクションを参照してください。

ZCNoSQLTableインスタンスでデータをクエリするには、以下を使用します。

//public ZCNoSQLResponseBean queryIndex(Long indexID, ZCNoSQLPartitionKeyCondition partitionKeyCondition, boolean forwardScan, int limit) throws Exception;
table.queryIndex(<indexID>, <ZCNoSQLPartitionKeyCondition>, <true/false>, <limit>);

ZCNoSQLQueryHelperでクエリする場合

ZCNoSQLQueryHelper

このクラスは、インデックスからデータをクエリし、その他の条件、ソート順、制限などを指定するために使用できます。ZCNoSQLTableインスタンスから取得できます。

//public ZCNoSQLQueryHelper getQueryHelper(ZCNoSQLPartitionKeyCondition partitionKeyCondition, boolean forwardScan, int limit) throws Exception;
//public ZCNoSQLResponseBean queryTable() throws Exception;
table.getQueryHelper(<ZCNoSQLPartitionKeyCondition>, <true/false>, <limit>).queryIndex(<indexID>);

ZCNoSQLPartitionKeyCondition

上記で説明した同じパーティションキー条件をここでも再利用できます。 ZCNoSQLQueryHelperで利用可能なその他のメソッド

必要な属性

上記で説明した同じ必要な属性をここでも再利用できます。

Consistency

Catalyst NoSQLでは、consistent_readを使用して読み取り操作をマスターまたはスレーブクラスターのどちらで実行するかを指定する、返される行数を制限する、昇順でソート順を指定するなど、クエリの他の要素も定義できます。

注意: マスター・スレーブレプリケーションでは、マスターにデータベースのすべてのデータが含まれ、スレーブにマスターからのコピーが含まれます。スレーブから読み取り操作を実行すると、全体的なコストを削減できますが、更新されたデータの反映にわずかな遅延が生じるトレードオフがあります。

セカンダリキー条件

上記で説明した同じセカンダリキー条件をここでも再利用できますが、インデックスではadditionalSortキーは使用できない点が異なります。

その他の条件

テーブルのクエリで説明したその他の条件もここで再利用できます。

開始キー

上記で説明した同じ開始キーをここでも使用できます。

すべての組み合わせを使用したインデックスクエリ

table.getQueryHelper(ZCNoSQLPartitionKeyCondition>, <true/false>, <limit>)
    .withSecondaryKSeyCondition(<ZCNoSQLSecondaryKeyCondition>, false)
    .withOtherCondition(<ZCNoSQLCondition>)
    .withRequiredAttributes(<List of ZCNoSQLAttributes>)
    .withConsistency(true/false)
    .withStartKey(<ZCNoSQLItem>)
    .queryIndex(<indexID>);