通过

设置 Azure Databricks Excel 加载项

重要

此功能目前以公共预览版提供。

Azure Databricks Excel 外接程序将 Azure Databricks 工作区连接到 Microsoft Excel，将治理的 Lakehouse 数据直接引入电子表格，以帮助更快地从数据移动到决策。 Windows 和 macOS 的 Excel 网页版和桌面版本完全支持该外接程序。

本页介绍可用于在 Excel Microsoft 中设置 Azure Databricks Excel 外接程序的两种方法。 此加载项使用单一登录（SSO）身份验证连接到 Azure Databricks 工作区，并支持 Unity 目录 进行数据管理和访问控制。

先决条件

在安装 Excel 外接程序之前，请验证是否具有以下各项：

  • 启用了 Unity Catalog 的 Azure Databricks 工作区的访问权限。
  • 访问正在运行的 SQL 仓库。
  • 从工作区中的 Unity 目录表读取数据的权限。
  • 你使用的是以下版本的 Excel 之一：
    • Mac 上的 Excel 2019 或更高版本
    • Windows 上的 Excel （Microsoft 365）
    • Excel 网页版
    • Mac 版 Excel （Microsoft 365）
  • 如果使用防火墙或云安全平台，请列出外接程序文件中包含的 Azure Databricks 工作区 URL。

设置加载项文件

外接程序文件是一个小连接器文件，它告知 Excel 如何安全地连接到 Azure Databricks。 它充当数字握手，可确保外接程序加载正确，并在每次打开 Excel 时保持最新状态。

必须下载并设置外接程序文件才能使用 Azure Databricks Excel 外接程序。

  1. 单击以下链接打开外接程序文件：

    Azure Databricks Excel 加载项文件

  2. 将页面保存为 .xml 文件到本地计算机。 在大多数浏览器中，右键单击页面并选择“ 另存为”，或按 Ctrl+S （Windows）或 Command+S （macOS）。

  3. 通过在中将<AppDomain>指定为AppDomains来编辑加载项文件。 工作区 URL 是用于在浏览器中访问 Azure Databricks 工作区的基本 URL。 若要在多个 Azure Databricks 工作区之间切换，请将每个工作区 URL 添加到外接程序文件。

    <AppDomains>
   <!-- DO NOT CHANGE -->
   <AppDomain>https://www.databricks.com</AppDomain>
   <AppDomain>https://login.databricks.com</AppDomain>
   <!-- ADD WORKSPACE URLS AS SHOWN BELOW; PUT EACH WORKSPACE URL IN ITS OWN <AppDomain> TAG  -->
   <!-- EXAMPLE -->
   // highlight-next-line
   <AppDomain>https://adb-<workspace1-id>.<random-number>.databricks.azure.cn</AppDomain>
   // highlight-next-line
   <AppDomain>https://adb-<workspace2-id>.<random-number>.databricks.azure.cn</AppDomain>
</AppDomains>

    注释

    将工作区 URL 粘贴为纯文本，无需设置格式。 在大多数文本编辑器中，使用 Ctrl+Shift+V （Windows） 或 Command+Shift+V （macOS）。

  4. 保存所做的更改。 验证该文件的格式是否正确为 .xml 文件。

选项 1：管理员管理

作为全局管理员，可以下载并配置 Azure Databricks Excel 外接程序并将其部署到组织中的其他用户。 下载并设置 先决条件中提供的外接程序文件。

若要将 Azure Databricks Excel 外接程序安装为 Microsoft 365 管理员，必须具有该 global admin 权限。 作为管理员，你可以确定组织中的哪些用户可以使用加载项。有关 Microsoft 365 上的全局管理员的详细信息，请参阅 Microsoft文档。

  1. 在 Microsoft 365 管理中心，转到 “设置 > 集成应用 ”并单击 “加载项 ”链接。
  2. 单击“ 部署加载项 ”，然后单击“ 下一步”。
  3. 选择“ 上传自定义应用 ”作为部署新外接程序的选项。
  4. 选择上传清单的选项。 单击 “选择文件” 并上传加载项文件。
  5. 选择哪些用户应有权访问外接程序。
  6. 单击“部署”。

有关上传 Azure Databricks Excel 外接程序的详细步骤，请参阅 Microsoft文档。

注释

作为管理员，与使用 Azure Databricks Excel 外接程序的用户共享与工作区关联的帐户名称。

选项 2：自助服务

安装步骤因 Excel 平台而异。 下载并设置 先决条件中提供的外接程序文件。

Excel 网页版

若要安装和连接到 Excel 网页版中的 Excel 外接程序，请执行以下操作：

  1. 打开 Excel 网页版并创建或打开工作簿。
  2. 在“开始”选项卡下，单击“ 加载项>高级”。
  3. 单击“上传我的外接程序”。
  4. 上传外接程序文件。
  5. 单击“上载” 。
  6. 从外接程序菜单中查找并单击 Azure Databricks 外接程序。
  7. 登录到 Azure Databricks 帐户。 如果出现错误，请确保启用弹出对话框。
  8. 如果配置了多个工作区 URL，请选择所需的 Azure Databricks 帐户名称。 仅当 URL 位于同一帐户中时，才需要选择特定的工作区。 有关帐户名称的详细信息，请参阅 查找帐户 ID。

Excel Desktop （Windows）

若要在 Excel Desktop for Windows 中安装 Excel 外接程序，请执行以下操作：

  1. 创建在本地驱动器上命名 Manifest 的文件夹（例如， C:\Manifest）。
  2. 将外接程序文件复制到 C:\Manifest 该文件夹。
  3. 打开文件夹属性并共享文件夹：
    1. 右键单击 Manifest 文件夹，然后选择“ 属性”。
    2. 单击“共享共享>”，将自己添加为具有读取和写入权限的用户。
  4. 打开 Excel Desktop。
  5. 将 Excel 配置为信任清单文件夹：
    1. 单击 “文件>选项>信任中心>信任中心设置”。
    2. 在边栏中，单击 “受信任的外接程序目录”。
    3. 在 目录 URL 中，输入外接程序文件所在的共享文件夹的路径（例如， \\YourComputerName\Manifest）。
    4. 单击“ 添加目录”。
    5. 选中 “在菜单中显示 ”复选框。
    6. 单击“确定”保存更改。
  6. 重启 Excel Desktop。
  7. 单击 “加载项>更多加载项>共享文件夹”。
  8. 选择 Azure Databricks 连接器，然后单击“ 添加”。
  9. 单击 Azure Databricks 加载项并完成 Azure Databricks 帐户的登录过程。
  10. 如果配置了多个工作区 URL，请选择所需的 Azure Databricks 帐户名称。 仅当 URL 位于同一帐户中时，才需要选择特定的工作区。 有关帐户名称的详细信息，请参阅 查找帐户 ID。

Excel Desktop （macOS）

若要在 Excel Desktop for macOS 中安装 Excel 外接程序，请执行以下操作：

  1. 查找Microsoft Office 加载项文件夹。 默认情况下，目录为：

    /Users/<your-username>/Library/Containers/com.microsoft.Excel/Data/Documents/wef

  2. 将外接程序文件复制到此文件夹。

  3. 打开或重启 Excel Desktop。

  4. 在导航栏中，单击加载项>我的加载项。

  5. 单击 “Azure Databricks” 附加组件。

  6. 完成 Azure Databricks 帐户的登录过程。

  7. 如果配置了多个工作区 URL，请选择所需的 Azure Databricks 帐户名称。 仅当 URL 位于同一帐户中时，才需要选择特定的工作区。 有关帐户名称的详细信息，请参阅 查找帐户 ID。

更改 Azure Databricks 工作区

如果外接程序文件指定了多个 Azure Databricks 工作区，则可以在这些工作区之间切换。 有关详细信息，请参阅 设置外接程序文件。

若要连接到其他 Azure Databricks 工作区，请执行以下操作：

  1. 在 Azure Databricks 外接程序窗格的右上角，单击计算选择器旁边的三点菜单。
  2. 单击“ 更改工作区”。
  3. 选择工作区位于的帐户、工作区（如果出现提示）并登录。

排查“正在进行身份验证”的问题

如果在尝试从外接程序登录到 Azure Databricks 时看到“正在进行身份验证”窗口，则工作区可能尚未正确添加到自定义外接程序文件中。 请验证是否在<AppDomains>下正确配置了工作区。

后续步骤

  • Last updated on