---
title: "テーブルにアイテムを挿入"
url: https://docs.catalyst.zoho.com/ja/sdk/java/v1/cloud-scale/nosql/insert-items/
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: "Working with Data"
    url: /ja/cloud-scale/help/nosql/working-with-data/introduction/
  - name: "NoSQL API"
    url: /ja/api/code-reference/cloud-scale/nosql/insert-item/#InsertNewItem
---

# NoSQLテーブルにアイテムを挿入

Catalystでは、アイテムを構築した後、特定の[NoSQL](https://docs.catalyst.zoho.com/ja/cloud-scale/help/nosql/introduction/)テーブルにアイテムを挿入できます。このセクションで説明するように、アイテムはさまざまな方法で挿入できます。

データの追加と操作、[Catalystカスタム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/working-with-data/introduction/#supported-data-types)に関するヘルプセクションを参照して、これらのトピックの詳細を学ぶことができます。

> **注意:** Catalystでは、1回のSDK操作でNoSQLテーブルに最大25個のアイテムを一括で挿入できます。

### 条件なしでアイテムを挿入

`ZCNoSQLTable`インスタンス、またはリクエストの各部分を構築するために使用できる`ZCNoSQLInsertHelper`インスタンスを使用して、条件なしでNoSQLテーブルに新しいアイテムを挿入できます。

以下に示すように、`ZCNoSQLTable`インスタンスでデータを挿入できます。

```java
//public ZCNoSQLResponseBean insert(ZCNoSQLItem item) throws Exception;
table.insert(<ZCNoSQLItem>);
```

以下に示すように、`ZCNoSQLInsertHelper`インスタンスでデータを挿入できます。

```java
//public ZCNoSQLInsertHelper getInsertHelper(ZCNoSQLItem item) throws Exception;
//public ZCNoSQLResponseBean insert() throws Exception;
table.getInsertHelper(<ZCNoSQLItem>).insert();
```

このクラスは、条件付きでテーブルにデータを挿入するために使用できます。`ZCNoSQLTable`インスタンスから取得できます。

### 条件付きでアイテムを挿入

定義した特定の条件を使用して、NoSQLテーブルの既存アイテムに属性を挿入できます。このタイプでは、テーブルの既存データが取得され、指定された条件に対して評価されます。評価がtrueの場合にのみアイテムが挿入されます。既存データがない場合、条件は無視されアイテムが挿入されます。

以下のスニペットは、`ZCNoSQLCondition`を使用した条件付きアイテムの挿入を示しています。

```java
//public ZCNoSQLInsertHelper withCondition(ZCNoSQLCondition condition) throws Exception;
table.getInsertHelper(<ZCNoSQLItem>).withCondition(<ZCNoSQLCondition>).insert();
```

条件は、コンストラクタまたは`getInstance()`メソッドを呼び出して取得できる`ZCNoSQLCondition`インスタンスを使用して渡すことができます。条件は3つの方法で初期化できます。

#### 1. 関数を使用する方法

```java
//public static ZCNoSQLCondition getInstance(NoSQLConditionFunction function) throws Exception;
//public ZCNoSQLCondition(NoSQLConditionFunction function) throws Exception;
ZCNoSQLCondition.getInstance(<NoSQLCondtitionFunction>);
new ZCNoSQLCondition(<NoSQLCondtitionFunction>)
```

2つの組み込み関数が利用可能です。

**i. ZCNoSQLAttributeTypeFunction**

指定した属性のデータ型が指定したデータ型と一致するかどうかを確認します。

```java
//public ZCNoSQLAttributeTypeFunction(ZCNoSQLAttribute attribute, ZCNoSQLValue.DataType dataType) throws Exception;
//public static ZCNoSQLAttributeTypeFunction getInstance(ZCNoSQLAttribute attribute, ZCNoSQLValue.DataType dataType) throws Exception;
ZCNoSQLAttributeTypeFunction.getInstance(<ZCNoSQLAttribute>, <ZCNoSQLValue.DataType>);
new ZCNoSQLAttributeTypeFunction(<ZCNoSQLAttribute>, <ZCNoSQLValue.DataType>);
```

**ii. ZCNoSQLAttributeExistFunction **

取得したアイテムに属性が既に存在するかどうかを評価するために使用されます。

```java
//public ZCNoSQLAttributeExistFunction(ZCNoSQLAttribute attribute);
//public static ZCNoSQLAttributeExistFunction getInstance(ZCNoSQLAttribute attribute);
ZCNoSQLAttributeExistFunction.getInstance(<ZCNoSQLAttribute>);
new ZCNoSQLAttributeExistFunction(<ZCNoSQLAttribute>)
```

#### 2. 演算子、オペランド、値を使用する方法

```java
//public static ZCNoSQLCondition getInstance(ZCNoSQLAttribute attribute, NOSQL_OPERATOR operator, ZCNoSQLValue value) throws Exception;
//public ZCNoSQLCondition(ZCNoSQLAttribute attribute, NOSQL_OPERATOR operator, ZCNoSQLValue value) throws Exception;
ZCNoSQLCondition.getInstance(<ZCNoSQLAttribute>, <NOSQL_OPERATOR>, <ZCNoSQLValue>);
new ZCNoSQLCondition(<ZCNoSQLAttribute>, <NOSQL_OPERATOR>, <ZCNoSQLValue>);
```

#### NOSQL_OPERATOR

許可される`NOSQL_OPERATOR`の値は、`contains`、`not_contains`、`begins_with`、`ends_with`、`in`、`not_in`、`between`、`not_between`、`equals`、`not_equals`、`greater_than`、`less_than`、`greater_equal`、`less_equal`です。

#### 条件のグループを使用する方法

```java
//public static ZCNoSQLCondition getInstance(List<ZCNoSQLCondition> groups, NOSQL_CONDITION_GROUP_OPERATOR groupOperator) throws Exception;
//public ZCNoSQLCondition(List<ZCNoSQLCondition> groups, NOSQL_CONDITION_GROUP_OPERATOR groupOperator) throws Exception;
ZCNoSQLCondition.getInstance(List<ZCNoSQLCondition>,<NOSQL_CONDITION_GROUP_OPERATOR>)
new ZCNoSQLCondition(List<ZCNoSQLCondition>,<NOSQL_CONDITION_GROUP_OPERATOR>)
```

#### NOSQL_CONDITION_GROUP_OPERATOR

許可される`NOSQL_CONDITION_GROUP_OPERATOR`の値は、`AND`、`OR`です。

#### NOSQL_RETURN_VALUE 

条件の評価後の戻り値を示します。

```java
//public ZCNoSQLInsertHelper withReturnValue(NOSQL_RETURN_VALUE returnValue) throws Exception
table.getInsertHelper(<ZCNoSQLItem>).withReturnValue(<NOSQL_RETURN_VALUE>).insert();
```

許可される`NOSQL_RETURN_VALUE`の値は、`NEW`、`OLD`、`NULL`です。

#### 条件と戻り値を指定した挿入

```java
table.getInsertHelper(<ZCNoSQLItem>).withCondition(<ZCNoSQLCondition>).withReturnValue(<NOSQL_RETURN_VALUE>).insert();
```