NoSQLテーブルへのアイテム挿入
Catalystでは、アイテムを構築した後、特定のNoSQLテーブルにアイテムを挿入できます。このセクションで説明するように、アイテムはさまざまな方法で挿入できます。
データの追加と操作、CatalystカスタムJSON形式、およびサポートされるデータ型に関するヘルプセクションを参照して、これらのトピックを詳しく学ぶことができます。
条件なしのアイテム挿入
CatalystカスタムJSON形式でアイテムを構築することにより、条件なしでNoSQLテーブルに新しいアイテムを挿入できます。これには、テーブルに設定されたパーティションキーとソートキー属性の値を必ず渡す必要があります。
たとえば、以下のコードスニペットでは、アイテムのパーティションキーとソートキー属性であるfruitNameとLocationの値がそれぞれ提供されています。fruitTypeやavailabilityなどのString型の他の属性は、リストfruitPropertiesとして提供されています。アイテムはinsert_items()メソッドを使用して挿入されます。
# 条件なしで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()メソッドを使用して挿入されます。
# 条件関数を使用して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の間の値を持つ場合にのみ、属性backupIDとcountがそれらのアイテムに挿入されることを示しています。アイテムはinsert_items()メソッドで挿入されます。
# 条件演算子を使用して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
Yes
No
Send your feedback to us