PolarDB:制御パラメーターと動作

DDL 実行エンジンパラメーター

PolarDB-X 1.0 コンソールで、以下の DDL 実行エンジンパラメーターをカスタマイズできます。

ENABLE_ASYNC_DDL

• 説明
  • このパラメーターはデフォルトで有効になっており、新しい DDL 実行エンジンが使用されます。
  • このパラメーターを無効にすると、PolarDB-X 1.0 は 5.3.12 より前のバージョンの DDL 実行エンジンを使用します。PURE_ASYNC_DDL_MODE および MAX_TABLE_PARTITIONS_PER_DB パラメーターは効果がありません。
• 使用方法
  • データベースレベル：PolarDB-X 1.0 コンソールでこのパラメーターを調整できます。この設定はデータベース全体に適用されます。詳細については、「パラメーター設定」をご参照ください。
  • ステートメントレベル：DDL ステートメントの前にヒント /*+TDDL:cmd_extra(ENABLE_ASYNC_DDL=FALSE)*/ を追加できます。この設定は、そのステートメントにのみ適用されます。

PURE_ASYNC_DDL_MODE

• 説明
  • このパラメーターは、ENABLE_ASYNC_DDL が TRUE に設定されている場合にのみ有効です。
  • このパラメーターが無効の場合、PolarDB-X 1.0 に接続するクライアントは DDL ステートメントを同期モードで実行します。DDL タスクが完了した後にのみ応答が返されます。クライアントと PolarDB-X 1.0 間の接続が中断されると、DDL タスクも中断される可能性があります。
  • このパラメーターが有効の場合、PolarDB-X 1.0 に接続するクライアントは DDL ステートメントを非同期モードで実行します。DDL リクエストを受信した直後に応答が返され、DDL タスクはバックグラウンドで実行され続けます。SHOW DDL を使用して DDL タスクのステータスを確認できます。SHOW DDL の使用方法の詳細については、「タスク管理ステートメント」をご参照ください。
  • このパラメーターを TRUE に設定すると非同期モードが有効になり、クライアントと PolarDB-X 1.0 間の予期しない接続中断を防ぐことができます。それ以外の場合は、MySQL DDL の動作との互換性を確保するため、デフォルト値 (FALSE) を維持してください。
• 使用方法
  • データベースレベル：PolarDB-X 1.0 コンソールでこのパラメーターを調整できます。この設定はデータベース全体に適用されます。詳細については、「パラメーター設定」をご参照ください。
  • セッションレベル：
    • PolarDB-X 1.0 に接続した後、set PURE_ASYNC_DDL_MODE=true または set PURE_ASYNC_DDL_MODE=1 を実行して非同期モードを有効にできます。この設定は現在のセッションに適用されます。
    • set PURE_ASYNC_DDL_MODE=false または set PURE_ASYNC_DDL_MODE=0 を実行して、セッションのデフォルトの同期モードに戻すことができます。
  • ステートメントレベル：DDL ステートメントの前にヒント /*+TDDL:cmd_extra(PURE_ASYNC_DDL_MODE=TRUE)*/ を追加できます。この設定は、そのステートメントにのみ適用されます。

MAX_TABLE_PARTITIONS_PER_DB

• 説明
  • このパラメーターは、ENABLE_ASYNC_DDL が TRUE に設定されている場合にのみ有効です。
  • シャードテーブルを作成する際、単一の物理データベースのテーブルシャード数がこのパラメーターの値を超えると、DDL タスクは失敗してエラーが返されます。
    説明 このパラメーターの値の範囲は 1 から 65535 です。デフォルト値は 128 です。
• 使用方法
  • データベースレベル：PolarDB-X 1.0 コンソールでこのパラメーターを調整できます。この設定はデータベース全体に適用されます。詳細については、「パラメーター設定」をご参照ください。
  • ステートメントレベル：DDL ステートメントの前にヒント /*+TDDL:cmd_extra(MAX_TABLE_PARTITIONS_PER_DB=400)*/ を追加できます。この設定は、そのステートメントにのみ適用されます。