すべてのプロダクト
Search
ドキュメントセンター

PolarDB:クラスターパラメーターとノードパラメーターの設定

最終更新日:Jun 23, 2026

PolarDB クラスターを作成した後、コンソールを使用してクラスターパラメーターとノードパラメーターを変更し、クラスターパラメーターをテンプレートとしてエクスポートできます。また、パラメーターテンプレートを適用して、同じリージョン内の他のクラスターのパラメーターを迅速に変更することもできます。このトピックでは、パラメーターの変更、テンプレートとしてのエクスポート、およびテンプレートの適用方法について説明します。

背景情報

ビジネス要件に合わせて PolarDB ノードパラメーターを構成できます。

  • クラスターに追加された新しいノードは、デフォルトでクラスターパラメーターを使用します。

  • プライマリノードに障害が発生した場合:

    • 元のプライマリノードは読み取り専用ノードになり、そのパラメーターは変更されません。

    • 元の読み取り専用ノードがプライマリノードに昇格し、そのパラメーターは変更されません。

  • プライマリゾーンに障害が発生した場合、セカンダリゾーンのノードがプライマリノードに昇格し、クラスターパラメーターを使用します。

注意事項

  • MySQL 設定ファイルとの互換性を保つため、PolarDB コンソールのすべてのクラスターパラメーターには `loose_` プレフィックスが使用されます。

    例えば、`loose_rds_audit_log_event_buffer_size` と `rds_audit_log_event_buffer_size` は同じパラメーターです。

  • 一部のノードパラメーターまたはパラメーター値のみ変更できます。詳細については、コンソールでサポートされているオプションをご参照ください。

  • コンソールで変更できないノードパラメーターを変更するには、クォータセンターに移動します。クォータ名が クラスターとノードのパラメーターを設定 のクォータを見つけ、操作 列の 申請 をクリックし、リクエストの理由 フィールドに変更したいクラスター ID とパラメーターを入力します。

    説明
    • 現在、変更できるのは以下のパラメーターのみです:

      • PolarDB for MySQL 5.6 および 5.7:ノードパラメーター `innodb_buffer_pool_size`。

      • PolarDB for MySQL 8.0:ノードパラメーター `innodb_buffer_pool_size`、`loose_oss_outfile_buffer_size`、`loose_max_oss_outfile_threads`、および `loose_csv_oss_buff_size`。

    • ご質問がある場合や、他のパラメーターの変更が必要な場合は、お問い合わせください。

パラメーター値の変更

クラスターパラメーターの変更はクラスター内のすべてのノードに影響します。ノードパラメーターの変更は指定されたノードにのみ影響します。このセクションでは、クラスターパラメーターの変更方法の例を示します。

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

  2. 左上のコーナーで、クラスターがデプロイされているリージョンを選択します。

  3. ターゲットクラスターを見つけ、その ID をクリックします。

  4. 左側のナビゲーションウィンドウで、設定と管理 > パラメーター を選択します。

  5. クラスターパラメーターを変更するには、左上のドロップダウンリストから [クラスター] を選択します。

    ノードパラメーターを変更するには、ドロップダウンリストからノードを選択します。

  6. ページの左上隅にある パラメーターの変更 をクリックします。

  7. パラメーターを見つけて、新しい値を入力します。

    説明
    • 値の範囲 列で指定された範囲内の値を入力する必要があります。そうしないと、変更の適用 をクリックしたときにエラーが発生します。

    • パラメーター名の横にある 参数图标 アイコンをクリックすると、その詳細を表示できます。

    • 互換性のため、コンソールのパラメーターには `loose_` プレフィックスが使用されます。例えば、`loose_rds_audit_log_event_buffer_size` と `rds_audit_log_event_buffer_size` は同じパラメーターです。

  8. 左上隅にある 変更の適用 をクリックします。

  9. 変更内容の保存 ページで、更新するノードを選択し、OK をクリックします。

    ダイアログボックスのパラメーター変更テーブルには、[パラメーター][新しい値][現在の値][デフォルト値]、および [グローバルパラメーター] の列が含まれています。[すべてを現在の値に設定] または [すべてをデフォルト値に設定] をクリックすることで、パラメーターを迅速に調整できます。グローバルパラメーターを変更すると、デフォルトですべてのノードが選択されます。

    説明
    • 強制再起動 の値が はい であるパラメーターの場合、新しいパラメーター値を有効にするには、クラスター内のすべてのノードを再起動する必要があります。クラスターを再起動する前に、このダウンタイムを計画し、注意して進めてください。

    • ご利用の PolarDB for MySQL クラスターがバージョン 8.0 の場合、innodb_fast_startup パラメーターを ON に設定して再起動を高速化することもできます。

パラメーターテンプレートの適用

パラメーターを設定した後、次の操作を実行できます:

  • クラスターパラメーターをパラメーターテンプレートとしてエクスポートします。

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

    2. コンソールの左上隅で、クラスターが配置されているリージョンを選択します。

    3. クラスターを見つけ、そのクラスター ID をクリックします。

    4. 左側のナビゲーションウィンドウで、設定と管理 > パラメーター をクリックします。

    5. テンプレートとしてエクスポート をクリックします。

      説明
      • 現在のリストのパラメーターを変更したい場合は、まずそれらを変更してから テンプレートとしてエクスポート をクリックします。

      • エクスポートされたパラメーターテンプレートには、手動で変更したパラメーターと、クラスターがランタイム中に自動的に調整したパラメーターが含まれます。

    6. テンプレートの適用 ダイアログボックスで、次のパラメーターを設定します。

      パラメーター

      説明

      テンプレート名

      テンプレート名。次の要件を満たす必要があります:

      • 文字で始まり、文字、数字、アンダースコア (_) のみを含む必要があります。

      • 長さは 8〜64 文字である必要があります。

      説明

      テンプレートの説明を入力します。説明の長さは 0〜200 文字です。

    7. OK をクリックします。

  • パラメーターテンプレートをクラスターに適用します。

    1. テンプレートの適用 をクリックします。

    2. テンプレートの適用 ダイアログボックスで、使用したいパラメーターテンプレートの名前を選択し、OK をクリックします。

      説明
      • テンプレート内のパラメーター数、再起動が必要かどうか、および更新時刻を表示できます。

      • パラメーターテンプレートにクラスターの再起動が必要なパラメーターが含まれている場合は、オフピーク時にこの操作を実行し、アプリケーションに再接続メカニズムがあることを確認してください。

      • パラメーターテンプレートページでクラスターにパラメーターテンプレートを適用することもできます。詳細については、「パラメーターテンプレートの適用」をご参照ください。

ノードパラメーターの比較

比較機能を使用して、異なるノード間のパラメーター構成を比較できます。

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

  2. 左上のコーナーで、クラスターがデプロイされているリージョンを選択します。

  3. ターゲットクラスターを見つけ、その ID をクリックします。

  4. 左側のナビゲーションウィンドウで、設定と管理 > パラメーター を選択します。

  5. ページの左上隅にある 比較 をクリックします。

    [比較] パネルで、比較するノード (例えば、プライマリノード読み取り専用ノード) を選択します。

  6. 異なるパラメーターの数や再起動が必要かどうかなどの違いを示す比較結果を確認します。

API リファレンス

API

説明

DescribeDBClusterParameters

クラスターのパラメーターを照会します。

ModifyDBClusterParameters

クラスターのパラメーターを変更します。

ModifyDBClusterAndNodesParameters

クラスターパラメーターを変更し、変更を指定されたノードに適用します。

ModifyDBNodesParameters

1 つ以上の指定されたノードのパラメーターを変更します。

DescribeParameterTemplates

デフォルトのパラメーターテンプレートのリストを照会します。