使用 Device Sync 查看 Atlas 数据
您可以使用Realm Studio通过Device Sync连接到MongoDB Atlas 。 Realm Studio用作同步客户端,类似于使用Device Sync的应用程序。 您可以:
在焦点对象模式上添加和删除订阅。
直接通过 Realm Studio 与 Atlas 数据交互。
使用Realm Studio查看您在运行开发中的应用时对数据所做的更改,或试验权限和订阅更改。
先决条件
最低 Realm Studio 版本: 14.1.2 。
由于Device Sync 通过Realm Studio Atlas App ServicesAtlas App ServicesApp 将 连接到 后端,因此您需要先执行以下操作才能开始:
启用身份验证的Atlas App Services App。 要学习;了解如何操作,请参阅App Services文档中的创建App Services App程序。
App Services App ID。 要学习;了解如何查找应用程序ID,请参阅查找您的应用程序ID。
Realm Studio 可以使用以下任何身份验证提供程序类型通过 Device Sync 进行连接:
匿名
电子邮件和密码
API 密钥
JSON web token
如果您的应用程序使用电子邮件和密码、 API密钥或 JSON web token 身份验证,则必须创建适当类型的档案,以便在从Realm Studio连接时使用。 有关创建档案的更多信息,请参阅Atlas App Services文档:
从Realm Studio连接到Atlas
指定要同步的数据
连接到Atlas后, Realm Studio会显示与您的App Services App模式匹配的对象类型列表。
Atlas App Services有关 模式的更多信息,请参阅 Atlas App Services文档中的 模式 。
Realm Studio 将这些模式映射到 Realm 对象。 有关如何使用 将这些模式映射到Realm Device Sync对象的信息,请参阅 Atlas App Services文档中的 数据模型映射 。
在为每种对象类型添加订阅之前,您看不到对象类型的任何数据。 订阅以及您为应用定义的权限决定了同步哪些数据。
要开始查看特定对象类型的数据,请添加订阅。 要更改您看到的数据,您可以:
添加更多订阅以应用额外的筛选。
删除订阅。
您无法更改已添加到Realm Studio的订阅。 要更改订阅,请将其删除并添加新订阅。
添加订阅
提供查询
使用RQL ( RQL ) 为要与Realm Studio同步的对象创建查询。 只有与您的查询匹配的对象才会出现在Realm Studio中。 在开发应用程序时,您可以使用它来快速验证查询。
您的订阅查询必须至少包含一个可查询字段。 有关可查询字段的更多信息,请参阅Atlas Atlas App Services文档中的可查询字段。
有关可用查询运算符的信息,请参阅RQL参考。
Device Sync支持在 Sync订阅查询中使用RQL操作符子集。 有关这些限制的信息,请参阅Flexible Sync RQL限制。
例子
如果使用模板应用启动Device Sync ,则模板应用使用的订阅为:
`owner_id == "${user?.id}"`
要在Realm Studio中查看适用数据,请将此查询与特定用户的ID结合使用:
owner_id == "67ee25f483c29fa14cfd7295"
要查看您提供给凭证 Realm Studio的档案具有适当权限的所有数据,请使用以下查询:
TRUEPREDICATE
删除订阅
实时查看同步的更改
添加订阅后,如果您的凭证根据应用程序的规则允许,则可以创建、更新和删除对象。 当您在使用Device Sync连接时对对象进行更改时,这些更改会自动与Atlas和其他设备同步。 您可以看到实时反映的更改。
有关如何在Realm Studio中创建、修改和删除对象的信息,请参阅修改Realm文件中的对象。 在使用Device Sync连接时,您无需执行任何操作即可保存所做的更改。 这些更改会自动与服务器同步并保留在Atlas中。
如果您尝试修改或添加与您的订阅不匹配或您没有写入权限的对象,则 Device Sync 会返回补偿写入错误。 Realm Studio 会还原这些更改,并且它们不会与 Atlas 或其他设备同步。 有关更多信息,请参阅ErrorCompensatingWrite
Flexible SyncAtlas App Services文档的 错误 部分中的 。