Grupos de parâmetros do Amazon Neptune

Gerencia a configuração de banco de dados no Amazon Neptune usando parâmetros em um grupo de parâmetros. Grupos de parâmetros atuam como contêineres de valores de configuração do mecanismo que são aplicados a uma ou mais instâncias de bancos de dados.

Há dois tipos de grupo de parâmetros: de cluster de banco de dados e de banco de dados.

• Os grupos de parâmetros de banco de dados aplicam-se à instância e geralmente estão associados às configurações do mecanismo de grafos do Neptune, como o parâmetro neptune_query_timeout.

• Os grupos de parâmetros de cluster de banco de dados aplicam-se a todas as instâncias no cluster e geralmente têm configurações mais amplas. Cada cluster do Neptune é associado a um grupo de parâmetros de cluster de banco de dados. Cada instância de banco de dados dentro desse cluster herda os valores de configuração do mecanismo contidos no grupo de parâmetros de cluster de banco de dados.

Quaisquer valores de configuração que você modificar no grupo de parâmetros de cluster de banco de dados substituirão os valores padrão no grupo de parâmetros de banco de dados. Se você editar os valores correspondentes no grupo de parâmetros de banco de dados, eles substituirão as configurações do grupo de parâmetros de cluster de banco de dados.

Um parameter group de banco de dados padrão será usado se você criar uma instância de banco de dados sem especificar um parameter group de banco de dados personalizado. Não é possível modificar as configurações de parâmetros de um grupo de parâmetros de banco de dados padrão. Em vez disso, para alterar as configurações de parâmetros padrão, é necessário criar um grupo de parâmetros de banco de dados. Nem todos os parâmetros de mecanismo de banco de dados podem ser alterados em um grupo de parâmetros de banco de dados criado por você.

Os grupos de parâmetros são criados em famílias compatíveis com diferentes versões do mecanismo do Neptune. A família de grupos de parâmetros padrão é neptune1, que é compatível com todas as versões do mecanismo anteriores a 1.2.0.0. A partir de Versão: 1.2.0.0 (21/07/2022), a família do grupo de parâmetros neptune1.2 deve ser usada em vez disso. Isso significa que, ao realizar a atualização para 1.2.0.0 ou posterior, você deve primeiro recriar todos os grupos de parâmetros personalizados na família neptune1.2 para poder anexá-los ao realizar a atualização.

Alguns parâmetros do Neptune são estáticos e outros são dinâmicos. As diferenças são as seguintes:

Parâmetros estáticos

• Parâmetro estático é aquele que tem efeito somente após a reinicialização de uma instância de banco de dados. Em outras palavras, ao alterar um parâmetro estático e salvar o grupo de parâmetros de banco de dados da instância, é necessário reinicializar manualmente a instância de banco de dados para a alteração de parâmetros ter efeito. No momento, todos os parâmetros em nível de instância do Neptune (em um grupo de parâmetros de banco de dados em vez de em um grupo de parâmetros de cluster de banco de dados) são estáticos.

• Quando você altera um parâmetro estático no cluster e salva o grupo de parâmetros de cluster de banco de dados, a alteração do parâmetro tem efeito depois que você reinicia manualmente cada instância de banco de dados no cluster.

Parâmetros dinâmicos

• Parâmetro dinâmico é aquele que tem efeito quase imediatamente após a atualização dele no grupo de parâmetros. Em outras palavras, não há necessidade de reinicializar uma instância de banco de dados depois de atualizar um parâmetro dinâmico para que a alteração tenha efeito.

• Espere um pequeno atraso para que a alteração de um parâmetro de cluster dinâmica seja aplicada a todas as instâncias de banco de dados.

• O valor de um parâmetro dinâmico atualizado não é aplicado às solicitações em execução no momento, mas somente às enviadas após a alteração.

• Ao alterar um parâmetro dinâmico em nível de cluster, por padrão, a alteração do parâmetro é aplicada ao cluster de banco de dados imediatamente, sem a necessidade de reinicialização. Para adiar a alteração do parâmetro para depois da inicialização das instâncias de banco de dados no cluster, é possível usar a AWS CLI para definir o ApplyMethod como pending-reboot para a alteração de parâmetro.

No momento, todos os parâmetros são estáticos, exceto os seguintes novos parâmetros de cluster:

• neptune_enable_slow_query_log   (em nível de cluster)

• neptune_slow_query_log_threshold   (em nível de cluster)

Veja a seguir estão alguns pontos importantes que você deve saber sobre como trabalhar com parâmetros em um parameter group de banco de dados:

• Definir incorretamente os parâmetros em um parameter group de banco de dados pode causar efeitos adversos não intencionais, inclusive diminuição da performance e instabilidade no sistema. Sempre tenha cuidado ao modificar parâmetros de bancos de dados e faça backup dos dados antes de modificar um parameter group de banco de dados. Teste as alterações da configuração do parameter group em uma instância de banco de dados de teste antes de aplicar essas alterações a uma instância de banco de dados de produção.

• Ao alterar o parameter group de banco de dados associado a uma instância de banco de dados, você deve reinicializar manualmente a instância antes que o novo parameter group de banco de dados seja usado pela instância de banco de dados.

  nota

  Antes de Versão: 1.2.0.0 (21/07/2022), todas as instâncias de réplica de leitura em um cluster de banco de dados eram reinicializadas automaticamente quando a instância (de gravador) principal era reiniciada.

  De Versão: 1.2.0.0 (21/07/2022) em diante, reiniciar a instância principal não faz com que nenhuma das instâncias de réplica seja reiniciada. Isso significa que, se você estiver alterando um parâmetro em nível de cluster, deverá reiniciar cada instância separadamente para receber a alteração do parâmetro.

Edição de um grupo de parâmetros de cluster de banco de dados ou de um grupo de parâmetros de banco de dados

1. Faça login no Console de Gerenciamento da AWS e abra o console do Amazon Neptune em https://console.aws.amazon.com/neptune/home.

2. Selecione Parameter groups no painel de navegação.

3. Selecione o link Name (Nome) para o parameter group de banco de dados que você deseja editar.

   (Opcional) Selecione Create parameter group (Criar parameter group) para criar um novo parameter group de cluster e crie o novo grupo. Em seguida, selecione o Name (Nome) do novo parameter group.

   Importante

   Essa etapa será necessária se você tiver apenas o parameter group padrão de cluster de banco de dados porque o parameter group padrão de cluster de banco de dados não pode ser modificado.

4. Pesquise o parâmetro e clique no campo Valor ao lado da coluna Nome.

5. Insira o valor permitido e escolha a marca ao lado do campo de valor.

6. Escolha Salvar alterações.

7. Reinicialize cada instância de banco de dados no cluster do Neptune se você estiver alterando um parâmetro de cluster de banco de dados, ou uma ou mais instâncias específicas se estiver alterando um parâmetro de instância de banco de dados.

Criar um grupo de parâmetros de banco de dados ou um grupo de parâmetros de cluster de banco de dados

É possível usar com facilidade o console do Neptune para criar um grupo de parâmetros:

1. Faça login no Console de Gerenciamento da AWS e abra o console do Amazon Neptune em https://console.aws.amazon.com/neptune/home.

2. Escolha Parameter Groups no painel de navegação à esquerda.

3. Escolha Create parameter group de banco de dados (Criar parameter group de banco de dados).

   A página Create parameter group de banco de dados (Criar parameter group de banco de dados) é exibida.

4. Na lista Família de grupos de parâmetros, escolha neptune1 ou, se você estiver visando a versão 1.2.0.0 ou posterior do mecanismo, escolha neptune1.2.

5. Na lista Type (Tipo), escolha DB Parameter Group (Parameter group de banco de dados) ou DB Cluster Parameter Group (Parameter group de cluster de banco de dados).

6. Digite o nome do novo parameter group de banco de dados na caixa Group name (Nome do grupo).

7. Digite uma descrição para o novo parameter group de banco de dados na caixa Description (Descrição).

8. Escolha Criar.

Também é possível criar um grupo de parâmetros usando AWS CLI:

aws neptune create-db-parameter-group \
  --db-parameter-group-name (a name for the new DB parameter group) \
  --db-parameter-group-family (either neptune1 or neptune1.2, depending on the engine version) \
  --description (a description for the new DB parameter group)