Database Autonomy Service:SQL スロットリング

スロットリングメッセージ

SQL スロットリングルールが作成された後、アプリケーションが指定されたすべてのキーワードを含む SQL 文を使用するか、テンプレートスロットリングルールに一致する場合、データベースシステムはスロットリングが有効になるとインスタンスバージョンに基づいて対応するメッセージを返します。

シナリオ

スロットリングモード

手順

1. DAS コンソール にログインします。

2. 左側のナビゲーションウィンドウで、[インテリジェント O&M センター] > インスタンスモニター を選択します。

3. 表示されたページで、管理するデータベースインスタンスを見つけ、インスタンス ID をクリックします。 インスタンスの詳細ページが表示されます。

4. 左側のナビゲーションウィンドウで、インスタンスセッション をクリックします。

5. セッション管理 タブで、SQL スロットリング をクリックします。

6. 表示されたパネルで、[スロットリングルールを作成] をクリックします。

7. [スロットリングルールを作成] ダイアログボックスで、データベースエンジンに基づいて次のパラメーターを設定します。

ApsaraDB RDS for MySQL

パラメーター	説明
[スロットリングモード]	SQL 文のスロットリングに使用するモード。 ビジネス要件に基づいて スロットリングモード を選択します。
[SQL タイプ]	スロットリングする SQL 文のタイプ。 有効な値: [SELECT]、[UPDATE]、[DELETE]、および [INSERT]。 説明 [スロットリングモード] が [キーワードによるスロットリング] に設定されている場合、このパラメーターは必須です。 INSERT SQL 文は、次のデータベースエンジンのいずれかでスロットリングできます。 ApsaraDB RDS for MySQL 8.0 PolarDB for MySQL 5.7 および 8.0 PolarDB-X 2.0 INSERT...SELECT... 形式の SQL ステートメントはスロットルできません。
データベース	SQL 文がスロットルされるデータベース。 説明 このパラメーターは、[スロットリングモード] が [SQL テンプレート別スロットル] に設定されている場合に必須です。
最大同時実行数	同時実行される SQL 文の最大数です。このパラメーターの最小値は 0 です。 説明 スロットリングポリシーを満たし、同時に実行されている SQL 文の数が最大同時実行数に達すると、スロットリングがトリガーされます。
スロットリング期間	SQL スロットリングルールが有効になる期間です。 重要 スロットリング機能は、緊急時の使用のみを目的としています。ビジネス要件に基づいてスロットリング期間を指定し、不要になった場合はスロットリングを無効にすることをお勧めします。
SQL キーワード	スロットルが必要な SQL 文を識別するために使用されるキーワードです。 説明 [スロットリングモード] が [キーワード別スロットリング] に設定されている場合、このパラメーターは必須です。 複数のキーワードを指定した場合、SQL 文に指定されたすべてのキーワードが含まれている場合にのみスロットリングがトリガーされます。複数のキーワードは、チルダ（～）で区切られ、順序の制限はありません。 たとえば、スロットル対象の元の SQL 文が SELECT min(id), max(id) FROM task_event WHERE gmt_modified < '2020-06-21' AND begin_time > '2020-07-09' AND source IN (527) AND id >= 15673 AND id <= 8015673 の場合、このパラメーターを SELECT~min~id~max~id~FROM~task_event~WHERE~gmt_modified~AND~begin_time~AND~source~IN~AND~id~AND~id に設定します。 このパラメーターを SELECT、INSERT、UPDATE、または DELETE のみに設定しないでください。一部の以前のバージョンのインスタンスを除き、キーワードは大文字と小文字が区別されます。
SQL サンプル	速度制限の対象にする SQL 文のサンプルです。 説明 [速度制限モード] が [SQL テンプレートによる速度制限] に設定されている場合、このパラメーターは必須です。 複雑な SQL 文の場合、DAS は SQL テンプレートの構造を変更せずに SQL サンプルを最適化します。そのため、最適化後も速度制限の効果に影響はありません。 たとえば、SQL サンプル select name from das where name = 'das' and age = 21 limit 20 を入力すると、DAS はそれを SQL テンプレート select name from das where name = ? and age = ? limit ? に変換し、さらにテンプレートを select name from das where name = 'param0' and age = 'param1' limit 20 に書き換えます。

ApsaraDB RDS for PostgreSQL

パラメーター	説明
スロットリングモード	SQL 文をスロットルするために使用するモード。SQL テンプレートによるスロットルのみがサポートされています。
データベース	SQL 文がスロットルされるデータベース。
検索パス	SQL スロットリングを実行する検索パス。 説明 複数のパスはカンマ（,）で区切ります。デフォルト値：information_schema,public。
最大同時実行数	同時実行される SQL 文の最大数。このパラメーターの最小値は 0 です。 説明 スロットリングポリシーを満たす同時実行 SQL 文の数が最大同時実行数に達すると、スロットリングがトリガーされます。
最大待機クエリ数	待機中の SQL 文の最大数。
スロットリング期間	SQL スロットリングルールが有効になる期間。 重要 スロットリング機能は緊急時の使用のみを目的としています。ビジネス要件に基づいてスロットリング期間を指定し、不要になった場合はスロットリングを無効にすることをお勧めします。
SQL サンプル	スロットルする SQL 文のサンプル。 説明 スロットリングモードがSQL テンプレートによるスロットルに設定されている場合、このパラメーターは必須です。 複雑な SQL 文の場合、DAS は SQL テンプレート構造を変更せずに SQL サンプルを最適化します。したがって、最適化後もスロットリング効果は影響を受けません。 たとえば、SQL サンプル select name from das where name = 'das' and age = 21 limit 20 を入力すると、DAS はそれを SQL テンプレート select name from das where name = ? and age = ? limit ? に変換し、さらにテンプレートを select name from das where name = 'param0' and age = 'param1' limit 20 に書き換えます。

PolarDB for MySQL

パラメーター	説明
スロットリングモード	SQL 文をスロットルするために使用するモード。ビジネス要件に基づいて スロットリングモード を選択します。
SQL タイプ	スロットルする SQL 文のタイプ。有効な値: SELECT、UPDATE、DELETE、および INSERT。 説明 INSERT SQL 文は、次のデータベースエンジンのいずれかでスロットルできます。 ApsaraDB RDS for MySQL 8.0 PolarDB for MySQL 5.7 および 8.0 PolarDB-X 2.0 INSERT...SELECT... 形式の SQL 文はスロットルできません。
最大同時実行数	同時実行される SQL 文の最大数。このパラメーターの最小値は 0 です。 説明 スロットリングポリシーを満たし、同時に実行される SQL 文の数が最大同時実行数に達すると、スロットリングがトリガーされます。
データベース	SQL 文がスロットルされるデータベース。 説明 [スロットリングモード] が [SQL テンプレートによるスロットル] に設定されている場合、このパラメーターは必須です。
スロットリング期間	SQL スロットリングルールが有効になる期間。 重要 スロットリング機能は緊急時のみに使用することを目的としています。ビジネス要件に基づいてスロットリング期間を指定し、不要になった場合はスロットリングを無効にすることをお勧めします。
SQL キーワード	スロットルする必要がある SQL 文を識別するために使用されるキーワード。 説明 [スロットリングモード] が [キーワードによるスロットル] に設定されている場合、このパラメーターは必須です。 複数のキーワードを指定した場合、SQL 文に指定されたすべてのキーワードが含まれている場合にのみ、スロットリングがトリガーされます。複数のキーワードは、順次制限なしでチルダ (~) で区切られます。 たとえば、スロットルする元の SQL 文が SELECT min(id), max(id) FROM task_event WHERE gmt_modified < '2020-06-21' AND begin_time > '2020-07-09' AND source IN (527) AND id >= 15673 AND id <= 8015673 の場合、このパラメーターを SELECT~min~id~max~id~FROM~task_event~WHERE~gmt_modified~AND~begin_time~AND~source~IN~AND~id~AND~id に設定します。 このパラメーターを SELECT、INSERT、UPDATE、または DELETE のみに設定しないでください。一部の以前のバージョンのインスタンスを除き、キーワードは大文字と小文字が区別されます。
SQL サンプル	スロットルする SQL 文のサンプル。 説明 [スロットリングモード] が [SQL テンプレートによるスロットル] に設定されている場合、このパラメーターは必須です。 複雑な SQL 文の場合、DAS は SQL テンプレートの構造を変更せずに SQL サンプルを最適化します。したがって、最適化後もスロットリング効果は影響を受けません。 たとえば、SQL サンプル select name from das where name = 'das' and age = 21 limit 20 を入力すると、DAS はそれを SQL テンプレート select name from das where name = ? and age = ? limit ? に変換し、さらにテンプレートを select name from das where name = 'param0' and age = 'param1' limit 20 に書き直します。

PolarDB-X 2.0

パラメーター	説明
スロットリングモード	SQL 文をスロットルするために使用するモード。ビジネス要件に基づいて スロットリングモード を選択します。
SQL タイプ	スロットルする SQL 文のタイプ。有効な値: SELECT, UPDATE, DELETE, and INSERT。 説明 INSERT SQL 文は、次のデータベースエンジンのいずれかでスロットルできます。 ApsaraDB RDS for MySQL 8.0 PolarDB for MySQL 5.7 および 8.0 PolarDB-X 2.0 INSERT...SELECT... 形式の SQL 文はスロットルできません。
最大同時実行数	同時実行される SQL 文の最大数。このパラメーターの最小値は 0 です。 説明 スロットリングポリシーを満たし、同時に実行される SQL 文の数が最大同時実行数に達すると、スロットリングがトリガーされます。
スロットリング期間	SQL スロットリングルールが有効になる期間。 重要 スロットリング機能は緊急時のみを対象としています。ビジネス要件に基づいてスロットリング期間を指定し、不要になったらスロットリングを無効にすることをお勧めします。
SQL キーワード	スロットルする必要がある SQL 文を識別するために使用されるキーワード。 説明 スロットリングモード が キーワードによるスロットル に設定されている場合、このパラメーターは必須です。 複数のキーワードを指定した場合、SQL 文に指定されたすべてのキーワードが含まれている場合にのみ、スロットリングがトリガーされます。複数のキーワードは、順次制限なしでチルダ (~) で区切られます。 たとえば、スロットルする元の SQL 文が SELECT min(id), max(id) FROM task_event WHERE gmt_modified < '2020-06-21' AND begin_time > '2020-07-09' AND source IN (527) AND id >= 15673 AND id <= 8015673 の場合、このパラメーターを SELECT~min~id~max~id~FROM~task_event~WHERE~gmt_modified~AND~begin_time~AND~source~IN~AND~id~AND~id に設定します。 このパラメーターを SELECT、INSERT、UPDATE、または DELETE のみに設定しないでください。キーワードは大文字と小文字が区別されます (一部の以前のバージョンのインスタンスを除く)。
SQL テンプレート ID	スロットルする SQL 文で使用される SQL テンプレートの ID。複数の ID はコンマ (,) で区切ります。 説明 データベースエンジンが PolarDB-X Enterprise Edition で、スロットリングモード が SQL テンプレートによるスロットル に設定されている場合、このパラメーターは必須です。
SQL の最小実行時間	SQL 実行時間のしきい値。SQL 文の実行時間がこのしきい値を超えると、DAS はこの SQL 文が属する SQL テンプレートの ID をスロットリングルールに追加します。 説明 インスタンスが PolarDB-X Enterprise Edition インスタンスで、スロットリングモード が 実行時間によるスロットル に設定されている場合、このパラメーターは必須です。
スロットルされる SQL ID の最大数	実行時間によってスロットルできる SQL テンプレート ID の最大数。このしきい値に達すると、DAS は実行時間のしきい値に達した他の SQL 文のスロットリングルールの作成を停止します。 説明 インスタンスが PolarDB-X Enterprise Edition インスタンスで、スロットリングモード が 実行時間によるスロットル に設定されている場合、このパラメーターは必須です。
クエリがスロットルされたデータベースアカウント	スロットルされた SQL が属するデータベースアカウント。 説明 スロットリングモード が キーワードによるスロットル または SQL テンプレートによるスロットル に設定されている場合、このパラメーターは必須です。

8. [送信] をクリックします。

   SQL 速度制限ルールが作成されると、[実行中] タブでルールに関する情報を表示できます。次の表にパラメーターを示します。

   説明

   パラメーターは、データベースエンジンと速度制限モードによって若干異なる場合があります。

   パラメーター	説明
   速度制限モード	SQL 文を制限するために使用するモード。
   速度制限ルール	キーワードによる制限: 設定された速度制限キーワード。 SQL テンプレートによる制限: 制限されるサンプルに対応するテンプレート ID。 実行時間による制限: 設定された実行時間のしきい値と、テンプレートによって制限される SQL 文の数。
   最大同時実行数	同時実行される SQL 文の最大数。
   最大待機クエリ数	速度制限ルールで設定された待機中の SQL 文の最大数。 説明 このパラメーターは、データベースインスタンスが ApsaraDB RDS for PostgreSQL で、速度制限モード が SQL テンプレートによる制限 に設定されている場合に表示されます。
   速度制限時間 (分)	SQL 速度制限ルールが有効になる期間。
   開始時間	速度制限ルールが有効になる時間。
   残り時間 (秒)	速度制限ルールの有効期限が切れるまでの残り時間。
   サンプル SQL	制限する SQL 文のサンプル。 説明 このパラメーターは、速度制限モード が SQL テンプレートによる制限 に設定されている場合に表示されます。
   速度制限テンプレート ID	制限する SQL 文のサンプルで使用される SQL テンプレートの ID。 説明 このパラメーターは、速度制限モード が SQL テンプレートによる制限 に設定されている場合に表示されます。
   ステータス	有効になっている速度制限ルールの実行ステータス。
   データベース	SQL 文が制限されるデータベース。 説明 このパラメーターは、速度制限モード が SQL テンプレートによる制限 に設定されている場合に表示されます。
   検索パス	SQL 速度制限を実行するための検索パス。 説明 このパラメーターは、データベースインスタンスが ApsaraDB RDS for PostgreSQL で、速度制限モード が SQL テンプレートによる制限 に設定されている場合に表示されます。
   一致した SQL クエリ	速度制限ルールに一致した SQL 文の数。 説明 このパラメーターは、速度制限モード が SQL テンプレートによる制限 に設定されている場合に表示されます。
   待機中の SQL クエリ	速度制限ルールで待機中の SQL 文の数。 説明 このパラメーターは、速度制限モード が SQL テンプレートによる制限 に設定されている場合に表示されます。
   アクション	速度制限ルールを 無効にする か 変更する 操作。

参考文献

• SQL 自動スロットリング

• PolarDB for MySQL クラスタの同時実行制御機能

• ApsaraDB RDS for MySQL インスタンスの同時実行制御機能

関連 API 操作