---
title: "新規アイテムの挿入"
url: https://docs.catalyst.zoho.com/ja/api/code-reference/cloud-scale/nosql/insert-item/
description: "このAPIを使用すると、NoSQLテーブルに新しいアイテムを挿入できます。"
last_updated: 2026-02-23T12:39:41Z
service: Cloud Scale
type: api
---

# NoSQL

[Catalyst NoSQL](https://docs.catalyst.zoho.com/ja/cloud-scale/help/nosql/introduction/)は、アプリケーションの半構造化、非構造化、および異種データを保存できるフルマネージドの非リレーショナルNoSQLデータストレージ機能です。Catalystは、キーバリューペアベースのJSON形式でのドキュメントタイプのデータストレージをサポートしています。

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

# アイテムの挿入

### 説明

このAPIを使用すると、プロジェクト内の[NoSQL](https://docs.catalyst.zoho.com/ja/cloud-scale/help/nosql/introduction/)テーブルに新しいアイテムを挿入できます。テーブルは一意のIDまたは名前で参照されます。

[カスタムJSON形式](https://docs.catalyst.zoho.com/ja/cloud-scale/help/nosql/working-with-data/introduction/#the-catalyst-custom-json-format)でデータを渡すことで、条件を指定してもしなくてもアイテムを挿入できます。

> **注意:** テーブルは既に作成されている必要があります。コンソールからNoSQLテーブルを[作成](https://docs.catalyst.zoho.com/ja/cloud-scale/help/nosql/create-manage-tables/)できます。

### リクエスト詳細

#### リクエストURL

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

- **api-domain** (URL): Catalyst APIにアクセスするためのDC固有のドメイン

- **project_id** (Numerical): プロジェクトの[一意のID](https://docs.catalyst.zoho.com/ja/getting-started/set-up-a-catalyst-project/general-settings/)

- **table_identifier** (Numerical): テーブルの[一意のID](https://docs.catalyst.zoho.com/ja/cloud-scale/help/nosql/create-manage-tables/)またはテーブル名

#### リクエストヘッダー
 **Authorization:** Zoho-oauthtoken {oauth_token} 

 **Content-Type:** application/json 

**オプションヘッダー** 

 **CATALYST-ORG:** {org_id}

 **Environment:** Development

#### スコープ

ZohoCatalyst.nosql.item.INSERT

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

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

- **item** (json, mandatory):  テーブルに挿入するメインデータを含みます。アイテムは[カスタムJSON形式](https://docs.catalyst.zoho.com/ja/cloud-scale/help/nosql/working-with-data/introduction/#the-catalyst-custom-json-format)で挿入する必要があります。テーブルがシンプルなプライマリキーで構成されている場合は、[パーティションキー](https://docs.catalyst.zoho.com/ja/cloud-scale/help/nosql/components/#table-keys)を指定します。テーブルが複合プライマリキーで構成されている場合は、パーティションキーとソートキーの両方を指定します。  

- **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`など挿入されたアイテムの詳細が返されます。

**リクエスト例**

```bash
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"
    	}
   	}
  	}
}
    }'

```

**レスポンス例**

```json

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

### SDK Documentation

[Insert Items- Java SDK](https://docs.catalyst.zoho.com/ja/sdk/java/v1/cloud-scale/nosql/insert-items/)</br></br>
[Insert Items- Node.js SDK](https://docs.catalyst.zoho.com/ja/sdk/nodejs/v2/cloud-scale/nosql/insert-items/)</br></br>
[Insert Items- Python SDK](https://docs.catalyst.zoho.com/ja/sdk/python/v1/cloud-scale/nosql/insert-items/)
</br></br>