Considerações sobre endpoints personalizados no Amazon Aurora
Use as seções a seguir para gerenciar, especificar propriedades e usar regras de associação para endpoints personalizados.
Tópicos
Gerenciar endpoints personalizados
Como clusters do Aurora recém-criados não têm endpoints personalizados, crie e gerencie esses objetos por conta própria. Faça isso usando o AWS Management Console, a AWS CLI ou a API do Amazon RDS.
nota
Também crie e gerencie endpoints personalizados para clusters do Aurora restaurados de snapshots. Os endpoints personalizados não estão incluídos no snapshot. Você os recriará depois de restaurar e escolherá novos nomes de endpoint se o cluster restaurado estiver na mesma região do original.
Para trabalhar com endpoints personalizados no AWS Management Console, navegue até a página de detalhes do cluster do Aurora e use os controles na seção Custom Endpoints (Endpoints personalizados).
Para trabalhar com endpoints personalizados da AWS CLI, use estas operações:
Para trabalhar com endpoints personalizados por meio da API do Amazon RDS, use as seguintes funções:
Especificar propriedades para endpoints personalizados
O tamanho máximo do nome de um endpoint personalizado é 63 caracteres. O formato do nome é o seguinte:
endpoint_name.cluster-custom-customer_DNS_identifier.AWS_Region.rds.amazonaws.com
Não é possível reutilizar o mesmo nome de endpoint personalizado em mais de um cluster na mesma Região da AWS. O identificador DNS do cliente é um identificador exclusivo associado à sua Conta da AWS em uma Região da AWS específica.
Cada endpoint personalizado tem um tipo associado que determina quais instâncias de banco de dados estão qualificadas para serem associadas a esse endpoint. Atualmente, o tipo pode ser READER ou ANY. As seguintes considerações se aplicam aos tipos de endpoint personalizados:
-
Não selecione o tipo de endpoint personalizado no AWS Management Console. Todos os endpoints personalizados criados por meio do AWS Management Console têm um tipo de
ANY.Você pode definir e modificar o tipo de endpoint personalizado usando a AWS CLI ou a API do Amazon RDS.
-
Somente as instâncias de banco de dados do leitor podem fazer parte de um endpoint personalizado
READER. -
As instâncias de banco de dados do leitor e do gravador podem fazer parte de um endpoint personalizado
ANY. O Aurora direciona conexões para endpoints de cluster do tipoANYpara qualquer instância de banco de dados associada com probabilidade igual. O tipoANYse aplica a clusters que usam uma topologia de replicação. -
Caso você tente criar um endpoint personalizado com um tipo que não seja apropriado com base na configuração de replicação para um cluster, Aurora retorna um erro.
Regras de associação para endpoints personalizados
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.
Defina uma lista de instâncias de banco de dados para serem incluídas em ou excluídas de um endpoint personalizado. Nós nos referimos a essas listas como estáticas e exclusão, respectivamente. Use o mecanismo de inclusão/exclusão para subdividir ainda mais os grupos de instâncias de banco de dados e verifique se o conjunto de endpoints personalizados abrange 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 (Anexar instâncias futuras adicionadas a esse 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 página. 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 desmarcadas na caixa de diálogo.
-
O console não permite que você especifique o tipo de endpoint. Todo endpoint personalizado criado usando o console é do tipo
ANY.Portanto, o Aurora não altera a associação do endpoint personalizado quando as instâncias de banco de dados mudam de perfil entre gravador e leitor devido a um failover ou uma promoção.
Na AWS CLI e na API do Amazon RDS:
-
Você pode especificar o tipo de endpoint. Portanto, quando o tipo de endpoint é definido como
READERa associação do endpoint é automaticamente ajustada durante failovers e promoções.Por exemplo, um endpoint personalizado com o tipo
READERinclui uma réplica do Aurora que, depois, é promovida para uma instância de banco de dados de gravador. A nova instância gravadora não faz mais parte do endpoint personalizado. -
Você pode adicionar membros individuais e removê-los das listas depois que eles mudam de perfil. Use o comando modify-db-cluster-endpoint
da AWS CLI ou a operação de API ModifyDBClusterEndpoint.
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, ou esse Aurora adiciona uma instância de banco de dados automaticamente por meio do mecanismo dimensionável. Nesses casos, a instância de banco de dados é adicionada a todos os endpoints personalizados para os quais está qualificada. A quais endpoints a instância de banco de dados é adicionada depende do tipo de endpoint personalizado de READER ou ANY, além de todas as listas estáticas ou de exclusões definidas para cada endpoint. Por exemplo, se o endpoint incluir uma lista estática de instâncias de banco de dados, as réplicas do Aurora recém-adicionadas não serão adicionadas a esse endpoint. Por outro lado, se o endpoint tiver uma lista de exclusões, as réplicas do Aurora recém-adicionadas serão adicionadas ao endpoint se não estiverem nomeadas na lista de exclusões e as funções corresponderem ao tipo do endpoint personalizado.
Caso se torne indisponível, uma réplica do Aurora continua associada a todos os endpoints personalizados. Por exemplo, ela continua fazendo parte do endpoint personalizado quando não há integridade, ela está parada, na reinicialização e assim por diante. Porém, não será possível se conectar a ela por meio desses endpoints até ela estar disponível novamente.
