# Database ## 📘 Documentación de la acción "Database" en Dapta ### ¿Qué es el nodo Database? #### El nodo Database te permite guardar o consultar información dentro de una base de datos directamente desde un flujo en Dapta. Es ideal si quieres que tu flujo pueda recordar datos (como nombres de clientes, productos, compras, etc.) o consultar información ya existente antes de tomar decisiones. {% embed url="" %} ### 🧱 ¿Qué es una base de datos y qué es una tabla? 1. #### Base de datos #### Una base de datos es como un archivador digital donde guardas información organizada. Por ejemplo, podrías tener una base de datos llamada mi\_negocio donde guardas información sobre tus clientes, productos, y pedidos. 2. #### Tabla #### Una tabla es como una hoja de cálculo dentro de esa base de datos. Cada tabla almacena un tipo específico de información. Por ejemplo: * #### La tabla clientes almacena datos de personas que te han comprado. * #### La tabla productos almacena lo que vendes. * #### La tabla pedidos guarda el historial de compras.
#### Cada fila de la tabla representa un registro (por ejemplo, un cliente específico), y cada columna representa una propiedad (como el nombre, número de documento, o fecha de compra). **Ejemplo visual de una tabla clientes:**
![](https://lh7-rt.googleusercontent.com/docsz/AD_4nXeNtI5PrKKuMemEJrayUjKdAl3vdumoPw4mZDQeexrLViL2a9uzFDXfO5fO73uklQ-lRxTPt0WtO2EJ_ef0Yqh5_SHUj2uOYDsKb7UGJ9ZoS8UXmv_74l3k9LzuwF_DZJExcHRJCQ?key=q9qCYjJ8nosf-MaxftK0Jg)
### 🛠️ ¿Para qué sirve el nodo Database en Dapta? #### El nodo Database te permite: * #### 🔍 Leer: buscar si existe una persona, producto, o dato específico. * #### 📝 Crear: guardar nuevos registros, como un nuevo cliente. * #### 🔄 Actualizar: modificar un dato que ya existe, como cambiar un nombre. * #### ❌ Eliminar: borrar un registro de la base de datos. #### ### 🧩 Cómo se configura #### 1. Crear una base de datos y tablas #### Desde el Home de Dapta: * #### Entra a la sección de “Data Studio”. ![](https://lh7-rt.googleusercontent.com/docsz/AD_4nXdvox0j6vBaYx_9Bd0EKns9fwN_6TxpF6sCnSxe6mF0pJZ608WfEhnzGx9o9RkFPCLVWvEOzrw3bqOz20Sn4WN7_TM86ZlCV77FDgyNDfXe_QjPs5N6buk2jXiOIaYg9NwBlxFNlg?key=q9qCYjJ8nosf-MaxftK0Jg) * #### Crea una nueva base de datos (por ejemplo: tienda\_surtida). ![](https://lh7-rt.googleusercontent.com/docsz/AD_4nXed0nlz074T6NLDAKPAdXJSvIraASZSMbk4SGV0RK1ADyYAVnl3HtBqd8dFVG4vtPzPHV6hU_HuXQWom_-6--QpPuE2oVMN7oage3bGTDiBa2tkg6bFiuX9W9g4hohgiAHusfNV?key=q9qCYjJ8nosf-MaxftK0Jg)
* #### Dentro de esta base, puedes crear diferentes tablas que corresponde a asignarle: * * #### Clientes * #### ![](https://lh7-rt.googleusercontent.com/docsz/AD_4nXctl1XjnGvGpmzabOzcGcV7DWDbyXkbU2fcu8ZllzzK-bRuiQiAIzGILjCVuHrbjEHCtkFMR6Go8mb0Ff13RRM-fXh_DrgQJmDgaEew4DFavRDqLZCwilb6V0Y07zi-UtMCkMtuOA?key=q9qCYjJ8nosf-MaxftK0Jg)
#### En cada tabla defines las propiedades necesarias. Por ejemplo, para clientes puedes tener: #### created\_at (se crea por defecto) #### id (se crea por defecto) #### client\_id #### Nombre \
* #### ![](https://lh7-rt.googleusercontent.com/docsz/AD_4nXdapEkX8WqYye2bEO4kJOQu9KRgcShi_1kjy9EuvHEYkzwKsOY3a1oZ_n2qqWM2tksNrcMOarUTQ9pcJmpRRUINYQNpxmsnb0SUU8grezSZvi78M1CwQccTSrM4GGluLm30RVtDLg?key=q9qCYjJ8nosf-MaxftK0Jg) #### #### 2. Uso del nodo Database en Flow Studio #### Dentro de un flujo, añade el nodo "Database" y configúralo: **🧾 Se crea una carpeta en automático en conjunto con la tabla anterior con 4 acciones clave:** * #### Crear * #### Leer * #### Actualizar * #### Eliminar ![](https://lh7-rt.googleusercontent.com/docsz/AD_4nXekIO_TChwEy0w-8uL3seLFRjWExpbejobwTKnvummMXAN3aZT893I8iRijN3b_oNXawk3rTwB6_9rZ6Qeq6nxSlN_V1_vfr1fn_R0Eev5n48Q4uag3nXz5ukvFZcQSS702wkQM?key=q9qCYjJ8nosf-MaxftK0Jg) #### ### 🧩 Cómo se usa en un flujo * Crear un flujo nuevo\ ![](https://lh7-rt.googleusercontent.com/docsz/AD_4nXfldM1OdQV22bwuRdkW3PK-tqKM5QC5_aVUgo9m2vpKoNS8anGSei7OtzpiECdtwDJa_T479W6_kKIJscZj5fbFeTUuCQ6SPw_QsuXA4Xc5zovtNYg5IrMFNUpkGydAZIDMrlayYg?key=q9qCYjJ8nosf-MaxftK0Jg) * #### Debes usar el nodo de Database ![](https://lh7-rt.googleusercontent.com/docsz/AD_4nXfdYDKwrROWJjF_KN4H1OW-XjALxA7NAVSd7166Y0X3SlZevYieOA_1kn2EUdW6yGCf_yWxIZFkMuC8MTwGXVf8ng113axe5w0p3GvK09bqSw7mNguCglOspWDkn5UZJ8qBcp88lQ?key=q9qCYjJ8nosf-MaxftK0Jg)
#### ### ✅ Ejemplo completo: Validar y registrar un cliente #### Paso 1: Verificar si el cliente ya existe * #### Se usa el nodo Database con acción Leer. * #### Se filtra por client\_id para ver si ya está en la tabla clientes. #### ![](https://lh7-rt.googleusercontent.com/docsz/AD_4nXdUlFakeduZAmaeEHToR8yemMN-TKq47LK2-q5DlOKmIEWXcV0P1LaZUU0aq2jqlGyUl80ikiSuaeEUpHed3RPuIOBaI9sP6kU8mDrdj_4AocsVRhLtr2ySxiFBu1XwWZP_F5NdnQ?key=q9qCYjJ8nosf-MaxftK0Jg) ![](https://lh7-rt.googleusercontent.com/docsz/AD_4nXecLMlPXHtRMxRixsrlHy_BcbDP_mEJ5lc3pwdwRkN4O6grvcZ9POYk0cjMI77WUUG9dst5G5wjR6WUHmEECsM4BFAOz7hG-FcWd7bMI_YpBzX6iiOMi1VaS1PPlx8LyDMsRyFJ?key=q9qCYjJ8nosf-MaxftK0Jg) ####
#### Paso 2: Usar un nodo condicional * #### Si la consulta devuelve 0 resultados, el cliente no existe. * #### Si devuelve 1 o más resultados, el cliente ya existe. ![](https://lh7-rt.googleusercontent.com/docsz/AD_4nXduVI0YkoVp62RzOZ8qwfHDvM8KSltwytIi6y9Y83NrZUIv-WWRyV26zpLBuC0qoAY4hHs7kG3eWc-B-eLAYbjWWAJxn39JY-ebwifxutbsG1vUDCwOmiTGlxRM1obUfV5TzBHV?key=q9qCYjJ8nosf-MaxftK0Jg) #### Paso 3: Crear cliente si no existe * #### Se usa otro nodo Database, ahora con acción Crear. * #### Se guardan datos como client\_id y nombre. ![](https://lh7-rt.googleusercontent.com/docsz/AD_4nXfdpJ-r_U5w-H_xWzxtFYAsEUfYEcBAtNxXDh5qatfIj53wrtmUowricW6O-b2LHZG9Op6-jpI1hjWmzxfRxrpj7aGhKM0aseuuz3FYDBBDut7u1CrEyOfmqlqzMBVgnugogQLqfQ?key=q9qCYjJ8nosf-MaxftK0Jg) ![](https://lh7-rt.googleusercontent.com/docsz/AD_4nXdhInsR-nvzXnVS2mg1zK32Adoxawzrla3ZK-332-vutMzE5rEwy0sEbeaQjr3QzUhbS5Dp4LLVq1QzVy_yISoFVIBO8d0yxqTTdM1ZjDfOhtvgBdOVqOOGMJE9GepHHVzkCdqX?key=q9qCYjJ8nosf-MaxftK0Jg) #### Paso 4: Response Se usa un nodo Response para confirmar si se encontró el cliente o si fue creado. #### ![](https://lh7-rt.googleusercontent.com/docsz/AD_4nXcDlroAWPLpPCst6hvKo1uabJqcqfH3TxR8Iju5Yu-wifuC8RVgVSjsSpWirgMa0lonHa9bak0Tuwo3czmpMuAtbs2YaJ3Y49slQBjTrHVEqxqruhqrjs4Gy-7Jf2X7Pz4j-FXrAQ?key=q9qCYjJ8nosf-MaxftK0Jg) ![](https://lh7-rt.googleusercontent.com/docsz/AD_4nXerlzD0wcOn62Qsb2cEWNCm92Y4QHqwoJsoRHe-9RMyaBUR-hJHSqoJ0JfmtqdfaUW_jQ2Ef2V9DQ15qeLihyuZgBWe3e4tHd0ikBtCCkutA0cKJRSu-izD5SnIMd4J08XK-Yrt3Q?key=q9qCYjJ8nosf-MaxftK0Jg) #### ### 🧠 Recomendaciones * #### No necesitas ser programador para usar esto. Piensa en las tablas como hojas de cálculo organizadas. * #### Siempre valida si ya existe el dato antes de crear uno nuevo (esto evita duplicados). * #### El campo client\_id debe ser único para que no haya confusión.
--- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.dapta.ai/dapta-docs-es/actions/database.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.