--- title: "アイテムの挿入" url: https://docs.catalyst.zoho.com/ja/sdk/python/v1/cloud-scale/nosql/insert-items/ description: "Catalyst NoSQLは、非リレーショナル・非SQLのデータストレージ手段を提供する、完全マネージドで強力なデータベースです。このページでは、NoSQLテーブルにさまざまな方法でアイテムを挿入するSDKメソッドについて説明します。" last_updated: 2026-03-30T08:10:30Z 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アイテムを一括挿入できます。 ### 条件なしのアイテム挿入 CatalystカスタムJSON形式でアイテムを構築することにより、条件なしでNoSQLテーブルに新しいアイテムを挿入できます。これには、テーブルに設定された[パーティションキーとソートキー](https://docs.catalyst.zoho.com/ja/cloud-scale/help/nosql/components/#table-keys)属性の値を必ず渡す必要があります。 たとえば、以下のコードスニペットでは、アイテムのパーティションキーとソートキー属性であるfruitNameとLocationの値がそれぞれ提供されています。`fruitType`や`availability`などのString型の他の属性は、リスト`fruitProperties`として提供されています。アイテムは`insert_items()`メソッドを使用して挿入されます。 ```python # 条件なしでNoSQLアイテムを挿入する item = { "fruitName": { "S": "Banana" }, "Location": { "S": "Indonesia" }, "fruitProperties": { "L": [ { "fruitType": "Berries" }, { "availability": "abundant" } } ] } } # 定義された条件に基づいてアイテムを挿入し、レスポンスで返されるアイテムを設定する。その他のサポートされている値は"OLD"と"NULL"です res = table.insert_items({ 'item': item, 'return': 'NEW' }) ``` ### 条件関数を使用したアイテム挿入 CatalystカスタムJSON形式で定義した特定の条件を使用して、NoSQLテーブルの既存アイテムに属性を挿入できます。このタイプでは、テーブルの既存データが取得され、指定された条件に対して評価されます。評価がtrueの場合にのみアイテムが挿入されます。既存データがない場合、条件は無視されアイテムが挿入されます。 Catalystは条件を評価するための複数の演算子をサポートしています。サポートされる演算子は以下のように表されます。
Operators Notation
CONTAINS `contains`
NOT_CONTAINS `not_contains`
BEGINS_WITH `begins_with`
ENDS_WITH `ends_with`
IN `in`
NOT_IN `not_in`
BETWEEN `between`
NOT_BETWEEN `not_between`
EQUALS `equals`
NOT_EQUALS `not_equals`
GREATER_THAN `greater_than`
LESS_THAN `less_than`
GREATER_THAN_OR_EQUALS `greater_equal`
LESSER_THAN_OR_EQUALS `less_equal`
AND `AND`
OR `OR`
以下の例では、既存データのネストされた属性`fruitColour`が値「Yellow」を含むという条件を定義しています。この属性は属性`fruitProperties`の一部です。条件が満たされた場合、属性`fruitType`と`availability`がアイテムに追加されます。アイテムは`insert_items()`メソッドを使用して挿入されます。 ```python # 条件関数を使用してNoSQLアイテムを挿入する condition_function = { "function": { "function_name": "attribute_type", "args": [ { "attribute_path": ["fruitProperties", "[0]"] }, { "fruitColour": "Yellow" } ] } } item = { "Location": { "S": "Indonesia" }, "fruitName": { "S": "Banana" }, "fruitProperties": { "L": [ { "fruitType": "Berries" }, { "availability": "abundant" } } ] } } # 定義された条件に基づいてアイテムを挿入し、レスポンスの戻り値を設定する。その他のサポートされている値は"OLD"と"NULL"です res = table.insert_items({ 'item': item, 'condition': condition_function, 'return': 'NEW' }) ``` ### 条件演算子を使用したアイテム挿入 Catalystでは、CatalystカスタムJSON形式で演算子で定義された条件に基づいてアイテムを挿入することもできます。テーブルの既存データが取得され、指定された条件に対して評価されます。評価がtrueの場合にのみアイテムが挿入されます。既存データがない場合、条件は無視されアイテムが挿入されます。 Catalystは条件を評価するための複数の演算子をサポートしています。これらは[前のセクション](https://docs.catalyst.zoho.com/ja/sdk/python/v1/cloud-scale/nosql/insert-items/#insert-items-with-conditional-functions)に記載されています。 以下の例では、`between`演算子で定義された条件に基づいてアイテムを挿入しています。条件では、既存データの属性`count`が0から10の間の値を持つ場合にのみ、属性`backupID`と`count`がそれらのアイテムに挿入されることを示しています。アイテムは`insert_items()`メソッドで挿入されます。 ```python # 条件演算子を使用してNoSQLアイテムを挿入する condition_function = { "attribute": ["count"], "operator": "between", "value": { "L": [ { "N": "0" }, { "N": "10" } ] } } item = { "countryCode": { "N": 054 }, "backupID": { "N": 2379992 }, "count": { "N": "3" } } # 定義された条件に基づいてアイテムを挿入し、レスポンスの戻り値を設定する。その他のサポートされている値は"OLD"と"NULL"です res = table.insert_items({ 'item': item, 'condition': condition_function, 'return': 'NEW' }) ```