Grupos de parámetros de Amazon Redshift

Información general

En Amazon Redshift, puede asociar un grupo de parámetros con cada clúster que cree. Un grupo de parámetros es un grupo de parámetros que se aplican a todas las bases de datos que crea en el clúster. Estos parámetros establecen la configuración de la base de datos, como el tiempo de espera de consulta y el estilo de fecha.

Acerca de los grupos de parámetros

Cada grupo de parámetros tiene varios parámetros para la configuración de ajustes de la base de datos. La lista de parámetros disponibles depende de la familia de grupos de parámetros a la que el grupo de parámetros pertenece. La familia de grupos de parámetros es la versión del motor de Amazon Redshift a la que se aplican los parámetros del grupo de parámetros. El formato del nombre de la familia de grupos de parámetros es redshift-version, donde version es la versión del motor. Por ejemplo, la versión actual del motor es redshift-1.0.

Amazon Redshift proporciona un grupo de parámetros predeterminado para cada familia de grupos de parámetros. El grupo de parámetros predeterminado tiene valores preestablecidos para cada uno de sus parámetros y no pueden modificarse. El formato del nombre del grupo de parámetros predeterminado es default.parameter_group_family, donde parameter_group_family es la versión del motor al que pertenece el grupo de parámetros. Por ejemplo, el grupo de parámetros predeterminado para la versión redshift-1.0 se llama default.redshift-1.0.

nota

En este momento, redshift-1.0 es la única versión del motor de Amazon Redshift. Por lo tanto, default.redshift-1.0 es el único grupo de parámetros predeterminado.

Si desea utilizar valores de parámetros diferentes a los del grupo de parámetros predeterminado, debe crear un grupo de parámetros personalizado y luego asociar el clúster a él. Inicialmente, los valores de los parámetros de un grupo de parámetros personalizado son los mismos que los de un grupo de parámetros predeterminado. El source inicial para todos los parámetros es engine-default, ya que los valores los establece previamente Amazon Redshift. Luego de cambiar un valor de parámetro, el source cambia a user para indicar que su valor predeterminado se ha modificado.

nota

La consola de Amazon Redshift no muestra el source de cada parámetro. Debe utilizar la API de Amazon Redshift, la AWS CLI o uno de los AWS SDK para ver el source.

Si se trata de grupos de parámetros creados por usted, puede modificar el valor de parámetro en cualquier momento o puede restablecer los valores de parámetros a sus valores predeterminados. También puede asociar un grupo de parámetros diferente a un clúster. En algunos casos, podrá modificar los valores del parámetro en un grupo de parámetros que ya está asociado a un clúster o asociar un grupo de parámetros diferentes a un clúster. En estos casos, quizás tenga que reiciar el clúster para que se aplique los valores de los parámetros actualizados. Si el clúster falla y Amazon Redshift lo reinicia, los cambios se aplican en ese momento. Si el clúster se reinicia durante el mantenimiento, no se aplican los cambios. Para obtener más información, consulte Propiedades dinámicas y estáticas de WLM.

Valores de parámetros predeterminados

En la siguiente tabla se muestran los valores de parámetros predeterminados junto con enlaces a información más exhaustiva acerca de cada parámetro. Estos son los valores predeterminados para la familia de grupos de parámetros redshift-1.0.

Nombre del parámetro	Valor	Más información
auto_analyze	true	auto_analyze en la Guía para desarrolladores de bases de datos de Amazon Redshift
auto_mv	true	Vistas materializadas automatizadas en la Guía para desarrolladores de bases de datos de Amazon Redshift
datestyle	ISO, MDY	datestyle en laGuía para desarrolladores de bases de datos de Amazon Redshift
enable_case_sensitive_identifier	false	enable_case_sensitive_identifier en laGuía para desarrolladores de bases de datos de Amazon Redshift
enable_user_activity_logging	false	Registro de auditoría de bases de datos en esta guía
extra_float_digits	0	extra_float_digits en la Guía para desarrolladores de bases de datos de Amazon Redshift
max_concurrency_scaling_clusters	1	max_concurrency_scaling_clusters en la Guía para desarrolladores de bases de datos Amazon Redshift
query_group	predeterminada	query_group en la Guía para desarrolladores de bases de datos de Amazon Redshift
require_ssl	false	Configuración de las opciones de seguridad para las conexiones en esta guía
search_path	$user, public	search_path en la Guía para desarrolladores de bases de datos de Amazon Redshift
statement_timeout	0	statement_timeout en la Guía para desarrolladores de bases de datos Amazon Redshift
wlm_json_configuration	[{"auto_wlm":true}]	Configuración de la administración de cargas de trabajo en esta guía
use_fips_ssl	false	Habilite el modo SSL compatible con FIPS solo si el sistema debe ser compatible con FIPS.

nota

El parámetro max_cursor_result_set_size no está disponible. Para obtener más información acerca del tamaño de conjuntos de resultados de cursores, consulte Restricciones del cursor en la Guía para desarrolladores de bases de datos Amazon Redshift.

Puede anular un parámetro temporalmente utilizando el comando SET en la base de datos. El comando SET anula el parámetro solamente durante el tiempo de la sesión actual. Además de los parámetros mencionados en la tabla anterior, también puede ajustar de manera temporal el número de slots estableciendo wlm_query_slot_count en la base de datos. El parámetro wlm_query_slot_count no está disponible para su configuración en grupos de parámetros. Para obtener más información acerca del ajuste del número de slots, consultewlm_query_slot_count en la Guía para desarrolladores de bases de datos de Amazon Redshift. Para obtener más información acerca de la anulación temporal de otros parámetros, consulte Modificación de la configuración del servidor en la Guía para desarrolladores de bases de datos de Amazon Redshift.

Configuración de los valores de parámetros mediante la AWS CLI

Si desea configurar los parámetros de Amazon Redshift con la AWS CLI, utilice el comando modify-cluster-parameter-group en un grupo de parámetros específico. Especifique el grupo de parámetros a modificar en parameter-group-name. Utilice el parámetro parameters (para el comando modify-cluster-parameter-group) para especificar los pares de nombre/valor de cada parámetro que desea modificar en el grupo de parámetros.

nota

Existen consideraciones especiales cuando se configura el parámetro wlm_json_configuration mediante la AWS CLI. Los ejemplos de esta sección aplican a todos los parámetros, excepto wlm_json_configuration. Para obtener más información acerca de la configuración de wlm_json_configuration mediante la AWS CLI, consulte Configuración de la administración de cargas de trabajo.

Luego de modificar los valores de parámetros, debe reiniciar cualquier clúster que esté asociado al grupo de parámetros modificado. El estado del clúster muestra applying para el ParameterApplyStatus durante la aplicación de los valores y pending-reboot después de que se han aplicado los valores. Luego de reiniciar, la base de datos del clúster comienza a utilizar los nuevos valores de parámetros. Para obtener más información acerca del reinicio de clústeres, consulte Reinicio de un clúster.

nota

El parámetro wlm_json_configuration contiene algunas propiedades que son dinámicas y no requieren el reinicio de los clústeres asociados para que se apliquen los cambios. Para obtener más información acerca de las propiedades dinámicas y estáticas, consulte Propiedades dinámicas y estáticas de WLM.

Sintaxis

La siguiente sintaxis muestra cómo utilizar el comando modify-cluster-parameter-group para configurar un parámetro. Especifique parameter_group_name y reemplace parameter_name y parameter_value por un parámetro real que desee modificar y un valor para ese parámetro. Si desea modificar más de un parámetro al mismo tiempo, separe con un espacio cada parámetro y valor establecido del siguiente.

aws redshift modify-cluster-parameter-group --parameter-group-name parameter_group_name --parameters ParameterName=parameter_name,ParameterValue=parameter_value

Ejemplo

En el siguiente ejemplo, se muestra cómo configurar los parámetros statement_timeout y enable_user_activity_logging para el grupo de parámetros myclusterparametergroup.

nota

Por fines de legibilidad, el ejemplo se muestra en varias líneas pero, en la AWS CLI real, se ve en una línea.

aws redshift modify-cluster-parameter-group 
--parameter-group-name myclusterparametergroup 
--parameters ParameterName=statement_timeout,ParameterValue=20000 ParameterName=enable_user_activity_logging,ParameterValue=true

Puede administrar grupos de parámetros mediante la consola. Para obtener más información, consulte Administración de grupos de parámetros mediante la consola.