本文档指导 ISV 为客户提供快速可靠的迁移体验。 其中包含最新的 Microsoft 迁移做法以及 ISV 提出的问题。
使用基于应用的身份验证
最终用户流量与执行后台活动(如迁移)的应用程序之间存在不同的使用模式。 标识用户流量与应用程序流量非常重要。
为了提供稳定的平台和更可靠的服务,Microsoft 要求 ISV 从使用基于用户的身份验证转换为使用基于应用的身份验证,以便为最终用户和合作伙伴提供更高的可靠性。
迁移是后台任务应用程序,不能在用户模式下运行。 通过转换到基于应用的身份验证,你将受益于非高峰时间拥有更多资源的弹性能力。
注意
Microsoft 将于 2020 年第 1 季度开始强制实施正确的使用角色。 继续以用户角色运行迁移的供应商可能会遇到越来越多的限制和较差的性能。
若要了解有关如何注册应用 ID 以及如何实现基于应用的身份验证的更多信息,请参阅:
- 如何注册应用 ID
- Microsoft Graph 身份验证指南:包括信息性视频、基础知识、如何注册应用和获取访问方案
- 不要受到限制! 保持低于限制的 SharePoint 和 OneDrive 指南
基于应用的身份验证迁移指南
权限设置
Azure Active Directory (AAD) 提供两种类型的权限:委派权限和应用程序权限。 有关 AAD 的官方指南,请参见:
对于 SharePoint 和 OneDrive 迁移方案,指导原则是遵循 AAD 权限规范。
对于依赖于最终用户登录和状态的迁移工具,建议使用委派权限。
对于在没有登录用户的情况下运行的基于服务的迁移工具(例如作为后台服务运行的应用),建议使用应用程序权限。
应用 ID 的数量
ISV 提出了一些问题,即是要有一个覆盖所有迁移产品的应用 ID,还是要根据软件产品的不同有多个应用 ID。 没有特定的指导让 ISV 可以标识他们所有的应用 ID。 有关任何极端案例的情况,请与 Microsoft 联系。
注意
请向 Microsoft 注册所有迁移应用 ID,确保迁移作业获得足够的吞吐量。
使用迁移 API
对于迁移作业,首要指导原则是使用现有的已发布迁移 API。
导入 API (CreateMigrationJob)
CreateMigrationJob 帮助 ISV 更快、更可靠地导入 SharePoint 和 OneDrive。
最新的受支持功能有:
导出 API(异步元数据读取)
ISV 可以使用新的迁移 API、异步元数据读取 API (导出 API) 。 AsynchronousMetadataRead 可通过减少的快速调用帮助 ISV 从 SharePoint 和 OneDrive 导出内容。 例如,新 API 可以在单个调用中从文档库的根级别导出所有文件和列表相关元数据。 这样可以减少所需的调用次数、受限几率并提高性能。
如需了解详细信息,请参阅 SharePoint 迁移导出(异步元数据读取)API
切换到 Microsoft Graph API
如果迁移 API 不支持某个功能,我们建议你使用 Graph API。 如果 Graph API 不支持所需的迁移功能,则使用 CSOM。 但是,使用 CSOM 会增加受限制的可能性。
CSOM 指南(仅限回退)
以下内容提供了有关特定 CSOM 实现方案的指导,以帮助提高 SharePoint 和 OneDrive 的迁移性能。
枚举查询排序指南
假设客户端打算在没有服务器端筛选的情况下读取每个项目,则有两种枚举查询。
若要以递归方式查询列表中的每个项目(换言之,顺序不取决于项目包含在哪个文件夹中),则应按 ID 排序进行查询。
<OrderBy Override="TRUE"><FieldRef name="ID"/></OrderBy>
若要查询特定文件夹中的每个项目,则应按文件名 FileLeafRef 排序进行查询。
<OrderBy Override="TRUE"><FieldRef name="FileLeafRef"/></OrderBy>
权限指南
在计划迁移到 OneDrive 或 SharePoint 时,你需要知道三个关键数字,尤其是当你具有深度嵌套的文件夹层次结构时。 它们是:(1) SharePoint 独有权限作用域的数量,(2) 角色分配的数量,以及 (3) 列表或库中的项目总数。 阅读完整指导:
对于超过 100TB 的迁移
对于迁移的数据超过 100TB 的客户,请按照有关如何创建支持工单的说明操作,来帮助产品团队为客户准备后端。
升级和限制
影响速度和出现限制的主要原因是由于调用 CSOM 和 REST API 而生成的负载。 由于此负载,系统会触发限制规则,从而影响迁移的速度、可靠性和可预测性。 限制用于保护数据库并确保为客户提供良好的用户体验。
若要阅读官方限制指南,请参阅:
我们将继续努力确定问题并改进 API。 异步元数据读取 API 便是 ISV 反馈的直接成果。 我们重视 ISV/合作伙伴的反馈。 如果你有其他问题,请联系 Microsoft。