As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Gerenciar instâncias do Amazon Neptune
As seções a seguir têm informações sobre operações no nível da instância.
**Topics**
+ [Classe de instância de intermitência T3 do Neptune.](manage-console-instances-t3.md)
+ [Modificar uma instância de banco de dados do Neptune (e aplicar imediatamente)](manage-console-instances-modify.md)
+ [Renomear uma instância de banco de dados do Neptune](manage-console-instances-rename.md)
+ [Reinicializar uma instância de banco de dados no Amazon Neptune](manage-console-instances-reboot.md)
+ [Excluir uma instância de banco de dados no Amazon Neptune](manage-console-instances-delete.md)
# Classe de instância de intermitência T3 do Neptune.
Além das classes de instância de desempenho fixo, como `R5` e `R6`, o Amazon Neptune oferece a opção de usar uma instância `T3` de desempenho de intermitência. Ao desenvolver a aplicação de grafos, convém que o banco de dados seja rápido e responsivo, mas não precisa usá-lo o tempo todo. A classe de instância `db.t3.medium` do Neptune é exatamente o que você deve usar nessa situação, por um custo significativamente menor do que a classe de instância de desempenho fixo mais barata.
Uma instância de intermitência é executada no nível da linha de base do desempenho da CPU até que uma carga de trabalho precise de mais e gera picos acima da linha de base pelo tempo necessário para a carga de trabalho. O preço por hora cobre os picos, desde que o uso médio da CPU não ultrapasse a linha de base por um período de 24 horas. Para a maioria das situações de desenvolvimento e teste, isso significa bom desempenho a um baixo custo.
Se você começar com uma classe de instância `T3`, poderá alternar facilmente para uma instância de desempenho fixo posteriormente quando estiver tudo pronto para entrar em produção, usando o Console de gerenciamento da AWS, a AWS CLI ou um dos AWS SDKs.
## A intermitência T3 é governada por créditos da CPU
Um crédito da CPU representa o uso total de um núcleo de CPU virtual (vCPU) por um minuto. Isso também significa 50% de uso de uma vCPU por dois minutos, ou 25% de uso de duas vCPUs por dois minutos, e assim por diante.
Uma instância `T3` acumula créditos da CPU quando está ociosa e os usa quando está ativa, ambos medidos em resolução de milissegundos. A classe de instância `db.t3.medium` tem duas vCPUs, e cada uma recebe 12 créditos da CPU por hora quando ociosa. Isso significa que 20% do uso de cada vCPU resulta em um saldo de crédito da CPU igual a zero. Os 12 créditos da CPU recebidos são gastos em 20% do uso da vCPU (pois 20% de 60 minutos também é 12). Desta forma, esse uso de 20% é a taxa de utilização da *linha de base* que gera um saldo de crédito da CPU nem positivo nem negativo.
O tempo ocioso (utilização da CPU abaixo de 20% do total disponível) faz com que os créditos da CPU sejam armazenados em um bucket de saldo de crédito, até o limite para uma classe de instância `db.t3.medium` de 576 (o número máximo de créditos da CPU que podem ser acumulados em 24 horas, ou seja 2 x 12 x 24). Acima desse limite, os créditos da CPU são simplesmente descartados.
Quando necessário, a utilização da CPU pode ter picos de até 100% pelo tempo necessário para a carga de trabalho, mesmo após o saldo de crédito da CPU ficar abaixo de zero. Se a instância manter um saldo negativo continuamente por 24 horas, ela incorrerá uma cobrança adicional de 0,05 USD para cada -60 créditos da CPU acumulados nesse período. No entanto, para a maioria das cargas de trabalho de desenvolvimento e teste, a intermitência é geralmente coberta pelo tempo ocioso antes ou após o pico.
**nota**
A classe de instância `T3` do Neptune é configurada como o [modo ilimitado](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/burstable-performance-instances-unlimited-mode.html) do Amazon EC2.
## Usar o Console de gerenciamento da AWS para criar uma instância de intermitência T3
No Console de gerenciamento da AWS, é possível criar uma instância primária de cluster de banco de dados, ou uma instância de réplica de leitura que usa a classe da instância `db.t3.medium`, ou você pode modificar uma instância existente para usar a classe de instância `db.t3.medium`.
Por exemplo, para criar uma instância principal do cluster de banco de dados no console do Neptune:
+ Escolha **Create Database (Criar banco de dados)**.
+ Escolha uma **DB engine version (Versão do mecanismo de banco de dados)** igual ou posterior a `1.0.2.2`.
+ Em **Purpose (Finalidade)**, escolha **Development and Testing (Desenvolvimento e teste)**.
+ Para a **DB instance class (Classe da instância de banco de dados)**, aceite o padrão: `db.t3.medium — 2 vCPU, 4 GiB RAM`.
## Usar o AWS CLI para criar uma instância de intermitência T3
Também é possível usar a AWS CLI para fazer a mesma coisa:
```
aws neptune create-db-cluster \
--db-cluster-identifier (name for a new DB cluster) \
--engine neptune \
--engine-version "1.0.2.2"
aws neptune create-db-instance \
--db-cluster-identifier (name of the new DB cluster) \
--db-instance-identifier (name for the primary writer instance in the cluster) \
--engine neptune \
--db-instance-class db.t3.medium
```
# Modificar uma instância de banco de dados do Neptune (e aplicar imediatamente)
É possível aplicar a maioria das alterações em uma instância de banco de dados do Amazon Neptune imediatamente ou adiá-las até a próxima janela de manutenção. Algumas modificações, como alterações em grupos de parâmetros, exigem que você reinicie manualmente sua instância de banco de dados para que a alteração entre em vigor.
**Importante**
Modificações geram uma interrupção, pois o Neptune deve reiniciar a instância de banco de dados para que a alteração seja aplicada. Analise o impacto sobre o banco de dados e as aplicações antes de modificar as configurações da instância de banco de dados.
## Configurações comuns e implicações do tempo de inatividade
A tabela a seguir contém detalhes sobre quais configurações você pode modificar, quando as alterações podem ser aplicadas e se as alterações causam tempo de inatividade para a instância de banco de dados.
****
| Configuração da instância de banco de dados | Observações sobre tempo de inatividade |
| --- | --- |
| **Classe de instância de banco de dados** | Ocorre uma interrupção durante essa alteração, seja ela aplicada imediatamente ou durante a próxima janela de manutenção. |
| **DB instance identifier** | A instância de banco de dados é reinicializada e ocorre uma interrupção durante essa alteração, seja ela aplicada imediatamente ou durante a próxima janela de manutenção. |
| **Grupo de sub-redes** | A instância de banco de dados é reinicializada e ocorre uma interrupção durante essa alteração, seja ela aplicada imediatamente ou durante a próxima janela de manutenção. |
| **Grupo de segurança** | A alteração é aplicada de forma assíncrona o mais rápido possível, independentemente de quando você especifica que as alterações devem ocorrer, sem resultados de interrupção. | – |
| **Certificate Authority (Autoridade certificadora)** | Por padrão, a instância de banco de dados é reiniciada quando você atribui uma nova autoridade certificadora. |
| **Database Port** | A alteração sempre ocorre imediatamente, fazendo com que a instância de banco de dados seja reinicializada e ocorra uma interrupção. |
| **Grupo de parâmetros de banco de dados** | Alterar essa configuração não resultará em uma interrupção. O nome do parameter group propriamente dito é alterado imediatamente, mas as alterações de parâmetros reais não serão aplicadas até que você reinicialize a instância sem failover. Nesse caso, a instância de banco de dados não será reinicializada automaticamente, e as alterações de parâmetro não serão aplicadas durante a próxima janela de manutenção. No entanto, se você modificar parâmetros dinâmicos no grupo de parâmetros de banco de dados recém-associado, essas alterações serão aplicadas imediatamente sem uma reinicialização. Para obter mais informações, consulte [Reinicializar uma instância de banco de dados no Amazon Neptune](manage-console-instances-reboot.md). |
| **Grupo de parâmetros do cluster de banco de dados** | O grupo de parâmetros de banco de dados é alterado imediatamente. |
| **Período de retenção de backup** | Se você especificar que as alterações devem ocorrer imediatamente, essa alteração ocorrerá imediatamente. Caso contrário, se você alterar a configuração de um valor diferente de zero para outro valor diferente de zero, a alteração será aplicada de forma assíncrona o mais rápido possível. Qualquer outra alteração ocorrerá durante a próxima janela de manutenção. Uma falha ocorrerá se você alterar de zero para um valor diferente de zero ou de um valor diferente de zero para zero. |
| **Log de auditoria** | Selecione **Registro de auditoria** se quiser usar o registro de auditoria por meio de CloudWatch registros. Você também deve definir o parâmetro `neptune_enable_audit_log` no grupo de parâmetros de cluster de banco de dados como `enable` (1) para que o registro em log de auditoria seja habilitado. |
| **Atualização da versão secundária automática** | Selecione **Habilitar a atualização automática da versão secundária** se quiser permitir que o cluster de banco de dados do Neptune receba atualizações de versão secundária do mecanismo quando disponíveis. A opção *Atualização automática de versão secundária* só se aplica a atualizações para versões secundárias do mecanismo do cluster de banco de dados do Amazon Neptune. Ela não se aplica a patches regulares aplicados para manter a estabilidade do sistema. |
# Renomear uma instância de banco de dados do Neptune
É possível renomear uma instância de banco de dados do Amazon Neptune usando o Console de gerenciamento da AWS. Renomear uma instância de banco de dados pode ter efeitos de longo alcance. Veja a seguir uma lista de coisas que você deve saber antes de renomear uma instância de banco de dados.
+ Quando você renomeia uma instância de banco de dados, o endpoint dessa instância é alterado, pois a URL inclui o nome atribuído a ela. Você sempre deve redirecionar o tráfego da URL antiga para a nova.
+ Ao renomear uma instância de banco de dados, o nome DNS antigo que era usado pelo cluster de banco de dados é excluído imediatamente, mas pode permanecer armazenado em cache por alguns minutos. O novo nome DNS da instância de banco de dados renomeada torna-se efetivo em cerca de 10 minutos. A instância de banco de dados renomeada não ficará disponível até que o novo nome entre em vigor.
+ Você não pode usar um nome de instância de banco de dados existente ao renomear uma instância.
+ Todas as réplicas de leitura associadas a uma instância de banco de dados permanecem associadas a essa instância depois que ela é renomeada. Por exemplo, suponha que você tem uma instância de banco de dados que atende seu banco de dados de produção, e que essa instância tem várias réplicas de leitura associadas. Se você renomear a instância de banco de dados e a substituir no ambiente de produção por um DB snapshot, a instância de banco de dados que você renomeou ainda terá as réplicas de leitura associadas a ela.
+ As métricas e os eventos associados ao nome de uma instância de banco de dados serão mantidos se você reutilizar um nome de instância de banco de dados. Por exemplo, se você promover uma réplica de leitura e a renomear para que ela tenha o nome da instância principal anterior, os eventos e as métricas associados à instância principal serão associados à instância renomeada.
+ Tags de instâncias de bancos de dados permanecem com a instância de banco de dados, independentemente de renomeação.
+ snapshot de banco de dadoss são mantidos para uma instância de banco de dados renomeada.
**Como renomear uma instância de banco de dados usando o console do Neptune**
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](https://console.aws.amazon.com/neptune/home).
1. No painel de navegação, escolha **Bancos de dados**.
1. Selecione o botão de opção ao lado da instância de banco de dados que deseja renomear.
1. No menu **Instance actions (Ações da instância)**, escolha **Modify (Modificar)**.
1. Insira um novo nome na caixa de texto **DB Instance Identifier (Identificador da instância de banco de dados)**. Selecione **Apply immediately (Aplicar imediatamente)** e, em seguida, selecione **Continue (Continuar)**.
1. Selecione **Modify DB Instance (Modificar instância de banco de dados)** para concluir a alteração.
# Reinicializar uma instância de banco de dados no Amazon Neptune
Em alguns casos, se você modificar uma instância de banco de dados do Amazon Neptune, alterar o grupo de parâmetros de banco de dados associado à instância ou alterar um parâmetro de banco de dados estático em um grupo de parâmetros usado pela instância, será necessário reinicializar a instância para que as alterações sejam aplicadas.
Reiniciar uma instância de banco de dados reinicia o serviço de mecanismo de banco de dados. Uma reinicialização também aplica à instância de banco de dados todas as alterações do parameter group de banco de dados associado que estavam pendentes. Reinicializar uma instância de banco de dados resulta em uma interrupção momentânea da instância, durante a qual o status da instância de banco de dados é definido como *rebooting*. Se a instância do Neptune estiver configurada para multi-AZ, a reinicialização poderá ser realizada por meio de failover. Um evento do Neptune é criado quando a reinicialização é concluída.
Se a instância de banco de dados for uma implantação Multi-AZ, você poderá forçar um failover de uma zona de disponibilidade para outra ao selecionar a opção **Reboot (Reinicializar)**. Ao forçar um failover da instância de banco de dados, o Neptune automaticamente alterna para uma réplica em espera em outra zona de disponibilidade. Em seguida, atualiza o registro DNS da instância de banco de dados para apontar para a instância de banco de dados em espera. Como resultado, você deve limpar e restabelecer todas as conexões existentes com a instância de banco de dados.
A opção **Reboot with failover (Reinicialização com failover)** é benéfica quando você deseja simular uma falha de uma instância de banco de dados para testes ou restaurar as operações na zona de disponibilidade original após a ocorrência de um failover. Para obter mais informações, consulte [High Availability (Multi-AZ)](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Concepts.MultiAZ.html) no *Guia do usuário do Amazon RDS*. Quando você reinicializa um cluster de banco de dados, ele executa failover na réplica em espera. A reinicialização de uma réplica do Neptune não inicia um failover.
O tempo necessário para reinicializar depende do processo de recuperação de falhas. Para melhorar o tempo de reinicialização, recomendamos reduzir as atividades do banco de dados o máximo possível durante o processo de reinicialização para reduzir a atividade de reversão para transações em trânsito.
No console, a opção **Reboot (Reiniciar)** poderá estar desabilitada se a instância de banco de dados não estiver no estado **Available (Disponível)**. Isso pode ser devido a vários motivos, como um backup em andamento, uma modificação solicitada pelo cliente ou uma ação da janela de manutenção.
**nota**
Antes de [Versão: 1.2.0.0 (21/07/2022)](engine-releases-1.2.0.0.md), todas as réplicas de leitura em um cluster de banco de dados eram reinicializadas automaticamente quando a instância (de gravador) principal era reiniciada.
A partir de [Versão: 1.2.0.0 (21/07/2022)](engine-releases-1.2.0.0.md), reiniciar a instância principal não faz com que as réplicas sejam reiniciadas. Isso significa que, se você estiver alterando um parâmetro de cluster, deverá reiniciar cada instância separadamente para receber a alteração do parâmetro (consulte [Grupos de parâmetros](parameter-groups.md)).
**Como reinicializar uma instância de banco de dados usando o console do Neptune**
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](https://console.aws.amazon.com/neptune/home).
1. No painel de navegação, escolha **Bancos de dados**.
1. Selecione a instância de banco de dados que você deseja reinicializar.
1. Escolha **Instance actions** e depois **Reboot**.
1. Para forçar um failover de uma zona de disponibilidade para outra, selecione **Reboot with failover? (Reinicializar com failover?)** na caixa de diálogo **Reboot DB Instance (Reinicializar instância de banco de dados)**.
1. Escolha **Reboot**. Para cancelar a reinicialização, selecione **Cancel (Cancelar)**.
# Excluir uma instância de banco de dados no Amazon Neptune
É possível excluir uma instância de banco de dados do Amazon Neptune em qualquer estado e a qualquer momento, desde que a instância tenha sido iniciada.
**Atenção**
Se você excluir a última instância restante em um cluster usando o **console da web**, ela também excluirá o volume de armazenamento do cluster subjacente.
## Criar um snapshot final de sua instância de banco de dados antes de excluí-la
Para excluir uma instância de banco de dados, você deve especificar o nome da instância e se deseja obter um DB snapshot final da instância. Se a instância de banco de dados que está sendo excluída tiver um status de **Creating (Criando)**, você não poderá obter um DB snapshot final. Se a instância de banco de dados estiver em estado de falha com um status **failed (com falha)**, **incompatible-restore (restauração incompatível)** ou **incompatible-network (rede incompatível)**, você só poderá excluir a instância quando o parâmetro `SkipFinalSnapshot` estiver definido como `true`.
Se você excluir todas as instâncias de banco de dados Neptune em um cluster de banco de dados usando Console de gerenciamento da AWS o, todo o cluster de banco de dados será excluído automaticamente. Se você estiver usando o AWS CLI ou SDK, deverá excluir o cluster de banco de dados manualmente depois de excluir a última instância.
**Importante**
Se você excluir todo um cluster de banco de dados, todos os seus backups automatizados serão excluídos ao mesmo tempo e não poderão ser recuperados. Isso significa que, a menos que você opte por criar um snapshot de banco de dados final manualmente, não poderá restaurar a instância de banco de dados para seu estado final posteriormente. Os snapshots manuais de uma instância não são excluídos quando o cluster é excluído.
Se a instância de banco de dados que deseja excluir tiver uma réplica de leitura, você deverá promover a réplica de leitura ou excluí-la.
Nos exemplos a seguir, você exclui uma instância de banco de dados com e sem um DB snapshot final.
## Excluir uma instância de banco de dados sem um snapshot final
Se desejar excluir a instância de banco de dados rapidamente, você poderá ignorar a criação de um DB snapshot final. Quando você exclui uma instância de banco de dados, todos os backups automatizados são excluídos e não podem ser recuperados. Os snapshots manuais não são excluídos.
**Como excluir uma instância de banco de dados sem um snapshot de banco de dados final usando o console do Neptune**
1. [Faça login no AWS Management Console e abra o console do Amazon Neptune em casa. https://console.aws.amazon.com/neptune/](https://console.aws.amazon.com/neptune/home)
1. No painel de navegação, escolha **Bancos de dados**.
1. Na lista **Instances (Instâncias)**, selecione o botão de opção ao lado da instância de banco de dados que você deseja excluir.
1. Escolha **Instance actions** e, em seguida, escolha **Delete**.
1. Escolha **No (Não)** na caixa **Create final snapshot? (Criar snapshot final?)**.
1. Escolha **Excluir**.
## Excluir uma instância de banco de dados com um snapshot final
Se desejar poder restaurar a instância de banco de dados excluída posteriormente, você poderá criar um DB snapshot final. Todos os backups automáticos também serão excluídos e não poderão ser recuperados. Os snapshots manuais não são excluídos.
**Como excluir uma instância de banco de dados com um snapshot de banco de dados final usando o console do Neptune**
1. [Faça login no AWS Management Console e abra o console do Amazon Neptune em casa. https://console.aws.amazon.com/neptune/](https://console.aws.amazon.com/neptune/home)
1. No painel de navegação, escolha **Bancos de dados**.
1. Na lista **Instances (Instâncias)**, selecione o botão de opção ao lado da instância de banco de dados que você deseja excluir.
1. Escolha **Instance actions** e, em seguida, escolha **Delete**.
1. Escolha **Yes (Sim)** na caixa **Create final snapshot? (Criar snapshot final?)**.
1. Na caixa **Final Snapshot name (Nome do snapshot final)**, digite o nome de seu DB snapshot final.
1. Escolha **Excluir**.
Você pode verificar a integridade de uma instância, determinar o seu tipo, descobrir qual versão de mecanismo você tem instalada no momento e obter outras informações sobre uma instância usando a [API de status da instância](access-graph-status.md).