Usar modelos de parâmetros - ApsaraDB RDS: Central de Documentação do Alibaba Cloud

Pré-requisitos

A instância do ApsaraDB RDS for PostgreSQL usa discos cloud.

Informações básicas

O ApsaraDB RDS for PostgreSQL oferece os seguintes tipos de modelos de parâmetros:

Modelo de parâmetro do sistema: modelo de parâmetro padrão usado ao criar uma instância do ApsaraDB RDS for PostgreSQL.
Modelo de parâmetro personalizado: após criar uma instância, crie um modelo de parâmetro personalizado com base nos requisitos do seu negócio e aplique-o a uma ou mais instâncias do ApsaraDB RDS for PostgreSQL para substituir o modelo de parâmetro do sistema.

Nota

Para modificar um parâmetro de uma única instância, consulte Modify the parameters of an ApsaraDB RDS for PostgreSQL instance.

Criar um modelo de parâmetro personalizado

Criar um modelo de parâmetro manualmente

Acesse o ApsaraDB RDS console. No painel de navegação à esquerda, clique em Parameter Templates. Na barra de navegação superior, selecione uma região.
Clique em Create Parameter Template.

Configure os seguintes parâmetros.

Parameter	Description
Template Name	O nome do modelo. O nome deve ter entre 8 e 64 caracteres, começar com uma letra e conter apenas letras, dígitos, pontos (.) e sublinhados (_). Caracteres chineses não são permitidos.
Database Engine	Selecione PostgreSQL.
Engine Version	Selecione uma versão do banco de dados.
Description	Insira uma descrição para o modelo, com até 200 caracteres.
Add Parameter	Clique em Add Parameter para adicionar uma linha onde você pode selecionar um Parameter Name e definir seu valor. Você também pode visualizar informações como a faixa de valores válidos e o valor padrão. Nota Para obter uma lista de parâmetros disponíveis, consulte a aba Editable Parameters na página Parameters da sua instância. Para configurar outro parâmetro, clique novamente em Add Parameter. Para remover um parâmetro, clique em Delete à direita do parâmetro.
Import	Após modificar um modelo exportado, você pode clicar em Import e colar os parâmetros para criar um modelo. Para obter mais informações sobre como exportar um modelo, consulte Modify the parameters of an ApsaraDB RDS for PostgreSQL instance.

Clique em Confirm.

Aplicar um modelo de parâmetro

Aplicar um modelo de parâmetro durante a criação da instância

Ao criar uma instância que usa discos cloud, você pode aplicar um modelo de parâmetro. Para obter mais informações sobre como criar uma instância, consulte Create an ApsaraDB RDS for PostgreSQL instance.

Selecione um modelo de parâmetro do sistema: o ApsaraDB RDS for PostgreSQL fornece um modelo de parâmetro padrão. A convenção de nomenclatura é PostgreSQL_<Major version number>_<Edition>_default parameter template, por exemplo, PostgreSQL_14.0_High-availability Edition_default parameter template. Para visualizar as configurações de parâmetros de um modelo de parâmetro do sistema, consulte View a parameter template.
Selecione um modelo de parâmetro personalizado: você pode criar antecipadamente um modelo de parâmetro personalizado ou clicar no link create a custom parameter template na seção Parameter Templates para acessar a página de criação. Para obter mais informações sobre como criar um modelo de parâmetro personalizado, consulte Create a custom parameter template.

Nota

Não é possível modificar modelos de parâmetros do sistema.

Aplicar um modelo de parâmetro a várias instâncias

Aviso

Antes de aplicar um modelo de parâmetro, verifique se seus parâmetros são adequados para todas as instâncias de destino.
Algumas modificações de parâmetros reiniciam imediatamente a instância ao serem aplicadas. Para obter mais informações, consulte a coluna Restart Required? no modelo de parâmetro. Um reinício da instância interrompe conexões ativas, portanto, planeje essa interrupção com antecedência.

Acesse o ApsaraDB RDS console. No painel de navegação à esquerda, clique em Parameter Templates. Na barra de navegação superior, selecione uma região.
Na aba Custom Parameter Templates ou System Parameter Templates, localize o modelo que deseja aplicar e clique em Apply to Instance na coluna Actions.

Nota
Se você aplicar vários modelos a uma instância em sequência, o último modelo aplicado substitui os parâmetros dos anteriores.
Na lista de instâncias à esquerda, selecione as instâncias de destino. Clique em para mover as instâncias para a direita. Revise a seção Parameter Comparison para verificar as alterações.
Clique em OK.

Aplicar um modelo de parâmetro a uma única instância

Aviso

Algumas modificações de parâmetros reiniciam imediatamente a instância ao serem aplicadas. Para obter mais informações, consulte a descrição de Restart Required? na caixa de diálogo de confirmação Apply Template. Um reinício da instância interrompe conexões ativas, portanto, planeje essa interrupção com antecedência.

Acesse a página Instances. Na barra de navegação superior, selecione a região onde a instância RDS está localizada. Em seguida, localize a instância RDS e clique no ID da instância.
No painel de navegação à esquerda, clique em Parameters.
Na aba Editable Parameters, clique em Apply Template.
Selecione o Template Name do modelo que deseja aplicar.

Nota
Você pode acessar o ApsaraDB RDS console, clicar em Parameter Templates no painel de navegação à esquerda e, em seguida, selecionar uma região para visualizar os modelos criados.
Clique em OK para aplicar o modelo.

Gerenciar modelos de parâmetros

Clonar um modelo de parâmetro personalizado

Você pode clonar um modelo de parâmetro personalizado para copiá-lo para outra região ou criar um novo modelo com base em um existente.

Nota

É possível clonar modelos de parâmetros personalizados. Não é possível clonar modelos de parâmetros do sistema.

Acesse o ApsaraDB RDS console. No painel de navegação à esquerda, clique em Parameter Templates. Na barra de navegação superior, selecione uma região.
Na lista de modelos de parâmetros personalizados, localize o modelo que deseja clonar. Na coluna Actions, clique em e selecione Clone.

Configure os seguintes parâmetros.

Parameter	Description
Region	A região de destino para a qual você deseja clonar o modelo.
Template Name	O nome do modelo. O nome deve ter entre 8 e 64 caracteres, começar com uma letra e conter apenas letras, dígitos, pontos (.) e sublinhados (_). Caracteres chineses não são permitidos.
Description	Insira uma descrição para o modelo, com até 200 caracteres.

Clique em OK.

Visualizar um modelo de parâmetro

Acesse o ApsaraDB RDS console. No painel de navegação à esquerda, clique em Parameter Templates. Na barra de navegação superior, selecione uma região.
Na aba Custom Parameter Templates ou System Parameter Templates, clique no ID do modelo de parâmetro desejado para visualizar suas configurações.

Modificar um modelo de parâmetro

Você pode modificar um modelo de parâmetro personalizado que criou.

Aviso

Após modificar um modelo de parâmetro personalizado, você deve reaplicá-lo para que as alterações tenham efeito. Se um parâmetro modificado exigir o reinício da instância, ela será reiniciada, interrompendo conexões ativas. Planeje essa interrupção com antecedência.

Acesse o ApsaraDB RDS console. No painel de navegação à esquerda, clique em Parameter Templates. Na barra de navegação superior, selecione uma região.
Localize o modelo de parâmetro personalizado desejado. Na coluna Actions, clique em e selecione Modify.
Após concluir as modificações, clique em OK.

Excluir um modelo de parâmetro

Você pode excluir um modelo de parâmetro personalizado que criou.

Acesse o ApsaraDB RDS console. No painel de navegação à esquerda, clique em Parameter Templates. Na barra de navegação superior, selecione uma região.
Localize o modelo de parâmetro personalizado desejado. Na coluna Actions, clique em e selecione Delete.
Na caixa de diálogo de confirmação exibida, clique em OK.

Nota
Não é possível excluir um modelo de parâmetro personalizado se ele estiver aplicado a uma ou mais instâncias.

Por exemplo, se custom_template_1 estiver aplicado a instance_A e instance_B, não será possível excluir custom_template_1. Para excluir o modelo, você deve primeiro aplicar um modelo diferente a instance_A e instance_B.

APIs relacionadas

API	Description
CreateParameterGroup	Cria um modelo de parâmetro.
ModifyParameterGroup	Modifica um modelo de parâmetro.
CloneParameterGroup	Clona um modelo de parâmetro para a região atual ou para outra região.
DescribeParameterGroups	Consulta uma lista de modelos de parâmetros em uma região específica.
DescribeParameterGroup	Consulta os detalhes de um modelo de parâmetro específico.
DeleteParameterGroup	Exclui um modelo de parâmetro.

Perguntas frequentes

P: Como redefino um parâmetro em um modelo de parâmetro personalizado para seu valor padrão?

R:

No modelo de parâmetro personalizado, localize o parâmetro desejado e altere seu valor para o valor padrão. Para obter mais informações, consulte Modify a parameter template.
Reaplique o modelo de parâmetro à instância de destino. Para obter mais informações, consulte Apply a parameter template.