Microsoft OneDrive

OneDrive 连接器助您在 Designer 中连接到Microsoft OneDrive 云存储。OneDrive 在“输入数据”和“输出数据”工具中可用作数据源。

升级到新的 OneDrive 连接器

如果您的工作流使用独立的 OneDrive 输入或 OneDrive 输出工具，这些工具现已弃用。请改用 2.2.0 或更高版本的连接器，并配合输入数据和输出数据工具使用。使用工作流迁移实用程序更新现有工作流。

开始之前

从 Alteryx Marketplace 下载并安装 Microsoft OneDrive。

先决条件

继续之前，请确保您已满足以下前提条件：

要求	详情
Designer	Designer 2026.1 或更高版本。 Designer 2025.2 补丁 3 或更高版本。 Designer 2025.1 补丁 5 或更高版本。
连接器版本	Microsoft OneDrive 2.2.0 或更高版本。可从 Designer 附加组件获取。
Azure 权限	请参阅设置 Microsoft Azure API 应用程序。
DCM	请务必在 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 输出”工具，请将其迁移以使用新版连接器。使用工作流迁移实用程序更新现有工作流。

该实用程序将预览所有更改，并在不破坏工作流正常运行的情况下，将已弃用的工具实例替换为新版连接器版本。

身份验证方法

Microsoft OneDrive 支持三种身份验证方法。请参考下表，为您的使用案例选择合适的身份验证方法。

方法	详情
Azure AD-Private（内置应用）	选择此项，助您使用自己的 Microsoft 凭证设置个人临时连接。电子邮件和密码将与您的个人 Microsoft 凭证绑定。此项可用于 SDK。不建议用于计划工作流。 DCM 为可选。
Azure AD-Private（自定义应用）	当您的团队共享自定义注册的 Azure 应用时，请使用此项。此项可用于 SDK。有关设置的说明，请参阅 Microsoft Azure API 应用设置。 DCM 为可选。
服务主体（应用程序）	选择此项，助您计划或自动化工作流，而无需将身份验证绑定至特定用户。利用具有服务主体的自定义 API 应用功能。有关设置的说明，请参阅 Microsoft Azure API 应用设置。必须启用 DCM。

限制

Microsoft OneDrive 连接器目前具有以下限制：

Microsoft 底层的最近和与我共享 Graph API 已弃用，不返回任何数据。这是平台层面的限制，与此连接器无关。
由于此原因，无法浏览或访问最近和与我共享，且 OneDrive 路径范围仅限于我的文件。
不支持分区。
目前不支持使用通配符或者从多个文件或文件夹中读取数据，但可以通过使用宏来实现。
不支持追加输出操作。使用读取 > 联合 > 覆盖来复制追加行为。
在创建新文件时，如果目标位置已存在同名文件，则该操作不会将其覆盖。相反，系统会在新文件名中附加一个时间戳后缀，从而同时保留这两个文件。
目前不支持读取包含多个工作表的 XLSX 文件，或按名称及索引选择工作表。

发行说明

版本	描述
v3.1.1	改进了授权 URL 字段，其中包含预填充的默认值和内联帮助文本，从而减少了查阅外部文档的需求。已修复在 OneDrive 输入连接器中选择不受支持的文件格式时，会显示无关配置选项的问题。已修复在使用内置应用身份验证类型时，DCM 中的测试连接失败的问题。改进了 OneDrive 输入与输出操作的错误处理。
v3.1.0	与 Designer 2021.4.2 补丁 4、2022.1 补丁 2 及更高版本兼容。支持使用 Microsoft 的安全 OAuth 2.0 登录来连接到 OneDrive。使用服务主体进行身份验证，以实现自动化、无人值守的工作流。只需通过 DCM 存储一次登录凭证，即可在 Designer 和 Server 上的多个工作流中重复使用。支持在 Server 上运行带有自动令牌刷新的无人值守作业，无需手动重新进行身份验证。快速筛选至个人文件、与我共享或最近文件。可通过浏览、手动输入路径或直接粘贴共享的 OneDrive 链接来选择文件。粘贴 URL 后，连接器会自动识别并加载文件的详细信息。可按名称或编号选择特定的工作表、定义自定义单元格区域，或者仅提取工作表名称列表。在导入数据的同时引入文件名、路径、大小、上次修改日期和文件类型等详细信息。仅检索文件/文件夹结构，无需下载完整的文件内容。直接从 OneDrive 读取 .csv、.xlsx 和 .yxdb 文件。
v2.3.0	与 Designer 2021.4.2 补丁 4、2022.1 补丁 2 及更高版本兼容。仅与 AMP Engine 兼容。在 Alteryx Server 中运行此连接器需要 DCM。已优化身份验证选项窗口。当您在本地下载 XLSX 文件时，OneDrive 输入的输出现在包含工作表名称。您可以在您工作流的其他工具中使用这些工作表名称。修复了 OneDrive 输出在设置为覆盖 XLSX 文件中特定工作表时也会修改其他工作表的问题。修复了 OneDrive 工具的身份验证无法正常进行的问题。(TPM-3833) 修复了 OneDrive 输入无法正确读取某些数据类型的问题。（TPM-3751、TPM-3722、TPM-3721）修复了如果数据包含固定精度十进制或 Null 值，OneDrive 输出写入错误文件的问题。(TPM-3720) 修复了 OneDrive 输出错误转换 CSV 文件中 Null 值的问题。(TPM-3719) 修复了服务主体身份验证在 OneDrive 输出中不起作用的问题。(TPM-3580) 修复了以下问题：尽管用户设置为排除“选择工作表”选项的字段，但 OneDrive 输出仍将该字段包含在输出中。(TPM-3393) 修复了 OneDrive 输出无法正确追加数据的问题。(TPM-2564) 修复了 OneDrive 输出的“中止”选项并不适用于所有数据类型的问题。(TPM-2563) 修复了 OneDrive 工具的编码问题。(TPM-1984) 修复了 OneDrive 输出更改标题格式的问题。(TPM-1375) 修复了 OneDrive 输出的“追加”选项覆盖文档的格式和公式的问题。(TPM-1179) 修复了 OneDrive 输入无法读取包含日期时间数据的 YXDB 文件的问题。(TPM-1100) 修复了当工作流包含字节和 Int16 数据类型的数据时 OneDrive 输出失败的问题。(TPM-209)
v2.2.0	与 Designer 2021.4.2 补丁 4、2022.1 补丁 2 及更高版本兼容。仅与 AMP Engine 兼容。增加了对 DCM 的支持。在 Alteryx Server 中运行此连接器需要 DCM。支持 FIPS。增加了只覆盖一张工作表的选项。更改了将工作表名字段从写入数据中排除的行为。增加了保留工作表名字段的选项。现在会针对 Windows 证书存储执行 SSL/TLS 验证。
v2.1.0	使用用户的浏览器而不是 Designer 中的嵌入式 CEF 进行身份验证，以符合现代安全策略。
v2.0.2	修复了以下问题：在启用“提供身份验证信息”时工具配置丢失。
v2.0.1	已修复在 Designer 2021.3.2.54175 中进行身份验证时出现白屏的问题。请注意，您还需要更新到 Designer 21.3.3.63061 或更高版本。
v2.0.0	具有使用自定义 Azure 应用程序的选项的内置多租户 Azure 应用程序（包括单租户应用程序或服务主体）。支持读取和写入 XLSX、CSV 和 YXDB 文件格式。支持代理。与 Designer 2021.2.2 及更高版本兼容。需要 OneDrive 365。
v1.0.2	更新“代码页”选项。区分具有相同语言的编码（例如“语言”->“语言（特定代码）”）并按字母顺序排列编码。允许用户通过输出工具指定 CSV 文件的编码。提升了数据转换处理能力，当字段缺少值时，不抛出警告，而不是报错。修复了偶尔不遵从默认值设置的问题。已禁用生产环境日志记录，以避免因 Designer 的不同安装/配置而引发权限问题，并支持计划工作流功能。
v1.0.1	修复了无法成功安装软件包的问题。
v1.0.0	OneDrive 输入和 OneDrive 输出的初始版本。

自定义 Microsoft Azure API 应用程序

要为此工具设置自定义 API 应用程序，请参阅我们的指南。

注意

请确保已为包含 2.2.0 及更高版本 OneDrive 工具的工作流启用 AMP Engine。如需了解更多信息，请参阅 AMP 引擎。Alteryx AMP Engine

用于连接的 Alteryx 工具


OneDrive 输入工具	OneDrive 输出工具

本节内容如下: