--- title: "Insertar items" url: https://docs.catalyst.zoho.com/es/sdk/python/v1/cloud-scale/nosql/insert-items/ description: "Catalyst NoSQL es una base de datos potente y completamente administrada que te proporciona un medio de almacenamiento de datos no relacional y no SQL. Esta página describe los métodos del SDK para insertar items en una tabla NoSQL de varias maneras." last_updated: 2026-03-30T08:10:30Z service: Cloud Scale type: general related_links: - name: "NoSQL" url: /es/cloud-scale/help/nosql/introduction - name: "Working with Data" url: /es/cloud-scale/help/nosql/working-with-data/introduction/ - name: "NoSQL API" url: /es/api/code-reference/cloud-scale/nosql/insert-item/#InsertNewItem --- # Insertar items en tablas NoSQL Catalyst te permite insertar items en una tabla [NoSQL](https://docs.catalyst.zoho.com/es/cloud-scale/help/nosql/introduction/) 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](https://docs.catalyst.zoho.com/es/cloud-scale/help/nosql/working-with-data/introduction/#the-catalyst-custom-json-format), y los [tipos de datos soportados](https://docs.catalyst.zoho.com/es/cloud-scale/help/nosql/working-with-data/introduction/#supported-data-types) 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](https://docs.catalyst.zoho.com/es/cloud-scale/help/nosql/components/#table-keys) 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()`. ```python # 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()`. ```python # 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](https://docs.catalyst.zoho.com/es/sdk/python/v1/cloud-scale/nosql/insert-items/#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()`. ```python # 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' }) ```