Conectar a fontes de dados MongoDB

Ler, escrever e agregar dados

Você pode ler e gravar dados em uma fonte de dados a partir de uma função do lado do servidor ou conectar-se a partir de um aplicativo cliente. Você escreve queries usando a sintaxe de query padrão do MongoDB.

exports = async function() {
   const mongodb = context.services.get("mongodb-atlas");
   return mongodb
      .db("myDatabase")
      .collection("myCollection")
      .findOne()
}

Para aprender como trabalhar com uma fonte de dados em uma Função do Atlas, consulte os seguintes guias:

• Ler dados do MongoDB Atlas

• Escrever Dados no Atlas MongoDB

• Dados agregados no MongoDB Atlas

Para saber como usar uma fonte de dados de um Realm SDK, veja o Query no Atlas a partir de aplicativos de clientes.

Proteja e valide dados

As fontes de dados permitem definir regras de acesso e esquemas de documento para os dados que elas contêm. As regras autorizam dinamicamente os usuários a ler e escrever subconjuntos de seus dados, e os esquemas controlam a forma e o conteúdo de cada documento.

Por padrão, as operações de leitura e gravação em uma fonte de dados vinculada são seguras. Um usuário não pode ler ou gravar nenhum dado, a menos que uma regra o permita explicitamente. Quaisquer dados inseridos ou modificados por um usuário autorizado devem estar em conformidade com o esquema correspondente.

Se você não definir regras para uma collection, as consultas na collection falharão. Isso significa que você pode expor com segurança uma interface de fonte de dados configurada corretamente em aplicativos cliente sem correr o risco de corrupção ou vazamento de dados.

Sincronize dados automaticamente

Os aplicativos Atlas Device Sync armazenam dados e sincronizam alterações de dados em um cluster vinculado, chamado de aglomerado sincronizado. O protocolo de sincronização garante que seus dados sejam eventualmente consistentes com todos os clientes de sincronização e com o cluster sincronizado.

Para mais informações sobre o Atlas Device Sync e como ele interage com as fontes de dados do seu aplicativo, consulte Atlas Device Sync.

Reaja às alterações de dados

Você pode criar gatilhos de banco de dados (trigger) que executam funções automaticamente em resposta à alteração de dados. Os gatilhos usam change streams do MongoDB para observar a fonte de dados e executar uma função sempre que um evento de alteração corresponder à configuração do gatilho. Uma função de gatilho pode executar código arbitrário e pode acessar um evento de alteração para obter informações detalhadas sobre a alteração que causou sua execução.

Para saber mais sobre como os gatilhos funcionam e como definir os seus próprios, consulte Gatilhos de banco de dados.

Federação de Dados Atlas

Você pode vincular uma instância do banco de dados federado ao seu aplicativo como uma fonte de dados do MongoDB. No entanto, existem algumas advertências ao usar o Atlas Data Federation:

• Fontes de dados federadas não suportam operações de gravação.

• Você só pode acessar uma fonte de dados federada a partir de uma função do sistema.

• Você não pode se conectar a uma fonte de dados federada por meio do protocolo de cabo.

• Não é possível definir roles e permissões para uma fonte de dados federada.

• Não é possível definir uma read preference para uma fonte de dados federada.

• Não é possível criar um gatilho de banco de dados em uma fonte de dados federada.

• Não é possível usar uma fonte de dados federada como cluster do Device Sync do seu aplicativo.

Instâncias sem servidor

Você pode vincular uma instância sem servidor ao seu aplicativo como uma fonte de dados do MongoDB. No entanto, as instâncias sem servidor não aceitam change streams no momento, portanto, as seguintes funcionalidades são limitadas:

• Não é possível criar um gatilho de banco de dados em uma instância sem servidor.

• Você não pode usar uma instância sem servidor como cluster do Device Sync do seu aplicativo.

• Você não pode observar collections para alterações em fontes de dados que são instâncias sem servidor do MongoDB Atlas.