Todos los productos
Search

Este producto

    ApsaraDB for ClickHouse:Configurar parámetros de config.xml

    Centro de documentos

    ApsaraDB for ClickHouse:Configurar parámetros de config.xml

    Última actualización: Sep 05, 2026

    Modifique los parámetros globales en el archivo config.xml de un clúster de ApsaraDB for ClickHouse para optimizar el rendimiento de la instancia.

    Contexto

    Un clúster de ApsaraDB for ClickHouse utiliza valores de parámetros predeterminados configurados en config.xml y user.xml. Puede modificar estos parámetros para optimizar su instancia:

    • Archivo de configuración user.xml: modifique los parámetros mediante la ejecución del comando SET GLOBAL. Los cambios surten efecto de inmediato sin necesidad de reiniciar. Para obtener más información, consulte Modify user.xml parameters.

    • Archivo de configuración config.xml: modifique los parámetros desde la consola.

    Notas de uso

    • En los clústeres Community-Compatible Edition, solo puede configurar parámetros en XML Mode y consultar el historial de cambios si el clúster se creó después del 1 de diciembre de 2021.

    • Los clústeres Enterprise Edition no admiten la configuración de parámetros en XML Mode.

    • XML Mode no permite eliminar parámetros. Los parámetros configurables en XML Mode son los mismos que en Default Mode.

    • Si modifica parámetros que requieren un reinicio para surtir efecto, el clúster se reiniciará automáticamente al finalizar las modificaciones. Antes de enviar los parámetros, asegúrese de que el reinicio no afecte a sus operaciones.

    Impactos en el clúster

    • Si el clúster se encuentra en estado Changing Configurations o Restarting, solo podrá consultar su información. No será posible realizar operaciones como actualizaciones de tipo de instancia, expansiones o reducciones de escala.

    • Si modifica parámetros que requieren un reinicio para surtir efecto, el clúster se reiniciará automáticamente al finalizar las modificaciones. Realice esta operación fuera de horas pico para evitar interrupciones en el servicio.

    Modificar parámetros

    El procedimiento para modificar parámetros varía según la edición del clúster.

    Importante

    Si necesita modificar los parámetros prometheus.port o text_log, consulte Important parameters.

    Enterprise edition

    1. Inicie sesión en la consola de ApsaraDB for ClickHouse.

    2. En la esquina superior izquierda de la página, seleccione la región del clúster de destino.

    3. En la página Clusters, haga clic en la pestaña Enterprise Edition Clusters y luego haga clic en el ID del clúster de destino.

    4. En el panel de navegación izquierdo, haga clic en Parameter Management.

    5. En la columna Parameter Value, haga clic en el icono de modificación 参数编辑按钮 para editar el valor. Introduzca un valor dentro del rango válido y luego haga clic en OK.

    6. Después de modificar los parámetros deseados, haga clic en Submit Parameters en la esquina superior derecha de la página.

    7. En el cuadro de diálogo Save Settings, revise los valores de los parámetros antes y después del cambio, confirme las modificaciones, proporcione un motivo para el cambio y luego haga clic en OK.

      Importante

      Si envía parámetros que requieren un reinicio para surtir efecto, el clúster de ClickHouse se reiniciará automáticamente al finalizar las modificaciones. Antes de continuar, asegúrese de que el reinicio no afecte a sus operaciones.

      Después de enviar los parámetros, el sistema valida los valores. Si algún valor no es válido, aparecerá un mensaje de error. El código de error 102 indica que el valor introducido no es válido. Regrese al paso anterior, introduzca un valor dentro del rango válido y vuelva a enviar los parámetros.

    Community-compatible edition

    1. Inicie sesión en la consola de ApsaraDB for ClickHouse.

    2. En la esquina superior izquierda de la página, seleccione la región del clúster de destino.

    3. En la página Clusters, haga clic en la pestaña Clusters of Community-compatible Edition y luego haga clic en el ID del clúster de destino.

    4. En el panel de navegación izquierdo, haga clic en Parameter Configuration.

    5. Haga clic en la pestaña Settings. Seleccione Default Mode o XML Mode para modificar los parámetros.

      Importante

      En la consola de ApsaraDB for ClickHouse, el valor del parámetro prometheus.port debe estar en el rango de 2182 a 3000.

      • Default Mode: en la columna Parameter Value, haga clic en el icono de modificación 参数编辑按钮 para entrar en modo de edición. Introduzca un valor dentro del rango válido y luego haga clic en OK.

      • XML Mode: en la esquina superior derecha de la página, haga clic en Modify para modificar los parámetros deseados en el archivo.

    6. Después de modificar los parámetros deseados, haga clic en Submit Parameters en la esquina superior derecha de la página.

    7. En el cuadro de diálogo Save Settings, revise los valores de los parámetros antes y después del cambio, confirme las modificaciones, proporcione un motivo para el cambio y luego haga clic en Submit Parameters.

      Importante

      • Si envía parámetros que requieren un reinicio para surtir efecto, el clúster de ClickHouse se reiniciará automáticamente al finalizar las modificaciones. Antes de continuar, asegúrese de que el reinicio no afecte a sus operaciones.

      • En XML Mode, si un valor de parámetro no es válido, aparecerá un mensaje de error. El código de error 102 indica que el valor introducido no es válido. Regrese al paso anterior, introduzca un valor dentro del rango válido y vuelva a enviar los parámetros.

    Revertir modificaciones

    Nota

    • Solo puede revertir modificaciones que no se hayan enviado.

    • Para los clústeres Enterprise Edition y para los clústeres Community-Compatible Edition en XML Mode, solo puede revertir todas las modificaciones de parámetros a la vez.

    Para revertir modificaciones no enviadas, realice una de las siguientes operaciones:

    • Revertir la modificación de un solo parámetro: haga clic en el icono 撤销图标 junto al valor del parámetro. ApsaraDB for ClickHouse revertirá la modificación no enviada de ese parámetro a su valor anterior.

    • Revertir todas las modificaciones de parámetros: haga clic en Cancel en la esquina superior derecha de la lista de parámetros. ApsaraDB for ClickHouse revertirá todos los cambios no enviados a sus valores anteriores.

    Consultar historial de cambios

    Enterprise edition

    1. Inicie sesión en la consola de ApsaraDB for ClickHouse.

    2. En la esquina superior izquierda de la página, seleccione la región del clúster de destino.

    3. En la página Clusters, haga clic en la pestaña Enterprise Edition Clusters y luego haga clic en el ID del clúster de destino.

    4. En el panel de navegación izquierdo, haga clic en Parameter Management.

    5. Haga clic en la pestaña Change History para consultar el historial de cambios de una de las siguientes maneras:

      • Haga clic en Last 30 Days o Last 7 Days para ver los cambios del periodo correspondiente.

      • Especifique un rango de tiempo para consultar los registros de modificación dentro de ese periodo.

    Community-compatible edition

    1. Inicie sesión en la consola de ApsaraDB for ClickHouse.

    2. En la esquina superior izquierda de la página, seleccione la región del clúster de destino.

    3. En la página Clusters, haga clic en la pestaña Clusters of Community-compatible Edition y luego haga clic en el ID del clúster de destino.

    4. En el panel de navegación izquierdo, haga clic en Parameter Configuration.

    5. Haga clic en la pestaña Change History para consultar el historial de cambios de una de las siguientes maneras:

      • Haga clic en Last 30 Days o Last 7 Days para ver los cambios del periodo correspondiente.

      • Especifique un rango de tiempo y haga clic en Query para consultar los registros de modificación dentro de ese periodo.

      image

    Parámetros importantes

    • En la consola de ApsaraDB for ClickHouse, el valor del parámetro prometheus.port está restringido a un número de puerto en el rango de 2182 a 3000.

    • En algunas versiones del clúster, text_log no está habilitado o el valor de text_log.level es demasiado bajo. Para consultar los registros de texto, establezca el parámetro text_log.level en un valor adecuado según sus necesidades:

      Valor

      Descripción

      Casos de uso

      trace

      Nivel de registro más detallado. Registra todas las operaciones y eventos.

      Rastreo de la ejecución del programa durante el desarrollo y la depuración.

      debug

      Incluye información detallada útil durante el desarrollo, pero menos verbosa que trace. Por lo general, registra llamadas a funciones y estados de variables.

      Depuración de un programa.

      information

      Registra operaciones normales y eventos de estado, como el inicio de un servicio o la finalización de una tarea. Suele indicar que el sistema funciona con normalidad y sin errores.

      N/A

      warning

      Indica problemas potenciales o errores no fatales. El sistema continúa ejecutándose, pero algunas condiciones pueden requerir atención.

      Monitoreo del sistema, análisis de problemas potenciales y optimización del sistema.

      error

      Indica que el sistema encontró errores que afectan a ciertas funciones u operaciones. Es posible que el sistema siga ejecutándose, pero debe solucionar estos errores.

      Monitoreo del sistema y análisis de errores para resolver problemas.