--- title: "アイテムの更新" url: https://docs.catalyst.zoho.com/ja/sdk/java/v1/cloud-scale/nosql/update-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: "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/)テーブルのアイテムを更新できます。アイテムは[プライマリキー](https://docs.catalyst.zoho.com/ja/cloud-scale/help/nosql/components/#table-keys)を使用して識別されます。例えば、パーティションキーのみ、またはパーティションキーとソートキーの組み合わせを使用してアイテムを識別できます。その後、適切なHTTPリクエストメソッドで更新操作の種類を定義し、アイテムで更新する属性と値を指定します。 > **注意:** Catalystでは、1回のSDK操作でNoSQLテーブル内の最大25個のアイテムを一括で更新できます。 データを更新する方法は2つあります。`ZCNoSQLTable`インスタンスを使用して条件なしでデータを更新するか、リクエストの各部分を構築するために使用できる`ZCNoSQLUpdateHelper`インスタンスを使用して更新できます。 以下に示すように、`ZCNoSQLTable`インスタンスでデータを更新できます。 ```java //public ZCNoSQLResponseBean update(ZCNoSQLItem item, ZCNoSQLUpdateAttributeOperation updateAttributeOperation) throws Exception; table.update(<ZCNoSQLItem>, <ZCNoSQLUpdateAttributeOperation>); ``` ZCNoSQLUpdateHelperで更新する場合 #### ZCNoSQLUpdateHelper ```java //public ZCNoSQLInsertHelper getInsertHelper(ZCNoSQLItem item) throws Exception; //public ZCNoSQLResponseBean insert() throws Exception; table.getUpdateHelper(<ZCNoSQLItem>, <ZCNoSQLUpdateAttributeOperation>).update(); ``` #### ZCNoSQLUpdateAttributeOperation このクラスは、既存の属性を追加/更新するか、既存の属性を削除してアイテムを更新するために使用されます。上記のインスタンスは以下のメソッドを使用して取得できます。 属性の挿入または更新の場合 ```java //ZCNoSQLUpdateAttributeOperation(ZCNoSQLAttribute attribute, ZCNoSQLValue updateValue); //ZCNoSQLUpdateAttributeOperation(ZCNoSQLAttribute attribute, NoSQLUpdateAttributeFunction updateFunction); //public static ZCNoSQLUpdateAttributeOperation getPutAttributeInstance(ZCNoSQLAttribute attribute, ZCNoSQLValue updateValue); // public static ZCNoSQLUpdateAttributeOperation getPutAttributeInstance(ZCNoSQLAttribute attribute, NoSQLUpdateAttributeFunction updateFunction); new ZCNoSQLUpdateAttributeOperation(<ZCNoSQLAttribute>, <ZCNoSQLValue>); new ZCNoSQLUpdateAttributeOperation(<ZCNoSQLAttribute>, <NoSQLUpdateAttributeFunction>); ZCNoSQLUpdateAttributeOperation.getPutAttributeInstance(<ZCNoSQLAttribute>, <ZCNoSQLValue>); ZCNoSQLUpdateAttributeOperation.getPutAttributeInstance(<ZCNoSQLAttribute>, <NoSQLUpdateAttributeFunction>) ``` 属性の削除の場合 ```java //ZCNoSQLUpdateAttributeOperation(ZCNoSQLAttribute attribute); //public static ZCNoSQLUpdateAttributeOperation getDeleteAttributeInstance(ZCNoSQLAttribute attribute); new ZCNoSQLUpdateAttributeOperation(<ZCNoSQLAttribute>); ZCNoSQLUpdateAttributeOperation.getDeleteAttributeInstance(<ZCNoSQLAttribute>); ``` 更新には、値を更新するために使用できる特定のビルトイン関数もあります。これらの関数はNoSQLUpdateAttributeFunction型の下にグループ化でき、ZCNoSQLUpdateAttributeOperationインスタンスの取得時に使用できます。 ### NoSQLUpdateAttributeFunction 4つのビルトイン関数があります。 #### ZCNoSQLIfNotExistFunction この関数は、別の既存の属性の値で属性を更新するために使用されます。属性が存在しない場合、指定された値で更新されます。 ```java //public ZCNoSQLIfNotExistFunction(ZCNoSQLAttribute attribute, ZCNoSQLValue value) //public static ZCNoSQLIfNotExistFunction getInstance(ZCNoSQLAttribute attribute, ZCNoSQLValue value); new ZCNoSQLIfNotExistFunction(<ZCNoSQLAttribute>, <ZCNoSQLValue>) ZCNoSQLIfNotExistFunction.getInstance(<ZCNoSQLAttribute>, <ZCNoSQLValue>) ``` #### ZCNoSQLAppendListFunction この関数は、既存または新しいリスト属性に要素を追加するために使用されます。 ```java //public ZCNoSQLAppendListFunction(ZCNoSQLValue...values); //public static ZCNoSQLAppendListFunction getInstance(ZCNoSQLValue...values); new ZCNoSQLAppendListFunction(<List of ZCNoSQLValue>) ZCNoSQLAppendListFunction.getInstance(<List of ZCNoSQLValue>) ``` #### ZCNoSQLAdditionFunction この関数は、セットに要素を追加するか、既存の属性に数値を加算するために使用されます。操作の種類は対象の属性タイプによって異なります。 ```java //public ZCNoSQLAdditionFunction(ZCNoSQLAttribute attribute, ZCNoSQLValue value); //public static ZCNoSQLAdditionFunction getInstance(ZCNoSQLAttribute attribute, ZCNoSQLValue value); new ZCNoSQLAdditionFunction(<ZCNoSQLAttribute>, <ZCNoSQLValue>) ZCNoSQLAdditionFunction.getInstance(<ZCNoSQLAttribute>, <ZCNoSQLValue>) ``` #### ZCNoSQLReductionFunction この関数は、セットから要素を削除するか、既存の属性から数値を減算するために使用されます。操作の種類は対象の属性タイプによって異なります。 ```java //public ZCNoSQLReductionFunction(ZCNoSQLAttribute attribute, ZCNoSQLValue value) throws Exception; //public static ZCNoSQLReductionFunction getInstance(ZCNoSQLAttribute attribute, ZCNoSQLValue value) throws Exception; new ZCNoSQLReductionFunction(<ZCNoSQLAttribute>, <ZCNoSQLValue>) ZCNoSQLReductionFunction.getInstance(<ZCNoSQLAttribute>, <ZCNoSQLValue>) ``` ZCNoSQLUpdateHelperで利用可能なその他のメソッド #### ZCNoSQLCondition 上記で説明した同じ条件を更新にも再利用できます。 NOSQL_RETURN_VALUE 上記で説明した同じ戻り値を更新にも再利用できます。 条件と戻り値を指定した更新 ```java table.getUpdateHelper(<ZCNoSQLItem>,<ZCNoSQLUpdateAttributeOperation>).withCondition(<ZCNoSQLCondition>).withReturnValue(<NOSQL_RETURN_VALUE>).update(); ```