O Activepieces é um sistema de automação de IA tudo-em-um projetado para ser extensível através de um seguro para o tipo estrutura de peças escrita em TypeScript. Com o novo conector do Couchbase, os fluxos de trabalho do Activepieces agora podem operar em dados armazenados em clusters do Couchbase, incluindo clusters hospedados no Couchbase Capella.
Nesta postagem do blog, analisaremos as etapas necessárias para configurar uma instância do Activepieces para se conectar a um cluster do Couchbase e consultá-lo para obter dados usando o SQL++.
Ações do Couchbase
A integração com o Couchbase fornece aos usuários do Activepieces um conjunto de ações que permitem manipular dados em um cluster:
- Inserir documento
- Inserir documento
- Obter documento
- Excluir documento
- Executar consulta SQL++
Todas as ações podem ser configuradas na interface de usuário do Activepieces Process Builder e são fornecidas com documentação integrada sobre todos os parâmetros de ação necessários e opcionais. Todas as ações suportam valores estáticos e dinâmicos como seus argumentos.
Execução de consulta SQL++ a partir do Activepieces
Você pode usar a instância de teste pública gratuita fornecida pela Activepieces clicando no link “Try it” (Experimente) na página de documentação do Couchbase (https://www.activepieces.com/pieces/couchbase):
Para executar uma consulta SQL++, primeiro crie um fluxo Activepieces e abra-o para edição no Builder:
Clique no sinal de mais entre o acionador do fluxo e o final, procure a ação “Execute SQL++ Query” (Executar consulta SQL++) do Couchbase e adicione-a ao fluxo:
Configuração da conexão com o Couchbase
A primeira coisa a ser configurada nessa ação é a conexão do Couchbase que queremos usar nela:
Se tivéssemos configurado anteriormente as conexões do Couchbase, poderíamos selecioná-las aqui. Como esse não é o caso, a única opção é criar uma nova conexão e fornecer ao Activepieces as credenciais para um cluster do Couchbase (por exemplo, para um cluster Capella de nível gratuito):
Configuração da ação de consulta do SQL++
Depois de clicar em “Save” (Salvar), podemos usar o menu suspenso Bucket select (Seleção de bucket) para escolher um bucket do cluster. Vamos selecionar o bucket de amostra de viagem:
A seleção do compartimento ativa o menu suspenso Seletor de escopo. Vamos selecionar o escopo do inventário:
Depois de selecionar o escopo em que queremos realizar a consulta, podemos inserir a consulta propriamente dita. Para fins de demonstração, vamos fazer uma seleção simples de um único aeroporto da coleção de aeroportos:
Observe que a ação também é compatível com consultas com argumentos posicionais que podem ser adicionados no campo de entrada de texto da consulta. A ação é compatível com valores de argumentos estáticos e dinâmicos, sendo que os valores dinâmicos são avaliados antes de a consulta ser enviada ao cluster.
A ação também fornece entradas convenientes para a realização de pesquisa vetorial e operações de ordenação, que não são exigidas pela nossa consulta simples, mas podem ser úteis em cargas de trabalho de IA:
Os recursos de pesquisa de vetores também estão bem documentados na interface de configuração.
Depois de configurar todos os parâmetros da ação, podemos testá-la clicando no botão “Test Step” (Etapa de teste) na seção Generate Sample Data (Gerar dados de amostra):
Se tudo correr bem, clicar nesse botão resultará em um teste bem-sucedido e você verá os dados JSON que a ação buscou no cluster:
Documentação e suporte
A integração do Couchbase é um projeto desenvolvido pela comunidade que é lançado como parte do Activepieces e hospedado no repositório do Activepieces no GitHub: https://github.com/activepieces/activepieces
Forneça seus comentários, sugestões ou perguntas sobre a integração por meio da página de problemas do Activepieces no GitHub.
