NoSQLテーブルからアイテムを取得

Catalystでは、プライマリキーを使用してアイテムを識別し、NoSQLテーブルからアイテムを取得できます。例えば、パーティションキーのみ、またはパーティションキーとソートキーの組み合わせを使用してアイテムを取得できます。また、必要な属性を指定して、取得する属性をオプションでフィルタリングすることもできます。

ZCNoSQLTableインスタンスを使用して特定の属性をフィルタリングせずにデータを取得するか、リクエストの各部分を構築するために使用できるZCNoSQLFetchHelperインスタンスを使用して取得できます。

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

//public ZCNoSQLResponseBean fetch(ZCNoSQLItem key) throws Exception;
table.fetch(<ZCNoSQLItem>);

ZCNoSQLFetchHelperで取得する場合

ZCNoSQLFetchHelper

このクラスは、テーブルからデータを取得し、特定の属性をフィルタリングするために使用できます。ZCNoSQLTableインスタンスから取得できます。

//public ZCNoSQLFetchHelper getFetchHelper(ZCNoSQLItem key) throws Exception;
//public ZCNoSQLResponseBean fetch() throws Exception;
table.getFetchHelper(<ZCNoSQLItem>).fetch();

ZCNoSQLFetchHelperで利用可能なその他のメソッド

必要な属性

このメソッドを使用して、特定の必要な属性のみをフィルタリングして取得できます。

/public ZCNoSQLFetchHelper withRequiredAttributes(List<ZCNoSQLAttribute> requiredAttributesList) throws Exception;
table.getFetchHelper(<ZCNoSQLItem>).withRequiredAttributes(<List of ZCNoSQLAttributes>).fetch();

また、consistencyを使用して、読み取り操作をマスターまたはスレーブクラスターのどちらで実行するかを指定できます。trueに設定すると、マスターからクエリされます。falseの場合、スレーブからクエリされます。

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

//public ZCNoSQLFetchHelper withConsistency(boolean consistency) throws Exception;
table.getFetchHelper(<ZCNoSQLItem>).withConsistency(true/false).fetch();

必要な属性とconsistencyを指定した取得

table.getFetchHelper(<ZCNoSQLItem>).withRequiredAttributes(<List of ZCNoSQLAttributes>).withConsistency(true/false).fetch();