お知らせ:

当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。

NoSQLテーブルへのアイテム挿入

Catalystでは、アイテムを構築した後、特定のNoSQLテーブルにアイテムを挿入できます。このセクションで説明するように、アイテムはさまざまな方法で挿入できます。

データの追加と操作、CatalystカスタムJSON形式、およびサポートされるデータ型に関するヘルプセクションを参照して、これらのトピックを詳しく学ぶことができます。

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

条件なしのアイテム挿入

CatalystカスタムJSON形式でアイテムを構築することにより、条件なしでNoSQLテーブルに新しいアイテムを挿入できます。これには、テーブルに設定されたパーティションキーとソートキー属性の値を必ず渡す必要があります。

たとえば、以下のコードスニペットでは、アイテムのパーティションキーとソートキー属性であるfruitNameとLocationの値がそれぞれ提供されています。fruitTypeavailabilityなどのString型の他の属性は、リストfruitPropertiesとして提供されています。アイテムはinsert_items()メソッドを使用して挿入されます。

copy
# 条件なしで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の一部です。条件が満たされた場合、属性fruitTypeavailabilityがアイテムに追加されます。アイテムはinsert_items()メソッドを使用して挿入されます。

copy
# 条件関数を使用して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は条件を評価するための複数の演算子をサポートしています。これらは前のセクションに記載されています。

以下の例では、between演算子で定義された条件に基づいてアイテムを挿入しています。条件では、既存データの属性countが0から10の間の値を持つ場合にのみ、属性backupIDcountがそれらのアイテムに挿入されることを示しています。アイテムはinsert_items()メソッドで挿入されます。

copy
# 条件演算子を使用して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' 
})

最終更新日 2026-03-30 13:40:30 +0530 IST