---
title: "テーブルのクエリ"
url: https://docs.catalyst.zoho.com/ja/api/code-reference/cloud-scale/nosql/query-table/
service: Cloud Scale
type: api
---






# テーブルのクエリ

### 説明

このAPIを使用すると、プロジェクト内のNoSQLテーブルをクエリしてデータを取得できます。テーブルは一意のIDで参照されます。

### リクエスト詳細

#### リクエストURL

<p>{api-domain}/baas/v1/project/{{project_id}}/nosqltable/{{table_identifier}}/item/query</p>

Catalyst APIにアクセスするためのDC固有のドメイン

プロジェクトの一意のID

テーブルの一意のIDまたはテーブル名


#### リクエストヘッダー
 **Authorization:** Zoho-oauthtoken {oauth_token} <br>
 Content-Type: application/json <br>


**オプションヘッダー** <br>
 **CATALYST-ORG:** {org_id}

 **Environment:** Development


#### スコープ

ZohoCatalyst.nosql.POST



 注意: この操作は、Catalyst SDKを使用してCatalystユーザー認証権限でも実行できます。詳細については、[Catalyst API前提条件セクション](/ja/api/introduction/overview-and-prerequisites/#prerequisites)を参照してください。

### リクエストJSONプロパティ

アイテムのCRUD操作と同様の形式で条件を含みます。パーティションキーとソートキーの条件のみ指定できます。パーティションキーには「equals」演算子のみ使用できます。条件はパーティションキー = 値、またはパーティションキーのequals条件とソートキー条件を含むグループにできます。サポートされる演算子の完全なリストを参照してください。 

返される属性のリスト。  

読み取りをマスターまたはスレーブから行うかを宣言します。falseに設定すると、スレーブからクエリされます。許容される値：true、false。  

取得されたデータに適用される条件です。これらの条件が適用された後にレスポンスが送信されます。   

クエリを昇順または降順で実行するかを示すために使用します。 

ページネーション目的で次のデータアイテムセットを取得するために使用します。  

追加のソートキーを持つテーブルに対してクエリが行われるかどうかを示すために使用します。追加のソートキー属性名を含みます。  

返されるアイテムの最大件数を示します。   


### レスポンス詳細

レスポンスには、クエリ操作のステータスと、クエリで設定された条件に従って取得されたアイテムが返されます。







curl -X POST \
https://api.catalyst.zoho.com/baas/v1/project/4000000006007/nosqltable/3376000003171728/item/query \
-H "Authorization: Zoho-oauthtoken 1000.910*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*16.2f*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*57" \
-H "Content-Type:application/json" \
-d -d '{
	key_condition:{
		partition_key:{
			"S":"Country"
		},
		sort_key:{
			"N":"EmpID"
		},
	}
	required_attributes: {
		"EmpID",
 	"FirstName",
	"LastName",
	"PriorExperience"
  	},
	consistent_read: "true"
	}'




   {
    "status": "success",
    "data": {
        fetched_data:{
	"item": {
 	"EmpID": {
  	"N": "10999"
  	},
 	"FirstName":{
  	"S": "Paul"
  	},
 	"LastName":{
  	"S": "Smith"
  	},
 	"PriorExperience":{
  	"BOOL": false
  	}
  	}
    }
	}
	}
    

   

Query Table- Java SDK</br></br>
Query Table- Node.js SDK</br></br>
Query Table- Python SDK
</br></br>