Insertar items en tablas NoSQL
Catalyst te permite insertar items en una tabla NoSQL específica después de construirlos. Los items se pueden insertar de diferentes maneras como se describe en esta sección. Puedes consultar las secciones de ayuda sobre agregar y trabajar con datos, el formato JSON personalizado de Catalyst, y los tipos de datos soportados para conocer estos temas en detalle.
Note: Catalyst te permite insertar un máximo de 25 items de forma masiva en una tabla NoSQL con una sola operación del SDK.
### Insertar items sin condiciones Puedes insertar nuevos items en una tabla NoSQL sin ninguna condición construyendo los items en el formato JSON personalizado de Catalyst. Esto requerirá que pases obligatoriamente los valores para los atributos de partition key y sort key configurados para la tabla. Por ejemplo, en el fragmento de código a continuación, se proporcionan los valores para los atributos de partition key y sort key del item, fruitName y Location respectivamente. Otros atributos del tipo de dato string como fruitType y availability se proporcionan como una lista fruitProperties. El item se inserta luego usando el método insert_items().
copy
# Insertar un ítem NoSQL sin condiciones
item = {
"fruitName": {
"S": "Banana"
},
"Location": {
"S": "Indonesia"
},
"fruitProperties": {
"L": [
{
"fruitType": "Berries"
},
{
"availability": "abundant"
}
}
]
}
} # Insertar el elemento basado en la condición definida y establecer el elemento a devolver en la respuesta. Otros valores soportados son "OLD" y "NULL"
res = table.insert_items({
'item': item,
'return': 'NEW'
})### Insertar items con funciones condicionales Puedes insertar atributos en items existentes en una tabla NoSQL usando condiciones específicas que defines en el formato JSON personalizado de Catalyst. En este tipo, los datos existentes de la tabla se recuperan y evalúan contra la condición especificada. Los items se insertan solo si la evaluación es verdadera. Si no hay datos existentes, las condiciones se ignoran y los items se insertan. Catalyst soporta múltiples operadores para evaluar condiciones. Los operadores soportados se representan como se muestra a continuación.
| 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 |
El ejemplo a continuación ilustra esto definiendo una condición para el atributo anidado fruitColour en los datos existentes que contenga el valor "Yellow". Este atributo es parte del atributo fruitProperties. Si la condición se satisface, los atributos fruitType y availability se agregan a los items. El item se inserta luego usando el método insert_items().
copy
# Insertar un elemento NoSQL con una función condicional
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"
}
}
]
}
}
# Insertar el elemento basado en la condición definida y establecer el valor de retorno en la respuesta. Otros valores soportados son "OLD" y "NULL"
res = table.insert_items({
'item': item,
'condition': condition_function,
'return': 'NEW'
})### Insertar items con operadores condicionales Catalyst también te permite insertar items basándose en condiciones definidas con operadores en el formato JSON personalizado de Catalyst. Los datos existentes de la tabla se recuperan y evalúan contra la condición especificada. Los items se insertan solo si la evaluación es verdadera. Si no hay datos existentes, las condiciones se ignoran y los items se insertan. Catalyst soporta múltiples operadores para evaluar condiciones, como se enumeran en la [sección anterior](#insert-items-with-conditional-functions). El ejemplo a continuación ilustra la inserción de un item basándose en condiciones definidas con el operador between. La condición establece que solo cuando el atributo count tiene valores entre 0 y 10 en los datos existentes, los atributos backupID y count se deben insertar en esos items. El item se inserta con el método insert_items().
copy
# Insertar un elemento NoSQL con un operador condicional
condition_function = {
"attribute": ["count"],
"operator": "between",
"value": {
"L": [
{
"N": "0"
},
{
"N": "10"
}
]
}
}
item = {
"countryCode": {
"N": 054
},
"backupID": {
"N": 2379992
},
"count": {
"N": "3"
}
}
# Insertar el elemento basado en la condición definida y establecer el valor de retorno en la respuesta. Otros valores soportados son "OLD" y "NULL"
res = table.insert_items({
'item': item,
'condition': condition_function,
'return': 'NEW'
})Última actualización 2026-03-30 13:40:30 +0530 IST
Yes
No
Thank you for your feedback!
Send your feedback to us
Skip
Submit