Grupos de parâmetros do Amazon Redshift

Visão geral

No Amazon Redshift, você associa um grupo de parâmetros a cada cluster que você cria. Um grupo de parâmetros é um grupo de parâmetros que se aplicam a todos os bancos de dados que você cria no cluster. Esses parâmetros definem as configurações do banco de dados, como tempo limite de consulta e estilo de data.

Sobre grupos de parâmetros

Cada parameter group tem vários parâmetros para definir configurações do banco de dados. A lista de parâmetros disponíveis depende da família do parameter group à qual o parameter group pertence. A família do grupo de parâmetros é a versão do mecanismo Amazon Redshift ao qual os parâmetros do grupo de parâmetros se aplicam. O formato do nome da família do grupo de parâmetros é redshift-version em que version é a versão do mecanismo. Por exemplo, a versão atual do mecanismo é redshift-1.0.

O Amazon Redshift fornece um grupo de parâmetros padrão para cada família de grupo de parâmetros. O parameter group padrão tem valores predefinidos para cada um dos parâmetros e não pode ser modificado. O formato do nome do parameter group padrão é default.parameter_group_family, em que parameter_group_family é a versão do mecanismo a que o parameter group pertence. Por exemplo, o parameter group padrão da versão redshift-1.0 se chama default.redshift-1.0.

nota

No momento, redshift-1.0 é a única versão do mecanismo Amazon Redshift. Consequentemente, default.redshift-1.0 é o único parameter group padrão.

Se quiser usar valores de parâmetro diferentes do parameter group padrão, você deverá criar um parameter group personalizado e associar o cluster a ele. Inicialmente, os valores de parâmetro em um parameter group personalizado são os mesmos do parameter group padrão. A source inicial para todos os parâmetros é engine-default porque os valores são predefinidos pelo Amazon Redshift. Depois que você alterar um valor de parâmetro, o source mudará para user a fim de indicar que o valor foi modificado em relação ao valor padrão.

nota

O console do Amazon Redshift não exibe a source de cada parâmetro. É necessário usar a API do Amazon Redshift, a AWS CLI ou uma das AWS SDKs para visualizar a source.

Para grupos de parâmetros criados, você pode modificar um valor de parâmetro a qualquer momento, ou pode restaurar os padrões de todos os valores de parâmetro. Você também pode associar um grupo de parâmetros diferente a um cluster. Em alguns casos, poderá modificar valores de parâmetro em um grupo de parâmetros que já está associado a um cluster ou associar um grupo de parâmetros diferente a um cluster. Nesses casos, poderá ser necessário reiniciar o cluster para que os valores de parâmetro atualizados entrem em vigor. Se o cluster falhar e for reiniciado pelo Amazon Redshift, suas alterações serão aplicadas naquele momento. As alterações não serão aplicadas se o cluster for reiniciado durante a manutenção. Para ter mais informações, consulte Propriedades dinâmicas e estáticas do WLM.

Valores de parâmetro padrão

A tabela a seguir mostra resumidamente os valores de parâmetro padrão com links para informações mais aprofundadas sobre cada parâmetro. Esses são os valores padrão da família de grupos de parâmetros redshift-1.0.

Nome do parâmetro	Valor	Mais informações
auto_analyze	verdadeiro	auto_analyze no Guia do desenvolvedor de banco de dados do Amazon Redshift
auto_mv	verdadeiro	Visualizações materializadas automatizadas no Guia do desenvolvedor do banco de dados do Amazon Redshift
datestyle	ISO, MDY	datestyle no Guia do desenvolvedor de banco de dados do Amazon Redshift
enable_case_sensitive_identifier	false	enable_case_sensitive_identifier no Guia do desenvolvedor de banco de dados do Amazon Redshift
enable_user_activity_logging	false	Registro em log da auditoria de banco de dados neste guia
extra_float_digits	0	extra_float_digits no Guia do desenvolvedor de banco de dados do Amazon Redshift
max_concurrency_scaling_clusters	1	max_concurrency_scaling_clusters no Guia do desenvolvedor de banco de dados do Amazon Redshift
query_group	default	query_group no Guia do desenvolvedor de banco de dados do Amazon Redshift
require_ssl	false	Configurar as opções de segurança para conexões neste guia
search_path	$user, public	search_path no Guia do desenvolvedor de banco de dados do Amazon Redshift
statement_timeout	0	statement_timeout no Guia do desenvolvedor de banco de dados do Amazon Redshift
wlm_json_configuration	[{"auto_wlm":true}]	Configurar o gerenciamento do workload neste guia
use_fips_ssl	false	Habilite o modo SSL compatível com FIPS somente se o sistema precisar ser compatível com FIPS.

nota

O parâmetro max_cursor_result_set_size está obsoleto. Para obter mais informações sobre o tamanho do conjunto de resultados do cursor, consulte Restrições de cursor no Guia do desenvolvedor de banco de dados do Amazon Redshift.

Você pode substituir temporariamente um parâmetro usando o comando SET no banco de dados. O comando SET substitui somente o parâmetro da duração da sessão atual. Além dos parâmetros listados na tabela anterior, você também pode ajustar temporariamente a contagem de slots definindo wlm_query_slot_count no banco de dados. O parâmetro wlm_query_slot_count não está disponível para configuração em grupos de parâmetros. Para obter mais informações sobre como ajustar a contagem de slots, consulte wlm_query_slot_count no Guia do desenvolvedor de banco de dados do Amazon Redshift. Para obter mais informações sobre como substituir temporariamente outros parâmetros, consulte Modificar a configuração do servidor no Guia do desenvolvedor de banco de dados do Amazon Redshift.

Configurar valores de parâmetro usando a AWS CLI

Para configurar parâmetros do Amazon Redshift usando a AWS CLI, você usa o comando modify-cluster-parameter-group para um grupo de parâmetros específico. Você especifica o parameter group a ser modificado em parameter-group-name. Você usa o parâmetro parameters (do comando modify-cluster-parameter-group) a fim de especificar pares de nome/valor para cada parâmetro que deseja modificar no parameter group.

nota

Existem considerações especiais durante a configuração do parâmetro wlm_json_configuration usando a AWS CLI. Os exemplos nesta seção se aplicam a todos os parâmetros, exceto wlm_json_configuration. Para obter mais informações sobre como configurar o wlm_json_configuration usando a AWS CLI, consulte Configurar o gerenciamento do workload.

Depois de modificar valores de parâmetro, você deverá reinicializar todos os clusters que estejam associados ao parameter group modificado. O status do cluster exibe applying para ParameterApplyStatus enquanto os valores são aplicados e pending-reboot depois que os valores tiverem sido aplicados. Depois de reinicializar, os bancos de dados no cluster começarão a usar os novos valores de parâmetro. Para obter mais informações sobre como reiniciar clusters, consulte Reinicialização de um cluster.

nota

O parâmetro wlm_json_configuration contém algumas propriedades dinâmicas e não exigem que você reinicie clusters associados para que as alterações sejam aplicadas. Para obter mais informações sobre propriedades dinâmicas e estáticas, consulte Propriedades dinâmicas e estáticas do WLM.

Sintaxe

A sintaxe a seguir mostra como usar o comando modify-cluster-parameter-group para configurar um parâmetro. Você especifica parameter_group_name e substitui parameter_name e parameter_value por um parâmetro real a ser modificado e um valor para esse parâmetro. Se você quiser modificar mais de um parâmetro simultaneamente, separe cada conjunto de parâmetros e valores do seguinte com um espaço.

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

Exemplo

O exemplo a seguir mostra como configurar os parâmetros statement_timeout e enable_user_activity_logging do parameter group myclusterparametergroup.

nota

Para fins de legibilidade, o exemplo é exibido em várias linhas, mas, na AWS CLI real, tem uma linha.

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

Você pode gerenciar grupos de parâmetros usando o console. Para ter mais informações, consulte Gerenciamento de grupos de parâmetros usando o console.