Activepieces es un sistema de automatización con IA todo en uno diseñado para ser ampliable a través de un seguro en cuanto a tipos marco de piezas escrito en TypeScript. Con el nuevo conector de Couchbase, los flujos de trabajo de Activepieces ahora pueden operar con datos almacenados en clústeres de Couchbase, incluidos los clústeres alojados en Couchbase Capella.
En esta entrada del blog, repasaremos los pasos necesarios para configurar una instancia de Activepieces con el fin de conectarse a un clúster de Couchbase y consultar sus datos mediante SQL++.
Acciones de Couchbase
La integración con Couchbase ofrece a los usuarios de Activepieces un conjunto de acciones que les permiten manipular datos en un clúster:
- Insertar documento
- Insertar y actualizar documento
- Obtener documento
- Eliminar documento
- Ejecutar consulta SQL++
Todas las acciones se pueden configurar en la interfaz de usuario de Activepieces Process Builder y cuentan con documentación integrada sobre todos los parámetros de acción obligatorios y opcionales. Todas las acciones admiten tanto valores estáticos como dinámicos como argumentos.
Ejecución de una consulta SQL++ desde Activepieces
Puedes utilizar la instancia de prueba pública gratuita que ofrece Activepieces haciendo clic en el enlace “Probarlo” de la página de documentación de la pieza de Couchbase (https://www.activepieces.com/pieces/couchbase):
Para ejecutar una consulta SQL++, primero crea un flujo de Activepieces y ábrelo para editarlo en el Builder:
Haz clic en el signo más situado entre el desencadenador del flujo y el final, busca la acción “Ejecutar consulta SQL++” de Couchbase y añádela al flujo:
Configuración de la conexión a Couchbase
Lo primero que hay que configurar en esta acción es la conexión a Couchbase que queremos utilizar en ella:
Si hubiéramos configurado previamente conexiones a Couchbase, podríamos haberlas seleccionado aquí. Como no es así, la única opción es crear una nueva conexión y proporcionar a Activepieces las credenciales de un clúster de Couchbase (por ejemplo, un clúster Capella del plan gratuito):
Configuración de la acción de consulta SQL++
Después de hacer clic en “Guardar”, podemos utilizar el menú desplegable «Selección de bucket» para elegir un bucket del clúster. Seleccionemos el bucket «travel-sample»:
Al seleccionar el grupo, se activa el menú desplegable del selector de ámbito. Seleccionemos el ámbito de inventario:
Una vez seleccionado el ámbito en el que queremos realizar la consulta, ya podemos introducir la consulta propiamente dicha. A modo de ejemplo, realicemos una consulta sencilla para seleccionar un solo aeropuerto de la colección de aeropuertos:
Ten en cuenta que la acción también admite consultas con argumentos posicionales que se pueden añadir debajo del campo de entrada de texto de la consulta. La acción admite tanto valores de argumentos estáticos como dinámicos; los valores dinámicos se evalúan antes de que la consulta se envíe al clúster.
La acción también proporciona entradas prácticas para realizar operaciones de búsqueda y ordenación de vectores, que no son necesarias para nuestra consulta simple, pero que pueden resultar útiles en cargas de trabajo de IA:
Las funciones de búsqueda vectorial también están bien documentadas en la interfaz de usuario de configuración.
Una vez configurados todos los parámetros de la acción, podemos probarla haciendo clic en el botón “Probar paso”, situado en la sección «Generar datos de muestra»:
Si todo sale bien, al hacer clic en ese botón la prueba debería completarse con éxito y deberías ver los datos JSON que la acción ha obtenido del clúster:
Documentación y asistencia
La integración de Couchbase es un proyecto desarrollado por la comunidad que se publica como parte de Activepieces y se aloja en el repositorio de GitHub de Activepieces: https://github.com/activepieces/activepieces
Por favor, envía tus comentarios, sugerencias o preguntas sobre la integración a través de la página de incidencias de Activepieces en GitHub.
