タイムアウト制限を設定する

適用対象: ✅Azure データ エクスプローラー

クエリと管理コマンドのタイムアウト長 カスタマイズできます。 この記事では、Azure Data Explorer Web UI、Kusto.Explorer、Kusto.Cli、Power BI などのさまざまなツール内と SDK を使用する際にカスタム タイムアウトを設定する方法を学習します。 一部のツールは独自の既定のタイムアウト値を持っていますが、クエリの複雑さと予想される実行時間に基づいてこれらの値を調整することが有用な場合があります。

Note

要求制限ポリシーなどのサーバー側ポリシーは、クライアントによって指定されたタイムアウトをオーバーライドできます。

Azure Data Explorer の Web UI

このセクションでは、Azure Data Explorer Web UI でカスタム クエリ タイムアウトと管理者コマンド タイムアウトを構成する方法について説明します。

前提条件

• Microsoft アカウントまたは Microsoft Entra ユーザー ID。 Azure サブスクリプションは不要です。
• Azure Data Explorer クラスターとデータベース。 クラスターとデータベースを作成します。

タイムアウトの長さを設定する

1. Microsoft アカウントまたは Microsoft Entra ユーザー ID 資格情報を使用して Azure Data Explorer Web UI にサインインします。

2. 上部のメニューで、[設定] アイコンを選択します。

3. 左側のメニューから、[接続] を選択します。

4. [クエリ タイムアウト (分単位)] 設定で、スライダーを使用して目的のクエリのタイムアウトの長さを選択します。

5. [管理者コマンド タイムアウト (分単位)] 設定で、スライダーを使用して目的の管理者コマンドのタイムアウトの長さを選択します。

   

6. 設定ウィンドウを閉じると、変更内容が自動的に保存されます。

Kusto.Explorer

このセクションでは、Kusto.Explorer でカスタム クエリ タイムアウトと管理者コマンド タイムアウトを構成する方法について説明します。

前提条件

• Kusto.Explorer ツールをダウンロードしてインストールします。
• Azure Data Explorer クラスターとデータベース。 クラスターとデータベースを作成します。

タイムアウトの長さを設定する

1. Kusto.Explorer ツールを開きます。

2. 上部のメニューで、[ツール] タブを選択します。

3. 右側で [オプション] を選択します。

   

4. 左側のメニューで、[接続] を選択します。

5. [クエリ サーバー タイムアウト] 設定で、目的のタイムアウトの長さを入力します。 最大値は 1 時間です。

6. [管理者コマンド サーバー タイムアウト] 設定で、目的のタイムアウトの長さを入力します。 最大値は 1 時間です。

   

7. [OK] を選択して変更を保存します。

Kusto.Cli

このセクションでは、Kusto.Cli でカスタム サーバー タイムアウトを構成する方法について説明します。

前提条件

• Microsoft.Azure.Kusto.Tools パッケージをダウンロードすることで Kusto.Cli をインストールします。

タイムアウトの長さを設定する

次のコマンドを実行して、servertimeout クライアント要求プロパティに必要なタイムアウトの長さを最大 1 時間の有効な timespan 値として設定します。

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 でカスタム サーバー タイムアウトを構成する方法について説明します。

前提条件

• Power BI Desktop

タイムアウトの長さを設定する

1. Power BI Desktop から Azure Data Explorer クラスターに接続します。

2. 上部のメニューで、[データの変換] を選択します。

   

3. 上部のメニューで、[詳細クエリ エディター] を選択します。

   

4. ポップアップ ウィンドウで、AzureDataExplorer.Contents メソッドの 4 番目のパラメーターにタイムアウト オプションを設定します。 次の例は、タイムアウトの長さを 59 分に設定する方法を示しています。

   let 
       Source = AzureDataExplorer.Contents(<cluster>, <database>, <table>, [Timeout=#duration(0,0,59,0)])
   in
       Source
   

5. 完了 を選択して変更を適用します。

SDK

SDK を使用してタイムアウトを設定する方法を確認するには、「クライアント要求プロパティを使用したクエリ動作のカスタマイズ」を参照してください。

関連するコンテンツ

• クエリの制限