---
title: "NoSQLインデックスのクエリ"
url: https://docs.catalyst.zoho.com/ja/sdk/java/v1/cloud-scale/nosql/query-index/
description: "Catalyst NoSQLは、非リレーショナル、非SQLのデータストレージ手段を提供する完全マネージドの強力なデータベースです。このページでは、NoSQLテーブルのメタデータを取得するSDKメソッドについて説明します。"
last_updated: 2026-02-23T12:39:41Z
service: Cloud Scale
type: general
related_links:
  - name: "NoSQL"
    url: /ja/cloud-scale/help/nosql/introduction/
  - name: "NoSQL API"
    url: /ja/api/code-reference/cloud-scale/nosql/insert-item/#InsertNewItem
---

# NoSQLインデックスのクエリ

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

> **注意:** Catalystでは、1回のSDK操作でNoSQLテーブルからページネーション付きで最大100個のアイテムを一括で取得できます。

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

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

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

ZCNoSQLQueryHelperでクエリする場合

ZCNoSQLQueryHelper

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

```java
//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キーは使用できない点が異なります。
    
その他の条件

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

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

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

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