Trabalhar com endpoints personalizados no Neptune - Amazon Neptune

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á.

Trabalhar com endpoints personalizados no Neptune

Quando você adiciona uma instância de banco de dados a um endpoint personalizado ou a remove de um endpoint personalizado, todas as conexões existentes com essa instância de banco de dados permanecem ativas.

É possível definir uma lista de instâncias de banco de dados para serem incluídas em um endpoint personalizado (a lista estática) ou uma para excluir do endpoint personalizado (a lista de exclusões). Use o mecanismo de inclusão/exclusão para subdividir as instâncias de banco de dados em grupos e verifique se os endpoints personalizados abrangem todas as instâncias de banco de dados no cluster. Cada endpoint personalizado só pode conter um desses tipos de lista.

No AWS Management Console, a escolha é representada pela caixa de seleção Attach future instances added to this cluster. Quando você mantém a caixa de seleção desmarcada, o endpoint personalizado usa uma lista estática contendo apenas as instâncias de banco de dados especificadas na caixa de diálogo. Quando você marca a caixa de seleção, o endpoint personalizado usa uma lista de exclusões. Nesse caso, o endpoint personalizado representa todas as instâncias de banco de dados no cluster (inclusive as adicionadas futuramente), exceto as deixadas desmarcadas na caixa de diálogo.

O Neptune não altera as instâncias de banco de dados especificadas nas listas estáticas ou de exclusão quando as instâncias de banco de dados mudam de funções entre a instância principal e a réplica do Neptune em virtude do failover ou da promoção.

Associe uma instância de banco de dados a mais de um endpoint personalizado. Por exemplo, suponhamos que você adicione uma nova instância de banco de dados a um cluster. Nesse caso, a instância de banco de dados é adicionada a todos os endpoints personalizados para os quais está qualificada. A lista estática ou de exclusões definida para ela determina qual instância de banco de dados pode ser adicionada a ela.

Se o endpoint incluir uma lista estática de instâncias de banco de dados, as réplicas do Neptune recém-adicionadas não serão adicionadas a ele. Por outro lado, se o endpoint tiver uma lista de exclusões, as réplicas do Neptune recém-adicionadas serão adicionadas a ela, desde que não estejam indicadas na lista de exclusões.

Caso uma réplica do Neptune se torne indisponível, ela continuará associada aos seus endpoints personalizados. Isso será válido se ela não estiver íntegra, for interrompida, for reinicializada ou estiver indisponível por outro motivo. Porém, enquanto ela permanecer indisponível, não será possível se conectar a ela por meio de nenhum endpoint.

Como clusters do Neptune recém-criados não têm endpoints personalizados, é necessário criá-los e gerenciá-los por conta própria. Isso também vale para clusters do Neptune restaurados por meio de snapshots, porque os endpoints personalizados não estão incluídos no snapshot. Você os recriará após a restauração e escolherá novos nomes de endpoint se o cluster restaurado estiver na mesma região do original.

Criar um endpoint personalizado

Gerencie endpoints personalizados usando o console do Neptune. Faça isso acessando a página de detalhes do cluster do Neptune e use os controles na seção Endpoints personalizados.

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

  2. Acesse a página de detalhes do cluster.

  3. Escolha a ação Create custom endpoint na seção Endpoints.

  4. Selecione um nome para o endpoint personalizado, exclusivo para o ID do usuário e a região. O nome deve ter 63 caracteres ou menos e ter o seguinte formato:

    endpointName.cluster-custom-customerDnsIdentifier.dnsSuffix

    Como os nomes de endpoint personalizados não incluem o nome do cluster, você vai precisa alterar esses nomes se renomear um cluster. No entanto, não é possível reutilizar o mesmo nome de endpoint personalizado em mais de um cluster na mesma região. Atribua a cada endpoint personalizado um nome que seja exclusivo entre os clusters de propriedade do ID do usuário dentro de uma região específica.

  5. Para escolher uma lista de instâncias de banco de dados que permaneça a mesma mesmo quando o cluster se expande, mantenha a caixa de seleção Attach future instances added to this cluster (Anexar instâncias futuras adicionadas a esse cluster) desmarcada. Quando essa caixa de seleção é marcada, o endpoint personalizado adiciona de maneira dinâmica todas as novas instâncias ao adicioná-las ao cluster.

Visualizar endpoints personalizados

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

  2. Acesse a página de detalhes do cluster de banco de dados.

  3. A seção Endpoints contém apenas informações sobre endpoints personalizados (os detalhes sobre os endpoints integrados estão listados na seção Detalhes principal). Para ver os detalhes de um endpoint personalizado específico, selecione o nome para abrir a página de detalhes desse endpoint.

Editar um endpoint personalizado

É possível editar as propriedades de um endpoint personalizado para alterar quais instâncias de banco de dados estão associadas a ele. Você também pode alternar entre uma lista estática e uma lista de exclusões.

Não se conecte a ou use um endpoint personalizado enquanto as alterações em uma ação de edição estão em andamento. Pode demorar alguns minutos para o status do endpoint retornar a Disponível e você se reconectar.

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

  2. Acesse a página de detalhes do cluster.

  3. Na seção Endpoints, selecione o nome do endpoint personalizado que você deseja editar.

  4. Na página de detalhes desse endpoint, escolha a ação Editar.

Excluir um endpoint personalizado

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

  2. Acesse a página de detalhes do cluster.

  3. Na seção Endpoints, selecione o nome do endpoint personalizado que você deseja excluir.

  4. Na página de detalhes desse endpoint, escolha a ação Excluir.