Sincronizar Dados no Atlas com uma Aplicação de Cliente
Nesta página
- Configurar o Atlas Access
- Criar um App Services App Atlas
- Configurar Device Sync
- Habilitar um provedor de autenticação
- Gerar modelos de objeto do cliente
- Adicione sincronização ao aplicativo do cliente
- Conecte o cliente a um backend do App Services
- Autenticar um usuário
- Abrir um realm sincronizado
- Usar o Realm sincronizado
Se sua organização já tiver dados no MongoDB Atlas, você poderá sincronizar esses dados com dispositivos clientes usando o Device Sync e o banco de dados Realm. Siga estas etapas de alto nível para começar:
Configurar o Atlas Access
Criar um App Services App Atlas
O aplicativo App Services é o gateway que permite que seu dispositivo cliente se conecte ao MongoDB Atlas. Ao criar um aplicativo, você o nomeia, o vincula a um cluster do Atlas e especifica o modelo de implantação e a região de implantação que funcionam melhor para seu aplicativo.
Para saber como criar um App Services App, consulte Criar um Aplicativo.
Configurar Device Sync
Realm Mobile Sync é o serviço que managed a sincronização dos seus dados do Atlas com seus dispositivos cliente. O Device Sync, juntamente com os Realm SDKs, gerencia automaticamente a conectividade de rede, a resolução de conflitos, a autenticação do usuário e as permissões do usuário e acesso aos dados.
Ao configurar o Device Sync, você especifica a fonte de dados que os dispositivos cliente podem acessar, bem como as permissões que determinam quais dados um usuário pode ler e escrever.
Você pode configurar o Device Sync por meio da IU do Atlas, da interface da linha de comando do Atlas App Services ou da App Services Admin API. Na primeira vez que você configurar o Device Sync, é recomendável usar a IU do Atlas, pois ela fornece links e informações sobre diversas configurações e opções.
Habilitar um provedor de autenticação
Seus usuários clientes devem se autenticar para acessar os dados sincronizados. O App Services fornece vários provedores de autenticação para permitir a autenticação dos seus usuários. Configure um ou mais desses provedores de autenticação para habilitar a autenticação em seu aplicativo cliente.
Você pode configurar fornecedores de autenticação na interface do usuário do App Services App selecionando Authentication no menu de navegação esquerdo e, em seguida, clique em um fornecedor para configurá-lo. Você também pode configurar provedores de autenticação editando a configuração do App Services com a Interface da linha de comando do Atlas App Services ou a App Services Admin API.
Gerar modelos de objeto do cliente
Quando você já tem dados no Atlas, pode gerar modelos de objetos que correspondem a esses dados para utilizar em seu aplicativo cliente.
Para gerar um modelo de objeto, você deve ter um esquema do App Services. Depois de ter um esquema, você pode gerar modelos de objetos que correspondam a esse esquema. Você pode selecionar uma linguagem de programação para gerar o esquema, que pode ser exibido e copiado para uso no código do aplicativo cliente.
Você pode gerar um esquema a partir de dados existentes do Atlas usando a interface do usuário do App Services. Para obter mais informações sobre como fazer isso, consulte: Criar um esquema de objetos do Realm a partir de um esquema do App Services.
Depois de ter um esquema, você pode gerar um modelo de objeto do Realm usando a interface do usuário do App Services ou a interface da linha de comando do Atlas App Services.
Adicione sincronização ao aplicativo do cliente
Depois disso, você tem tudo configurado de que precisa no lado do Atlas e pode preparar seu aplicativo cliente para sincronizar dados. O Realm Mobile Sync sincroniza dados com o Atlas usando um SDK de reconhecimento de data center Realm. Você pode usar o Realm SDK no código da aplicação cliente para se conectar ao Atlas e sincronizar dados com um reconhecimento de data center do Realm no dispositivo.
Conecte o cliente a um backend do App Services
No código do aplicativo do cliente, inicialize um cliente de aplicativo para conectar o cliente ao backend do App Services. Isso permite que seu cliente use os recursos do App Services, como autenticação, e possibilita a abertura de um Realm sincronizado.
Abrir um realm sincronizado
Depois de ter um usuário autenticado, você pode abrir uma instância sincronizada do Realm Database para usar com esse usuário.
Você define uma assinatura de query do Flexible Sync no código do cliente para determinar quais dados devem ser sincronizados com o aplicativo cliente. O Device Sync procura documentos do Atlas que correspondam à query, que o usuário tem permissão para ler e possivelmente gravar, e sincroniza esses documentos com o dispositivo cliente como objetos de Realm. Você pode adicionar, remover ou atualizar assinaturas de query do Flexible Sync para alterar os documentos que são sincronizados com o dispositivo.
C++ SDK
SDK do Flutter
SDK para Java
SDK Kotlin
SDK do .NET
Node.js SDK
React Native SDK
Swift SDK
Usar o Realm sincronizado
A sintaxe para ler, gravar e monitorar alterações em um Realm sincronizado é idêntica à sintaxe para Realms não sincronizados. Enquanto você trabalha com dados locais, um thread em segundo plano integra, carrega e baixa conjuntos de alterações de forma eficiente. Quando um usuário com permissões de gravação faz alterações no dispositivo, os dados persistem localmente. Quando o usuário tem uma conexão de rede, os dados são sincronizados automaticamente com o Atlas e outros dispositivos.
Para obter um guia rápido sobre como realizar tarefas comuns com o reconhecimento de data center do Realm, consulte os inícios rápidos do Realm SDK.
Se você preferir pesquisar um aplicativo cliente funcional para aprender, alguns SDKs fornecem um aplicativo Realm Mobile Sync funcional, que chamamos de aplicativos modelo. Opcionalmente, você pode Go por tutoriais específicos do SDK que se baseiam no aplicativo modelo do Realm Mobile Sync.
C++ SDK
SDK do Flutter
SDK para Java
SDK Kotlin
SDK do .NET
Node.js SDK
React Native SDK
Swift SDK