Visualizar Dados Atlas com Sincronização de Dispositivo
Nesta página
Você pode usar o Realm Studio para se conectar ao MongoDB Atlas usando o Device Sync. O Realm Studio funciona como um cliente de sincronização, semelhante a um aplicativo que usa o Device Sync. Você pode:
Adicione e remova assinaturas no esquema de objeto focado.
Interaja com dados do Atlas diretamente do Realm Studio.
Use o Realm Studio para ver as alterações nos dados que você faz ao executar um aplicativo em desenvolvimento ou experimente permissões e alterações de assinatura.
Pré-requisitos
Versão mínima do Realm Studio: 14.1.2.
Como o Device Sync conecta o Realm Studio ao backend do Atlas App Services por meio de um Atlas App Services , você precisa seguir antes de começar:
Um aplicativo Atlas App Services com autenticação ativada. Para saber como, consulte Criar um aplicativo do App Services na documentação do App Services.
A ID do aplicativo do App Services. Para saber como encontrar o ID do aplicativo, consulte Encontrar o ID do seu aplicativo.
O Realm Studio pode se conectar via Device Sync usando qualquer um destes tipos de fornecedor de autenticação:
Anônimo
E-mail e senha
Chave API
JSON web token
Se o seu aplicativo usar autenticação de e-mail e senha, chave de API ou JSON web token, você deverá criar uma credencial do tipo apropriado para usar quando se conectar a partir do Realm Studio. Para mais informações sobre como criar credenciais, consulte a documentação do Atlas App Services :
Conecte-se ao Atlas a partir do Realm Studio
Conecte
Clique em Connect.
Depois de se conectar com sucesso, o Realm Studio mostra a ID do aplicativo na barra de menus da janela do aplicativo. Você pode abrir conexões para vários Atlas App Services simultaneamente. Você também pode abrir várias conexões para o mesmo App Services App se quiser visualizar as alterações em tempo real.
Especifique os dados para sincronizar
Após se conectar ao Atlas, o Realm Studio exibe uma lista de tipos de objeto que correspondem aos esquemas do seu aplicativo do App Services.
Para obter mais informações sobre esquemas do Atlas App Services , consulte Esquemas na documentação do Atlas App Services .
O Realm Studio mapeia esses esquemas para objetos do Realm. Para obter informações sobre como esses esquemas são mapeados para objetos do Realm usando o Device Sync, consulte Mapeamento de modelo de dados na documentação do Atlas App Services .
Você não pode ver nenhum dado para os tipos de objeto até adicionar assinaturas para cada tipo de objeto. As assinaturas, além das permissões que você definiu para seu aplicativo, determinam quais dados são sincronizados.
Para começar a visualizar dados de um tipo de objeto específico, adicione uma assinatura. Para alterar os dados que você vê, você pode:
Adicione mais assinaturas para aplicar filtragem adicional.
Remova uma assinatura.
Você não pode alterar uma assinatura adicionada ao Realm Studio. Para alterar a assinatura, remova-a e adicione uma nova assinatura.
Adicionar uma assinatura
Fornecer uma query
Use o Realm Query Language (RQL) para criar uma query para os objetos que você deseja sincronizar com o Realm Studio. Somente os objetos que corresponderem à sua query aparecerão no Realm Studio. Você pode usar isso como uma forma de validar rapidamente as queries ao desenvolver seu aplicativo.
A query de sua assinatura deve incluir pelo menos um campo de query. Para obter mais informações sobre campos consultáveis, consulte Campos consultáveis na documentação do Atlas App Services .
Para obter informações sobre operadores de query disponíveis, consulte o referência.
O Device Sync oferece suporte ao uso de um subconjunto de operadores RQL em queries de assinatura do Sync. Para obter informações sobre essas limitações, consulte Limitações da RQL do Flexible Sync.
Exemplo
Se você inicializar o Device Sync com um aplicativo de modelo, a assinatura que os aplicativos de modelo usam é:
`owner_id == "${user?.id}"`
Para visualizar os dados aplicáveis no Realm Studio, use esta query com um ID de usuário específico:
owner_id == "67ee25f483c29fa14cfd7295"
Para visualizar todos os dados onde as credenciais que você forneceu ao Realm Studio têm as permissões apropriadas, use a query:
TRUEPREDICATE
Adicionar a assinatura
Clique em Add subscription para concluir o processo de adição de uma assinatura. Isso aciona uma sincronização inicial com o Device Sync para:
Itens do tipo de objeto selecionado.
Que correspondem à query de assinatura que você fornece.
Onde as credenciais que você usou para fazer login no Realm Studio têm permissões para visualizar o item.
Depois de um momento, você vê o número de objetos mudar de 0 para refletir o número de objetos que atendem a esse critério.
Adicione assinaturas a mais objetos conforme necessário
Seu aplicativo do App Services pode ter esquemas para vários tipos de objetos. Você deve adicionar assinaturas individualmente para cada tipo de objeto que deseja visualizar no Realm Studio.
Se seus objetos incluírem links para outros objetos, como em relacionamentos para-um ou para-muitos, os objetos vinculados não aparecerão no Realm Studio até que você tenha adicionado a assinatura apropriada nos tipos de objetos vinculados.
Remover uma assinatura
Visualizar alterações sincronizadas em tempo real
Depois de adicionar uma assinatura, se suas credenciais permitirem com base nas regras do seu aplicativo, você poderá criar, atualizar e excluir objetos. Quando você faz alterações em objetos enquanto está conectado ao Device Sync, essas alterações são sincronizadas automaticamente com o Atlas e com outros dispositivos. Você pode ver suas alterações refletidas em tempo real.
Para obter informações sobre como criar, modificar e excluir objetos no Realm Studio, consulte Modificar objetos em um arquivo do Realm. Você não precisa fazer nada para salvar as alterações feitas enquanto estiver conectado ao Device Sync. Essas alterações são sincronizadas automaticamente com o servidor e persistem no Atlas.
Se você tentar modificar ou adicionar um objeto que não corresponda às suas assinaturas ou onde você não tenha permissões de escrita, o Device Sync reage com um erro de escrita compensatório. O Realm Studio reverte essas alterações e elas não são sincronizadas com o Atlas ou outros dispositivos. Para obter mais informações, consulte ErrorCompensatingWrite na seção Erros deFlexible Sync da documentação do Atlas App Services .