すべてのプロダクト
Search

このプロダクト

    ApsaraDB for ClickHouse:config.xml パラメーターの設定

    ドキュメントセンター

    ApsaraDB for ClickHouse:config.xml パラメーターの設定

    最終更新日:Jul 18, 2026

    ApsaraDB for ClickHouse クラスターの config.xml ファイル内のグローバルパラメーターを変更し、インスタンスのパフォーマンスを最適化します。

    背景情報

    ApsaraDB for ClickHouse クラスターは、config.xml および user.xml に設定されたデフォルトパラメーター値を使用します。これらのパラメーターを変更することで、ご利用のインスタンスを最適化できます。

    • user.xml 設定ファイル： SET GLOBAL コマンドを実行してパラメーターを変更します。変更は再起動せずに即座に有効になります。詳細については、「user.xml パラメーターの変更」をご参照ください。

    • config.xml 設定ファイル： コンソールからパラメーターを変更します。

    注意事項

    • Community-Compatible Edition クラスターの場合、2021 年 12 月 1 日以降に作成されたクラスターでのみ XML モードによるパラメーター設定および変更履歴の確認が可能です。

    • Enterprise Edition クラスターは、XML モードでのパラメーター設定をサポートしていません。

    • XML モードではパラメーターの削除はサポートされていません。XML モードで設定可能なパラメーターは、Default モードと同一です。

    • 再起動後に有効になるパラメーターを変更した場合、パラメーター変更完了後にクラスターが自動的に再起動します。パラメーターを送信する前に、クラスターの再起動がビジネスに影響しないことを確認してください。

    クラスターへの影響

    • クラスターが 進行中の構成変更 または 再起動中 の状態である場合、クラスター情報の閲覧のみ可能で、インスタンスタイプのスペックアップ、スケールアウト、スケールインなどの操作は実行できません。

    • 再起動後に有効になるパラメーターを変更した場合、パラメーター変更完了後に ClickHouse クラスターが自動的に再起動します。サービスの中断を回避するため、この操作はオフピーク時間帯に実施してください。

    パラメーターの変更

    パラメーターの変更手順は、クラスターのエディションによって異なります。

    重要

    prometheus.port または text_log パラメーターを変更する必要がある場合は、「重要なパラメーター」をご参照ください。

    Enterprise Edition

    1. ApsaraDB for ClickHouse コンソール にログインします。

    2. ページ左上隅で、対象クラスターのリージョンを選択します。

    3. クラスターリスト ページで、Enterprise Edition インスタンスのリスト タブをクリックし、対象クラスターの ID をクリックします。

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

    5. パラメーター値の実行 列で、編集アイコン 参数编辑按钮 をクリックして値を編集します。有効範囲内の値を入力し、を決定 をクリックします。

    6. 必要なパラメーターをすべて変更したら、ページ右上隅の パラメーターの送信 をクリックします。

    7. 設定の保存 ダイアログボックスで、変更前後のパラメーター値を確認し、変更内容を確定して変更理由を入力した後、OK をクリックします。

      重要

      再起動後に有効になるパラメーターを送信した場合、ClickHouse クラスターはパラメーター変更完了後に自動的に再起動します。続行する前に、再起動がビジネスに影響しないことを確認してください。

      パラメーターを送信すると、システムがパラメーター値を検証します。パラメーター値が無効な場合、エラーメッセージが表示されます。エラーコード 102 は、入力された値が無効であることを示します。前のステップに戻り、有効範囲内の値を入力して、再度パラメーターを送信してください。

    コミュニティ互換エディション

    1. ApsaraDB for ClickHouse コンソール にログインします。

    2. ページ左上隅で、対象クラスターのリージョンを選択します。

    3. クラスターリスト ページで、Community Edition インスタンスのリスト タブをクリックし、対象クラスターの ID をクリックします。

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

    5. 設定 タブをクリックします。デフォルトモード または XML モード を選択してパラメーターを変更します。

      重要

      ApsaraDB for ClickHouse コンソールでは、prometheus.port パラメーターの値は 2182 ～ 3000 の範囲内である必要があります。

      • Default モード：パラメーター値の実行 列で、編集アイコン 参数编辑按钮 をクリックして編集モードに入ります。有効範囲内の値を入力し、を決定 をクリックします。

      • XML モード：ページ右上隅の 編集 をクリックして、ファイル内で目的のパラメーターを変更します。

    6. 必要なパラメーターをすべて変更したら、ページ右上隅の パラメーターの送信 をクリックします。

    7. 設定の保存 ダイアログボックスで、変更前後のパラメーター値を確認し、変更内容を確定して変更理由を入力した後、パラメーターの送信 をクリックします。

      重要

      • 再起動後に有効になるパラメーターを送信した場合、ClickHouse クラスターはパラメーター変更完了後に自動的に再起動します。続行する前に、再起動がビジネスに影響しないことを確認してください。

      • XML モードでパラメーター値が無効な場合、エラーメッセージが表示されます。エラーコード 102 は、入力された値が無効であることを示します。前のステップに戻り、有効範囲内の値を入力して、再度パラメーターを送信してください。

    変更の復元

    説明

    • 未送信の変更のみ復元できます。

    • Enterprise Edition クラスターおよび Community-Compatible Edition クラスターの XML モード では、すべてのパラメーター変更を一度にのみ復元できます。

    未送信の変更を復元するには、以下のいずれかの操作を実行します。

    • 単一パラメーター変更の復元：パラメーター値の横にある 撤销图标 アイコンをクリックします。ApsaraDB for ClickHouse は、そのパラメーターの未送信変更を以前の値に復元します。

    • すべてのパラメーター変更の復元：パラメーターリストの右上隅にある 取り消し をクリックします。ApsaraDB for ClickHouse は、すべての未送信変更を以前の値に復元します。

    変更履歴の確認

    Enterprise Edition

    1. ApsaraDB for ClickHouse コンソール にログインします。

    2. ページ左上隅で、対象クラスターのリージョンを選択します。

    3. クラスターリスト ページで、Enterprise Edition インスタンスのリスト タブをクリックし、対象クラスターの ID をクリックします。

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

    5. 変更履歴 タブをクリックして、以下のいずれかの方法で変更履歴を確認します。

      • 過去 30 日間 または 過去 7 日間 をクリックして、該当期間の変更を確認します。

      • 期間を指定して、その期間内の変更レコードを確認します。

    コミュニティ互換エディション

    1. ApsaraDB for ClickHouse コンソール にログインします。

    2. ページ左上隅で、対象クラスターのリージョンを選択します。

    3. クラスターリスト ページで、Community Edition インスタンスのリスト タブをクリックし、対象クラスターの ID をクリックします。

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

    5. 変更履歴 タブをクリックして、以下のいずれかの方法で変更履歴を確認します。

      • 過去 30 日間 または 過去 7 日間 をクリックして、該当期間の変更を確認します。

      • 期間を指定して クエリ をクリックし、その期間内の変更レコードを確認します。

      image

    重要なパラメーター

    • ApsaraDB for ClickHouse コンソールでは、prometheus.port パラメーターの値は 2182 ～ 3000 の範囲内のポート番号に制限されています。

    • 一部のクラスターバージョンでは、text_log が有効になっていない、または text_log.level の値が低すぎる場合があります。テキストログを確認するには、要件に応じて text_log.level パラメーターを適切な値に設定してください。

      値

      説明

      ユースケース

      trace

      最も詳細なログレベルです。すべての操作およびイベントを記録します。

      開発およびデバッグ中のプログラム実行のトレース。

      debug

      開発中に役立つ詳細情報を含みますが、trace よりも冗長性が低いです。通常、関数呼び出しや変数の状態を記録します。

      プログラムのデバッグ。

      information

      サービスの開始やタスクの完了など、通常の操作およびステータスイベントを記録します。通常、システムが正常に動作しており、エラーがないことを示します。

      該なし

      warning

      潜在的な問題または致命的でないエラーを示します。システムは引き続き実行されますが、一部の条件に注意が必要です。

      システムの監視、潜在的な問題の分析、システムの最適化。

      error

      一部の機能または操作に影響を与えるエラーが発生したことを示します。システムはまだ実行される可能性がありますが、これらのエラーに対処する必要があります。

      システムの監視およびエラーの分析による問題のトラブルシューティング。