Consultar Atlas de aplicativos clientes
Nesta página
Você pode fazer query de dados em clusters do MongoDB Atlas vinculados a partir de aplicativos cliente usando a sintaxe padrão da linguagem de query do MongoDB (MQL) com o MongoDB Data Access nos SDKs do Realm.
O MongoDB Data Access protege os dados aplicando as permissões de acesso baseadas em roles, filtros de query e esquemas de documentos do seu aplicativo. Esses recursos permitem que você construa queries complexas do lado do cliente com o MQL enquanto seus dados permanecem seguros no servidor.
Quando usar o acesso a dados MongoDB
Talvez você queira usar o MongoDB Data Access em seu aplicativo se:
Você deseja usar uma API como os drivers MongoDB
Você deseja escrever queries de banco de dados no código do cliente em vez de em um servidor
Você deseja construir queries ad-hoc a partir do dispositivo cliente.
Você pode querer utilizar o MongoDB Data Access em vez do Atlas Device Sync em um aplicativo nestes cenários:
Você está consultando documentos que não são ou não podem ser modelados no Realm Database.
Você deseja acessar coleções que não estão sincronizadas.
Você não deseja persistir os dados localmente.
Você está usando o Realm SDK da Web, que não oferece suporte ao Realm Database ou Device Sync.
Como alternativa ao MongoDB Data Access em cenários do lado do cliente , você pode usar a Atlas Data API.
Você também pode usar essas APIs sem um Realm SDK para a linguagem de programação do seu aplicativo cliente, desde que a linguagem tenha um cliente HTTPS. No entanto, essas APIs não apresentam a mesma sintaxe MQL segura por tipo que o MongoDB Data Access dos SDKs do Realm.
Como alternativa ao MongoDB Data Access em cenários do lado do servidor , você pode usar o seguinte:
Driver do MongoDB. Usar um driver MongoDB para conectar-se ao Atlas é a abordagem do lado do servidor geralmente recomendada, pois os drivers têm mais desempenho e flexibilidade do que a conexão por meio do App Services. Se desejar aplicar as Regras do App Services às operações do driver, você poderá usar o Protocolo de conexão do App Services.
Atlas Data API
configurar
Para usar o MongoDB Data Access de um Realm SDK, você deve executar a seguinte configuração.
Criar um App Services App
Crie um App Services App com uma fonte de dados vinculada do MongoDB .
Para saber mais sobre a criação de aplicativos, consulte Criar um aplicativo e Vincular uma fonte de dados.
Adicionar um fornecedor de autenticação
Adicione pelo menos um fornecedor de autenticação ao aplicativo. Todas as queries do MongoDB Data Access são executadas no contexto de um usuário autenticado. Para saber mais sobre como ativar a autenticação do usuário, consulte Fornecedores de autenticação.
Adicionar regras a uma coleção
Para proteger suas queries no lado do cliente, você deve adicionar as Regras do Atlas App Services a qualquer collection que você usar com o MongoDB Data Access. Para saber como adicionar regras às coleções, consulte Definir funções e permissões.
Se você não adicionar regras a uma collection, todas as solicitações do cliente para ela falharão.
Adicionar um esquema e filtros à coleção (opcional)
Além das regras, você também pode adicionar um esquema e filtros às coleção que você consulta com o MongoDB Data Access.
Os esquemas definem o modelo de dados do seu aplicativo e validam documentos em relação a ele. Use filtros para garantir que os clientes gravem somente dados correspondentes ao esquema no banco de dados.
Os filtros modificam as query do MongoDB antes de serem enviadas ao banco de dados para que as query retornem apenas um subconjunto de resultados. Por exemplo, você pode definir um filtro que modifica a query para que um usuário possa acessar somente os dados que ele gravou.
Embora esquemas e filtros não sejam necessários para usar o MongoDB Data Access, você deve adicioná-los à maioria dos casos de uso de produção.