你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

设置超时限制

在 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. 在“管理命令超时(分钟)”设置下,使用滑块选择所需的管理命令超时长度。

    Azure 数据资源管理器 Web UI 中用于控制超时长度的设置的屏幕截图。

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

Kusto.Explorer

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

先决条件

设置超时长度

  1. 打开 Kusto.Explorer 工具。

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

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

    显示 Kusto.Explorer 工具中的选项小组件的屏幕截图。

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

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

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

    显示 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. 在顶部菜单中选择“转换数据”。

    Power BI Desktop 中的转换数据选项的屏幕截图。

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

    Power BI Desktop 中 Power BI 高级查询编辑器选项的屏幕截图。

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

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

SDK

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