设置超时限制

在 Azure 数据资源管理器中,可以自定义查询和管理命令的超时长度。 本文介绍如何在各种工具(例如 Azure 数据资源管理器 Web UIKusto.ExplorerKusto.CliPower BI)中以及在使用 SDK 时设置自定义超时。 某些工具有自身的默认超时值,但根据查询的复杂性和预期运行时间调整这些值可能有帮助。

注意

服务器端策略(例如请求限制策略)可以替代客户端指定的超时。

Azure 数据资源管理器 Web UI

本部分介绍如何在 Azure 数据资源管理器 Web UI 中配置自定义查询超时和管理命令超时。

先决条件

  • Microsoft 帐户或 Microsoft Entra 用户标识。 无需 Azure 订阅。
  • Azure 数据资源管理器群集和数据库。 创建群集和数据库

设置超时长度

  1. 使用 Microsoft 帐户或 Microsoft Entra 用户身份凭据登录到 Azure 数据资源管理器 Web UI

  2. 在顶部菜单中选择“设置”图标。

  3. 在左侧菜单中选择“连接”。

  4. 在“查询超时(分钟)”设置下,使用滑块选择所需的查询超时长度。

  5. 在“管理命令超时(分钟)”设置下,使用滑块选择所需的管理命令超时长度。

    Screenshot of the settings in the Azure Data Explorer web UI that control timeout length.

  6. 关闭设置窗口,更改将自动保存。

Kusto.Explorer

本部分介绍如何在 Kusto.Explorer 中配置自定义查询超时和管理命令超时。

先决条件

设置超时长度

  1. 打开 Kusto.Explorer 工具。

  2. 在顶部菜单中选择“工具”选项卡。

  3. 在右侧选择“选项”。

    Screenshot showing the options widget in the Kusto.Explorer tool.

  4. 在左侧菜单中选择“连接”。

  5. 在“查询服务器超时”设置中输入所需的超时长度。 最大值为 1 小时。

  6. 在“管理命令服务器超时”设置下输入所需的超时长度。 最大值为 1 小时。

    Screenshot showing settings that control the timeout length in Kusto.Explorer.

  7. 选择“确定”以保存更改。

Kusto.Cli

本部分介绍如何在 Kusto.Cli 中配置自定义服务器超时。

先决条件

设置超时长度

运行以下命令,将包含所需超时长度的 servertimeout 客户端请求属性设置为最大 1 小时的有效时间范围值。

Kusto.Cli.exe <ConnectionString> -execute:"#crp servertimeout=<timespan>" -execute:"…"

或者,使用以下命令设置 norequesttimeout 客户端请求属性,该属性将超时设置为最大值 1 小时。

Kusto.Cli.exe <ConnectionString> -execute:"#crp norequesttimeout=true" -execute:"…"

设置后,该客户端请求属性将应用于所有未来值,直到应用程序重启或设置了另一个值。 若要检索当前值,请使用:

Kusto.Cli.exe <ConnectionString> -execute:"#crp servertimeout"

Power BI

本部分介绍如何在 Power BI 中配置自定义服务器超时。

先决条件

设置超时长度

  1. 从 Power BI Desktop 连接到 Azure 数据资源管理器群集

  2. 在顶部菜单中选择“转换数据”。

    Screenshot of the transform data option in Power BI Desktop.

  3. 在顶部菜单中选择“高级查询编辑器”。

    Screenshot of the Power BI advanced query editor option in Power BI Desktop.

  4. 在弹出窗口中,在 AzureDataExplorer.Contents 方法的第四个参数中设置超时选项。 以下示例演示如何将超时长度设置为 59 分钟。

    let 
        Source = AzureDataExplorer.Contents(<cluster>, <database>, <table>, [Timeout=#duration(0,0,59,0)])
    in
        Source
    
  5. 选择“完成”以应用更改。

SDK

若要了解如何使用 SDK 设置超时,请参阅使用客户端请求属性自定义查询行为