Microsoft OneDrive
OneDrive 连接器助您在 Designer 中连接到Microsoft OneDrive 云存储。OneDrive 在“输入数据”和“输出数据”工具中可用作数据源。
升级到新的 OneDrive 连接器
如果您的工作流使用独立的 OneDrive 输入或 OneDrive 输出工具,这些工具现已弃用。请改用 2.2.0 或更高版本的连接器,并配合输入数据和输出数据工具使用。使用工作流迁移实用程序更新现有工作流。
先决条件
继续之前,请确保您已满足以下前提条件:
要求 | 详情 |
|---|---|
Designer | Designer 2026.1 或更高版本。 Designer 2025.2 补丁 3 或更高版本。 Designer 2025.1 补丁 5 或更高版本。 |
连接器版本 | Microsoft OneDrive 2.2.0 或更高版本。可从 Designer 附加组件获取。 |
Azure 权限 | |
请务必在 Designer 中启用 DCM。转至选项 > 高级设置 > DCM 以启用此功能。 | |
网络访问 | 对 OneDrive Online 和 Microsoft OAuth 端点的出站访问。 |
安装连接器
请通过“加载项”,直接从 Designer 安装最新版本的 OneDrive 连接器。这是推荐的安装方法,助您在无需离开 Designer 或访问 Alteryx Marketplace 的情况下浏览、安装和更新连接器。
如需安装连接器…
在 Designer 中,转至附加组件 > 管理 Marketplace 附加组件。您将看到可用连接器列表。
请选择 Microsoft OneDrive Connector,然后选择安装。Designer 将下载并安装该软件包。Designer 可能需要重新启动才能完成安装。
安装和设置完成后,OneDrive 连接器即可在“输入数据”和“输出数据”工具中使用。
请设置连接
如需连接到 Microsoft OneDrive…
将输入数据或输出数据工具拖到画布上,然后选择连接到数据。
在连接器设置中,选择创建或浏览数据连接。
如果您之前已创建过 Microsoft OneDrive 连接,可以从最近选项卡中选择该连接。
选择 + 新建。请从技术列表中选择 Microsoft OneDrive。
输入连接名称和数据源名称。
在凭证部分中,选择您的身份验证方法,然后输入凭证。如需了解详情,请参阅身份验证方法。
选择保存。您也可以在保存之前测试连接。
选择连接。Microsoft OneDrive 可能会请求身份验证。
在选项窗口中选择读取或写入配置。如需了解这些选项的更多信息,请参阅从 OneDrive 读取数据或将数据写入 OneDrive。
选择确认以创建与该文件的连接。您可以继续构建您的工作流。
工作流迁移
如果您的现有工作流使用了已弃用的“OneDrive 输入”或“OneDrive 输出”工具,请将其迁移以使用新版连接器。使用工作流迁移实用程序更新现有工作流。
该实用程序将预览所有更改,并在不破坏工作流正常运行的情况下,将已弃用的工具实例替换为新版连接器版本。
版本 | 描述 |
v3.1.1 |
|
v3.1.0 |
|
v2.0.0 |
|
v1.0.2 |
|
v1.0.1 |
|
v1.0.0 |
|
身份验证方法
Microsoft OneDrive 支持三种身份验证方法。请参考下表,为您的使用案例选择合适的身份验证方法。
方法 | 详情 |
|---|---|
Azure AD-Private(内置应用) |
|
Azure AD-Private(自定义应用) |
|
服务主体(应用程序) |
|
限制
Microsoft OneDrive 连接器目前具有以下限制:
Microsoft 底层的最近和与我共享 Graph API 已弃用,不返回任何数据。这是平台层面的限制,与此连接器无关。
由于此原因,无法浏览或访问最近和与我共享,且 OneDrive 路径范围仅限于我的文件。
不支持分区。
目前不支持使用通配符或者从多个文件或文件夹中读取数据,但可以通过使用宏来实现。
不支持追加输出操作。使用读取 > 联合 > 覆盖来复制追加行为。
在创建新文件时,如果目标位置已存在同名文件,则该操作不会将其覆盖。相反,系统会在新文件名中附加一个时间戳后缀,从而同时保留这两个文件。
目前不支持读取包含多个工作表的 XLSX 文件,或按名称及索引选择工作表。
自定义 Microsoft Azure API 应用程序
要为此工具设置自定义 API 应用程序,请参阅我们的指南。
注意
请确保已为包含 2.2.0 及更高版本 OneDrive 工具的工作流启用 AMP Engine。如需了解更多信息,请参阅 AMP 引擎。
Microsoft OneDrive 版本 2.3.1 及更早版本(已弃用)
独立的 Microsoft OneDrive 工具已被弃用。安装最新的 OneDrive 连接器以利用最新功能。
与 Designer 的兼容性(待讨论)
已修复的问题
连接器发行版本 xxxx.x.x.xxxxx | |
|---|---|
ID | 描述 |
v2.3.1 | Fixed Issues
|
v2.3.0 |
|
v2.2.0 |
|
v2.1.0 | Authentication occurs using user's browser instead of embedded CEF in Designer to comply with modern security policies. |
v2.0.2 | Fixed issue with tool configuration being lost in case of Provide authentication Information being enabled. |
v2.0.1 | 已修复在 Designer 2021.3.2.54175 中进行身份验证时出现白屏的问题。请注意,您还需要更新到 Designer 21.3.3.63061 或更高版本。 |


