NoSQL

Catalyst NoSQLは、アプリケーションの半構造化、非構造化、および異種データを保存できるフルマネージドの非リレーショナルNoSQLデータストレージ機能です。Catalystは、キーバリューペアベースのJSON形式でのドキュメントタイプのデータストレージをサポートしています。

Catalyst NoSQL APIを使用すると、NoSQLテーブルでCRUD操作を実行できます。アイテムの挿入、更新、削除、取得、およびテーブルやテーブルのインデックスに対するクエリの実行が可能です。

アイテムの挿入

説明

このAPIを使用すると、プロジェクト内のNoSQLテーブルに新しいアイテムを挿入できます。テーブルは一意のIDまたは名前で参照されます。

カスタムJSON形式でデータを渡すことで、条件を指定してもしなくてもアイテムを挿入できます。

注意: テーブルは既に作成されている必要があります。コンソールからNoSQLテーブルを作成できます。

リクエスト詳細

リクエストURL

POST

{api-domain}/baas/v1/project/{{project_id}}/nosqltable/{{table_identifier}}/item

copy

api-domain

URL

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

project_id

Numerical

プロジェクトの一意のID

table_identifier

Numerical

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

リクエストヘッダー

Authorization: Zoho-oauthtoken {oauth_token}
Content-Type: application/json

オプションヘッダー

CATALYST-ORG: {org_id}

Environment: Development

スコープ

ZohoCatalyst.nosql.item.INSERT

注意: この操作は、Catalyst SDKを使用してCatalystユーザー認証権限でも実行できます。詳細については、Catalyst API前提条件セクションを参照してください。

リクエストJSONプロパティ

item json

mandatory

テーブルに挿入するメインデータを含みます。アイテムはカスタムJSON形式で挿入する必要があります。テーブルがシンプルなプライマリキーで構成されている場合は、パーティションキーを指定します。テーブルが複合プライマリキーで構成されている場合は、パーティションキーとソートキーの両方を指定します。

condition json

optional

テーブルの既存データが取得され、この条件に対して評価されます。評価がtrueの場合にのみアイテムが挿入されます。既存データがない場合、条件は無視されアイテムが挿入されます。条件を初期化するには3つの方法があります：

functions json

mandatory (if specifying condition)

2つの組み込み関数があります：属性の存在を確認するために使用できるattribute_existと、指定された属性名が指定された型に属するかどうかを確認するために使用できるattribute_typeです。

operator, attribute, value json

optional

直接比較操作を実行するために使用します。サポートされる演算子：contains、not_contains、begins_with、ends_with、in、not_in、between、not_between、equals、not_equals、greater_than、less_than、greater_equal、less_equal。

group, group operator json

optional

2つ以上の条件を組み合わせるために使用します。サポートされるグループ演算子：and、or。

negate json

optional

条件の結果を否定するために使用します。

レスポンス詳細

レスポンスには、挿入操作のステータスと、設定されている場合はtable_name、partition_key、sort_keyなど挿入されたアイテムの詳細が返されます。

リクエスト例
copy

curl -X POST 

https://api.catalyst.zoho.com/baas/v1/project/4000000006007/nosqltable/3376000003171728/item 

-H “Authorization: Zoho-oauthtoken 1000.910*************************16.2f*************************57” 

-H “Content-Type:application/json” 

-d ‘{
“item”: {
“EmpID”: {
“N”: “10999”
},
“FirstName”:{
“S”: “Paul”
},
“LastName”:{
“S”: “Smith”
},
“PriorExperience”:{
“BOOL”: false
},
“Location”: {
“M”: {
“Country”: {
“S”: “USA”
},
“City”: {
“S”: “New York”
}
}
}
}
}’

レスポンス例
copy

         {
"status": "success",
"data": {
    "table_name": "employeeDetails",
    "project_details": {
        "id": 4000000006007,
        "project_name": "EmpDatabase",
        "project_type": "Live"
    }
}
}


    

Insert Items- Java SDK

Insert Items- Node.js SDK

Insert Items- Python SDK

Yes

Thank you for your feedback!

Send your feedback to us

Skip

Submit