Transmitir Dados Unidirecionalmente de um Cliente para Atlas
Nesta página
- Configurar o Atlas Access
- Criar um App Services App Atlas
- Configurar Realm Mobile Sync e arquivo de dados
- Habilitar um provedor de autenticação
- Adicione sincronização ao aplicativo do cliente
- Conecte o cliente a um backend do App Services
- Autenticar um usuário
- Abrir um realm sincronizado
- Criar objetos assimétricos e gravar dados
Se você tiver uma aplicação móvel ou de cliente que produz um grande volume de dados que deseja transmitir para o MongoDB Atlas, poderá sincronizar os dados unidirecionalmente usando o Realm Mobile Sync. Chamamos de Ingestão de dados o recurso que permite essa sincronização unidirecional .
Talvez você queira sincronizar dados unidirecionalmente em aplicativos IoT, como um sensor meteorológico que envia dados para a nuvem. O arquivo de dados também é útil para gravar outros tipos de dados imutáveis em que você não exige a resolução de conflitos, como criar faturas a partir de uma aplicação de varejo ou registrar evento de aplicação.
O arquivo de dados é otimizado para fornecer melhorias de desempenho para volumes de trabalho pesados somente de inserção no lado do cliente. Você não pode ler esses dados do Realm para onde os está transmitindo.
Atualmente, a ingestão de dados só está disponível para os seguintes SDKs do Realm:
C++ SDK
SDK do .NET
SDK Kotlin
Node.js SDK
React Native SDK
Swift SDK
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 Realm Mobile Sync e arquivo de dados
Realm Mobile Sync é o serviço que sincroniza dados com o Atlas e entre seus dispositivos clientes. O Realm Mobile Sync, juntamente com os SDKs do Realm, managed automaticamente a conectividade de rede, as permissões de usuário e a resolução de conflitos. O App Services App fornece a autenticação de usuário integrada que o Realm Mobile Sync e o Realm SDKs aproveitam para proteger seus dados.
Ao configurar o Realm Mobile Sync, você especifica o conjunto de dados que os dispositivos cliente podem acessar, bem como as permissões que determinam quais dados um usuário pode gravar.
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.
Para habilitar o arquivo de dados para uma ou mais collection, você seleciona a collection ou as collection na seção Advanced Configuration da configuração do Realm Mobile Sync. Somente collection com um App Services Schema estão disponíveis para seleção neste menu suspenso.
Se você ainda não criou um esquema para a collection que deseja sincronizar unidirecionalmente, você pode:
Gere um esquema do App Services a partir do modelo de objetos do Realm. Consulte: Criar um esquema do App Services a partir de um modelo de objetos de Realm.
Crie manualmente um esquema Atlas App Services . Para obter mais informações, consulte: Definir e aplicar um esquema.
Habilitar um provedor de autenticação
Seus dispositivos cliente devem ser autenticados para acessar os dados sincronizados. O App Services fornece vários provedor de autenticação, como e-mail/senha ou autenticação anônima, para permitir que seus usuários se autentiquem. Configure um ou mais desses provedor de autenticação para habilitar a autenticação em sua aplicação cliente.
Você pode configurar provedores 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 provedor para configurá-lo. Você também pode configurar provedores de autenticação editando a configuração do App Services com a Interface de linha de comando do Atlas App Services ou aApp Services Admin API .
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 unidirecionalmente.
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 banco de dados Realm para usar para esse usuário. Como a Asymmetric Sync é somente gravação, você não pode definir uma query da Flexible Sync para ler dados no dispositivo. Isso difere da Flexible Sync bidirecional, onde você criaria uma assinatura de query para determinar quais dados sincronizar com o dispositivo.
Criar objetos assimétricos e gravar dados
Os SDKs do Realm fornecem um tipo especial de objeto para usar com o arquivo de dados: um objeto assimétrico. Consulte a documentação do Realm SDK para obter detalhes sobre como definir objetos assimétricos.
Crie e escreva objeto Asymmetric em um Realm sincronizado, e os SDKs do Realm usam o Realm Mobile Sync para managed o processo de transmissão dos dados automaticamente. Quando o dispositivo tem uma conexão de rede, os SDKs transmitem dados para o backend do App Services e para o Atlas. Quando o dispositivo não tem uma conexão de rede, os dados persistem no dispositivo e são carregados automaticamente quando a conexão de rede é restaurada.
O Atlas Device Sync gerencia o ciclo de vida desses dados por completo. Ele é mantido no dispositivo até que a sincronização da ingestão de dados seja concluída e, em seguida, é removido do dispositivo.