Como começar a usar o Neurelo e o MongoDB
Anaiya Raisinghani, Guru Kamat7 min read • Published Aug 30, 2024 • Updated Aug 30, 2024
Avaliar este tutorial
Pronto para começar a trabalhar com menos código, menos complexidades de banco de dados e integração de plataforma mais fácil? Então este tutorial sobre como navegar pela interseção entre o Neurelo e o MongoDB Atlas é para você.
A Nurelo é uma plataforma que utiliza AI, APIs e o poder da nuvem para ajudar os desenvolvedores a interagir e manipular melhor seus dados armazenados no MongoDB, PostgreSQL ou MySQL. Essa abordagem direta à programação de dados permite que os desenvolvedores trabalhem com os dados a partir de seus aplicativos, melhorando a escalabilidade e a eficiência, ao mesmo tempo em que garante total transparente. O tutorial abaixo mostrará aos leitores como configurar corretamente uma conta Neurelo, como conectá-la à sua conta MongoDB Atlas , como usar o API Playground de Neurelo para manipular uma coleção e como criar queries complexas usando o recurso de assistência por AI de Nurelo.
Vamos começar!
Nossa primeira etapa é garantir que tenhamos um cluster MongoDB Atlas pronto — se necessário, saiba mais sobre como criar um cluster. Verifique se você tem um nome de usuário e senha memoráveis e se tem as permissões de rede adequadas em vigor. Para facilitar as coisas, você pode usar
0.0.0.0 como o endereço IP, mas observe que ele não é recomendado para produção ou se você tiver informações confidenciais em seu cluster.Após configurar o cluster, carregue os dados de amostra MongoDB. Isso é importante porque usaremos o banco de dados
sample_restaurants e a collectionrestaurants. Depois que o cluster estiver configurado, criaremos nossa conta Nurelo, se ainda não estiver criada.Acesse o painel do Neurelo e siga as instruções para criar uma conta. Quando terminar, você verá esta tela inicial.
Inicialize um novo projeto clicando no botão laranja "New" no meio da tela. Preencha cada seção do pop-up.
O nome do
Organization é preenchido automaticamente para você, mas escolha um nome exclusivo para o seu projeto, selecione o Database Engine a ser usado (estamos usando o MongoDB), selecione o idioma necessário para o seu projeto (isso é opcional, pois não estamos usando uma linguagem para este tutorial) e, em seguida, preencha uma descrição para que você ou os membros da equipe saibam o que está ocorrendo (também é uma etapa opcional).
Depois de clicar no botão laranja “Create”, você verá as três opções na captura de tela abaixo. É recomendável que novos usuários do Neurelo cliquem na opção “Quick Start”. As outras duas opções estão lá para você explorar quando não for mais novato.
Clique em "Connect Data Source." Go ao seu cluster do MongoDB Atlas e copie a connection string para o seu cluster. Ao inserir sua connection string com Nurelo, você precisará especificar o banco de dados que deseja usar no final da string. Não há necessidade de especificar qual coleção.
Como estamos usando nosso banco de dados
sample_restaurants para este exemplo, queremos garantir que ele seja incluído na connection string. Deve ser algo assim:1 mongodb+srv://mongodb:<password>@cluster0.xh8qopq.mongodb.net/sample_restaurants
Quando terminar, clique em "Test Connection. " Se não conseguir se conectar, entre nas permissões de rede do MongoDB Atlas e copie os dois endereços IP na tela
New Data Source, pois pode ser um erro de rede. Quando “Test Connection” for bem-sucedido, pressione “Submit.”Agora, clique no botão laranja "New Environment". No Neurelo, os ambientes são usados para que os desenvolvedores possam executar suas APIs (geradas automaticamente e usando consultas personalizadas) em seus dados. Por favor, preencha os campos.
Depois que seu ambiente for criado com sucesso, ele ficará verde e você poderá continuar criando seu token de acesso. Clique no botão laranja “New Access Token. Esses tokens concedem aos usuários permissão para acessar as APIs de um ambiente específico.
Guarde sua chave em um lugar seguro — se você a perder, precisará gerar uma nova.
E Parabéns! Você criou com sucesso um projeto no Neurelo.
Agora podemos jogar com os documentos em nossa collection MongoDB e realmente filtrá-los usando o Playground.
Na área do API Playground "Headers ", inclua sua chave de token no cabeçalho
X-API-KEY . Isso faz com que você esteja conectado corretamente ao ambiente correto.
Agora você pode usar o playground da API do Neurelo para acessar os documentos localizados em seu MongoDB database.
Digamos que queremos devolver vários documentos da nossa categoria de restaurante. Queremos devolver os restaurantes localizados no bairro do Brooklyn, em Nova York, e queremos os restaurantes que servem culinária americana.
Para utilizar a API do Nurelo para nos encontrar cinco restaurantes, podemos clicar na aba “GET Find many restaurants] em nossa coleção “restaurants " na barra lateral, clicar no cabeçalho
Parameters e preencher nossos parâmetros como tal:1 select: {"id": true, "borough": true, "cuisine": true, "name": true}
1 filter: {"AND": [{"borough": {"equals": "Brooklyn"}, "cuisine": {"equals": "American"}}]}
1 take: 5
Sua resposta deve ser semelhante a esta:
1 { 2 "data": [ 3 { 4 "id": "5eb3d668b31de5d588f4292a", 5 "borough": "Brooklyn", 6 "cuisine": "American", 7 "name": "Riviera Caterer" 8 }, 9 { 10 "id": "5eb3d668b31de5d588f42931", 11 "borough": "Brooklyn", 12 "cuisine": "American", 13 "name": "Regina Caterers" 14 }, 15 { 16 "id": "5eb3d668b31de5d588f42934", 17 "borough": "Brooklyn", 18 "cuisine": "American", 19 "name": "C & C Catering Service" 20 }, 21 { 22 "id": "5eb3d668b31de5d588f4293c", 23 "borough": "Brooklyn", 24 "cuisine": "American", 25 "name": "The Movable Feast" 26 }, 27 { 28 "id": "5eb3d668b31de5d588f42949", 29 "borough": "Brooklyn", 30 "cuisine": "American", 31 "name": "Mejlander & Mulgannon" 32 } 33 ] 34 }
Como você pode ver em nossa saída, os
select mapas de feições para nosso operador MongoDB $project . Estamos escolhendo quais campos do nosso documento mostrar em nossa saída. O filter recurso imita nosso $match operador e o take recurso imita nosso $limit operador . Este é apenas um exemplo simples, mas as oportunidades são realmente intermináveis. Depois de se familiarizar com essas APIs, você poderá usá-las para criar seus aplicativos com o MongoDB.O Neurelo realmente permite que os desenvolvedores configurem de forma fácil e rápida as chamadas de API para que possam acessar e interagir com seus dados.
Se tivermos um caso de uso em que os endpoints gerados automaticamente do Neurelo não nos dão os resultados desejados, podemos criar consultas complexas com muita facilidade no Neurelo. Podemos criar nossos próprios endpoints personalizados para queries mais complexas necessárias para filtrar os resultados que desejamos. Essas queries podem ser de agregação, de localização ou qualquer consulta que o MongoDB suporte, dependendo do caso de uso. Vamos ver um exemplo juntos.
Acesse a página do Neurelo “Home” e clique no projeto “Test” que criamos anteriormente. Em seguida, clique em "Definitions " no lado esquerdo da tela e clique em "Custom Queries. ".
Clique no botão laranja “New” no meio da tela para adicionar um novo endpoint de consulta personalizado e, quando a tela aparecer, crie um nome exclusivo para sua consulta. O meu é apenas "complexQuery. "
Com o Neurelo, você pode usar o recurso AI Assist para ajudar a encontrar a consulta que está procurando. Construído sobre os LLMs, o AI Assista para queries complexas pode ajudá-lo a criar o código de que você precisa.
Clique no botão multicolorido "AI Assist" no canto superior direito para abrir a guia AI Assist.
Digite um prompt. O nosso é: "Please give me all restaurants that are in Brooklyn and are American cuisine. "
Você também pode atualizar o prompt para incluir as projeções a serem retornadas. Alterar o prompt para "get me all restaurants that are in Brooklyn and serve the American cuisine and show me the name of the restaurant " criará algo como:
Como você pode ver, o AI Assista apresenta uma consulta complexa válida que podemos desenvolver. Isso é incrivelmente útil, especialmente se não estivermos familiarizados com a sintaxe ou se simplesmente não quisermos percorrer a documentação.
Edite a consulta personalizada para melhor ajuda com seu caso de uso.
Clique no botão "Use This " para importar a consulta para sua caixa de consulta personalizada. Usando o mesmo exemplo de antes, queremos garantir que possamos ver o nome do restaurante, o bairro e a culinária. Esta é a versão atualizada desta query:
1 { 2 "find": "restaurants", 3 "filter": { 4 "borough": "Brooklyn", 5 "cuisine": "American" 6 }, 7 "projection": { 8 "_id": 0, 9 "name": 1, 10 "borough": 1, 11 "cuisine": 1 12 } 13 }
Clique no botão laranja “Test Query”, insira seu token de acesso, clique no botão de aprovação do ambiente e clique em executar!
Sua saída ficará assim:
1 { 2 "data": { 3 "cursor": { 4 "firstBatch": [ 5 { 6 "borough": "Brooklyn", 7 "cuisine": "American", 8 "name": "Regina Caterers" 9 }, 10 { 11 "borough": "Brooklyn", 12 "cuisine": "American", 13 "name": "The Movable Feast" 14 }, 15 { 16 "borough": "Brooklyn", 17 "cuisine": "American", 18 "name": "Reben Luncheonette" 19 }, 20 { 21 "borough": "Brooklyn", 22 "cuisine": "American", 23 "name": "Cody'S Ale House Grill" 24 }, 25 { 26 "borough": "Brooklyn", 27 "cuisine": "American", 28 "name": "Narrows Coffee Shop" 29 }, 30 …
Como pode ver, você criou com sucesso uma query complexa que mostra o nome do restaurante, o bairro e a comida. Agora você pode confirmar e distribuir isso como um endpoint personalizado em seu ambiente Neurelo e chamar essa API a partir de seus aplicativos. ótimo trabalho!
Este tutorial orientou você com sucesso sobre como criar uma conta do Nurelo, conectar seu banco de dados do MongoDB Atlas ao Nurelo, explorar o API Playground do Nurelo e até mesmo criar queries complexas usando a função de Assistente de AI . Agora que você está familiarizado com os fundamentos, pode sempre levar as coisas um passo além e incorporar os aprendizados acima em um novo aplicativo.
Para obter ajuda, o Neurelo tem muita documentação,vídeosde introduçãoe informações sobre suas APIs.
Principais comentários nos fóruns
Ainda não há comentários sobre este artigo.
Avaliar este tutorial