排查 Azure 数据工厂 UX 问题Troubleshoot Azure Data Factory UX Issues

适用于: Azure 数据工厂 Azure Synapse Analytics

本文探讨了排查 Azure 数据工厂 UX 问题的常见方法。This article explores common troubleshooting methods for Azure Data Factory UX.

ADF UX 未加载ADF UX not loading

备注

Azure 数据工厂 UX 官方支持 Microsoft Edge 和 Google Chrome。The Azure Data Factory UX officially supports Microsoft Edge and Google Chrome. 使用其他 Web 浏览器可能会导致意外行为或未记录的行为。Using other web browsers may lead to unexpected or undocumented behavior.

已阻止第三方 CookieThird-party cookies blocked

ADF UX 使用浏览器 Cookie 来保留用户会话并启用交互式开发和监视体验。ADF UX uses browser cookies to persist user session and enable interactive development and monitoring experiences. 你的浏览器可能会阻止第三方 Cookie,因为你正在使用匿名会话或启用了广告阻止程序。It is possible your browser blocks third-party cookies because you are using an incognito session or have an ad blocker enabled. 阻止第三方 Cookie 可能会导致加载门户时出现问题,例如被重定向到空白页 https://adf.azure.cn/accesstoken.html ,或收到警告消息,指出已阻止第三方 Cookie。Blocking third-party cookies can cause issues when loading the portal, such as being redirected to a blank page, https://adf.azure.cn/accesstoken.html, or getting a warning message saying that third-party cookies are blocked. 若要解决此问题,请使用以下步骤在浏览器上启用第三方 Cookie 选项:To solve this problem, enable third-party cookies options on your browser using the following steps:

Google ChromeGoogle Chrome

允许所有 CookieAllow all cookies

  1. 在浏览器中访问“chrome://settings/cookies”。Visit chrome://settings/cookies in your browser.

  2. 选择“允许所有 Cookie”选项Select Allow all cookies option

    在 Chrome 中允许所有 Cookie

  3. 刷新 ADF UX,然后重试。Refresh ADF UX and try again.

仅允许 ADF UX 使用 CookieOnly allow ADF UX to use cookies

如果你不想要允许所有 Cookie,则可以选择只允许 ADF UX:If you do not want to allow all cookies, you can optionally just allow ADF UX:

  1. 访问“chrome://settings/cookies”。Visit chrome://settings/cookies.

  2. 选择“始终可以使用 Cookie 的站点”选项下的“添加” Select add under Sites that can always use cookies option

    将 ADF UX 添加到 Chrome 中允许的站点

  3. 添加“adf.azure.cn”站点,选中“所有 Cookie”选项,然后保存 。Add adf.azure.cn site, check all cookies option, and save.

    允许来自 ADF UX 站点的所有 Cookie

  4. 刷新 ADF UX,然后重试。Refresh ADF UX and try again.

Microsoft EdgeMicrosoft Edge

  1. 在浏览器中访问“edge://settings/content/cookies”。Visit edge://settings/content/cookies in your browser.

  2. 确保启用了“允许站点保存和读取 Cookie 数据”,并禁用了“阻止第三方 Cookie”选项 Ensure Allow sites to save and read cookie data is enabled and that Block third-party cookies option is disabled

    允许 Edge 中的所有 Cookie

  3. 刷新 ADF UX,然后重试。Refresh ADF UX and try again.

仅允许 ADF UX 使用 CookieOnly allow ADF UX to use cookies

如果你不想要允许所有 Cookie,则可以选择只允许 ADF UX:If you do not want to allow all cookies, you can optionally just allow ADF UX:

  1. 访问“edge://settings/content/cookies”。Visit edge://settings/content/cookies.

  2. 在“允许”部分下,选择“添加”并添加“adf.azure.cn”站点 。Under Allow section, select Add and add adf.azure.cn site.

    将 ADF UX 添加到 Edge 中允许的站点

  3. 刷新 ADF UX,然后重试。Refresh ADF UX and try again.

ADF UX 上出现连接失败Connection failed on ADF UX

有时,单击“测试连接”、“预览”等之后,你会在 ADF UX 上看到“连接失败”错误,类似于以下屏幕截图 。Sometimes you would see "Connection failed" errors on ADF UX similar to the screenshot below after clicking Test Connection, Preview, etc.

连接失败

在这种情况下,你可以先在浏览器中使用 InPrivate 浏览模式尝试相同的操作。In this case, you can first try the same operation with InPrivate browsing mode in your browser.

如果这仍然不起作用,在浏览器中,按 F12 打开“开发人员工具”。If it's still not working, in the browser, press F12 to open Developer Tools. 转到“网络”选项卡,选中“禁用缓存”,重试失败的操作,并找到失败的请求(红色) 。Go to the Network tab, check Disable Cache, retry the failed operation, and find the failed request (in red).

失败的请求

然后,从失败请求的“请求 URL”中找到“主机名”(本例中是“dpnortheurope.svc.datafactory.azure.cn”) 。Then find the host name (in this case, dpnortheurope.svc.datafactory.azure.cn) from the Request URL of the failed request.

直接在浏览器的地址栏中键入该主机名。Type the host name directly in the address bar of your browser. 如果你在浏览器中看到 404,这通常意味着客户端正常,问题出在 ADF 服务端。If you see 404 in the browser, this usually means your client side is ok and the issue is at ADF service side. 通过 ADF UX 错误消息中的“活动 ID”提交支持票证。File a support ticket with the Activity ID from the ADF UX error message.

找不到资源

如果没有看到 404,或者在浏览器中看到类似下方的错误,这通常意味着你遇到了一些客户端问题。If not or you see similar error below in the browser, this usually means you have some client-side issue. 进一步执行故障排除步骤。Further follow the troubleshooting steps.

客户端错误

打开“命令提示符”,键入“nslookup dpnortheurope.svc.datafactory.azure.cn” 。Open Command Prompt and type nslookup dpnortheurope.svc.datafactory.azure.cn. 正常响应应如下所示:A normal response should look like below:

命令响应 1

如果你看到正常的 DNS 响应,请与本地 IT 支持取得进一步联系,检查防火墙设置,确定是否阻止了与此主机名的 HTTPS 连接。If you see a normal DNS response, further contact your local IT support to check the firewall settings on whether HTTPS connection to this host name is blocked or not. 如果无法解决该问题,请通过 ADF UX 错误消息中的“活动 ID”提交支持票证。If the issue could not be resolved, file a support ticket with the Activity ID from the ADF UX error message.

如果你看到除此之外的任何内容,这通常意味着解析 DNS 名称时,DNS 服务器出现了问题。If you see anything else than this, this usually means there is something wrong with your DNS server when resolving the DNS name. 通常,更改 ISP(Internet 服务提供商)或 DNS(例如,改为 Google DNS 8.8.8.8)可能是一种可行的解决办法。Usually changing ISP (Internet Service Provider) or DNS (e.g., to Google DNS 8.8.8.8) could be a possible workaround to try. 如果此问题仍然存在,你可以进一步尝试“nslookup datafactory.azure.cn”和“nslookup azure.cn”以查看 DNS 解析失败所处的级别,并将所有信息提交给本地 IT 支持或 ISP 进行故障排除 。If the issue persists, you could further try nslookup datafactory.azure.cn and nslookup azure.cn to see at which level your DNS resolution is failed and submit all information to your local IT support or your ISP for troubleshooting. 如果他们认为问题仍然存在于 Azure 端,请通过 ADF-UX 错误消息中的“活动 ID”提交支持票证。If they believe the issue is still at Azure side, file a support ticket with the Activity ID from the ADF UX error message.

命令响应 2

更改数据集中的链接服务类型Change linked service type in datasets

文件格式数据集可以与所有基于文件的连接器一起使用;例如,你可以在 Azure Blob 或 Azure Data Lake Storage Gen2 上配置 Parquet 数据集。File format dataset can be used with all the file-based connectors, for example, you can configure a Parquet dataset on Azure Blob or Azure Data Lake Storage Gen2. 注意,每个连接器在活动中通过不同的应用模型,支持不同的数据存储相关设置集。Note each connector supports different set of data store related settings on the activity, and with different app model.

在 ADF 创作 UI 上,若你在活动(包括复制、查找、GetMetadata、删除活动)中使用文件格式数据集,并且在该数据集中,你希望指向不同于当前类型的链接服务(例如从文件系统切换到 ADLS Gen2),则你会看到以下警告消息。On ADF authoring UI, when you use a file format dataset in an activity - including Copy, Lookup, GetMetadata, Delete activities - and in dataset you want to point to a linked service of different type from the current (e.g. switch from File System to ADLS Gen2), you would see the following warning message. 若要确保这是一个干净的切换操作,在你同意的情况下,引用此数据集的管道和活动也将被修改以使用新类型,并且任何与新类型不兼容的现有数据存储设置都将被清除,因为它不再适用。To make sure it's a clean switch, upon your consent, the pipelines and activities, which reference this dataset will be modified to use the new type as well, and any existing data store settings, which are incompatible with the new type will be cleared as it no longer applies.

若要详细了解每个连接器支持的数据存储设置,可以转到相应的连接器文章 -> 复制活动属性以查看详细的属性列表。To learn more on which the supported data store settings for each connector, you can go to the corresponding connector article -> copy activity properties to see the detailed property list. 请参阅 Amazon S3Azure BlobAzure Data Lake Storage Gen2Azure 文件存储文件系统FTPGoogle 云存储HDFSHTTPSFTPRefer to Amazon S3, Azure Blob, Azure Data Lake Storage Gen2, Azure File Storage, File System, FTP, Google Cloud Storage, HDFS, HTTP, and SFTP.

警告消息