PolarDB:Connect to a database

Siga estas etapas para solucionar o problema:

1. Verifique se a instância PolarDB-X está no status Running.

2. Valide o database endpoint and port e a account and password.

3. Investigue fatores de rede executando ping <database endpoint> ou telnet <database endpoint> <port> em uma instância ECS para testar a conectividade de rede.

4. Se estiver usando uma Internal Network:

   1. Confira se a instância ECS e a instância PolarDB-X estão na mesma VPC. Caso contrário, não será possível usar a Internal Network. Utilize um dos métodos a seguir para colocar as instâncias ECS e PolarDB-X na mesma VPC:

      • Altere a VPC da instância ECS.

      • Se a instância PolarDB-X usar a VPC padrão, altere a VPC dessa instância.

      • Use a Cloud Enterprise Network (CEN) para habilitar a comunicação entre VPCs. Para mais informações, consulte Connect VPCs in the same region.

   2. Verifique se o endereço IP privado ou o bloco CIDR da instância ECS foi adicionado à lista de permissões da instância PolarDB-X. Para mais informações, consulte Configure an instance whitelist.

5. Ao utilizar a Internet, confirme se o endereço IP público da instância ECS foi adicionado à lista de permissões da instância PolarDB-X. Para mais informações, consulte Configure an instance whitelist.

Siga estas etapas para solucionar o problema:

1. Verifique se a instância PolarDB-X está no status Running.

2. Valide o database endpoint and port e a account and password.

   Nota

   É necessário usar a Internet para conexões a partir de um ambiente on-premises. A Internal Network só pode ser usada quando o cliente e a instância PolarDB-X estão na mesma VPC.

3. Para verificar problemas de rede, execute ping <database endpoint> ou telnet <database endpoint> <port> no seu ambiente local para testar a conectividade.

4. Confira se o endereço IP público ou o bloco CIDR do seu ambiente on-premises foi adicionado à lista de permissões da instância PolarDB-X. Para mais informações, consulte Configure an instance whitelist.

   Para obter o endereço IP público do seu ambiente on-premises, execute uma das etapas a seguir:

   • Sistemas operacionais Linux: abra o terminal, insira o comando curl ifconfig.me e pressione Enter.

   • Windows: abra o Prompt de Comando, insira o comando curl ip.me e pressione Enter.

   • macOS: abra o Terminal, insira o comando curl ifconfig.me e pressione Enter.

   Caso sua rede local esteja atrás de um proxy, o endereço IP obtido pode não ser o seu endereço IP público real. Adicione o intervalo de endereços IP 0.0.0.0/0 à lista de permissões da instância PolarDB-X. Após conectar-se com sucesso à instância, execute o comando SHOW PROCESSLIST; para obter seu endereço IP público real e adicione-o à lista de permissões da instância. Em seguida, remova o intervalo de endereços IP 0.0.0.0/0 da lista de permissões.

   <bean id="dataSource" class="com.alibaba.druid.pool.DruidDataSource" init-method="init" destroy-method="close">
     <property name="url" value="jdbc:mysql://pxc-*****.public.polarx.rds.aliyuncs.com:3306/doc_test?socketTimeout=60000" />
     ...
     <property name="asyncInit" value="true" />
   </bean>

Uma mensagem de erro como "Access denied for user 'xxx'@'xxx' (using password: YES)" indica conta ou senha incorretas. Verifique suas credenciais. Acesse o console do PolarDB-X e escolha Configuration and Management > Accounts para manage your database account and password.

Esse erro indica que o endpoint do banco de dados está incorreto. Certifique-se de que o endpoint esteja correto e siga o formato pxc-xxx.polarx.rds.aliyuncs.com. Acesse o console do PolarDB-X e encontre o endpoint do banco de dados na seção Basic Information > Connection Information.

Isso pode ocorrer se o IP público do seu ambiente não tiver sido adicionado à lista de permissões da instância PolarDB-X ou se a entrada na lista de permissões estiver incorreta.

<bean id="dataSource" class="com.alibaba.druid.pool.DruidDataSource" init-method="init" destroy-method="close">
  <property name="url" value="jdbc:mysql://pxc-*****.public.polarx.rds.aliyuncs.com:3306/doc_test?socketTimeout=60000" />
  ...
  <property name="asyncInit" value="true" />
</bean>

Se sua aplicação utiliza um framework comum de Mapeamento Objeto-Relacional (ORM), como Spring Boot, MyBatis e um driver JDBC, o framework geralmente permite definir timeouts no lado do cliente para consultas SQL em várias camadas, como transações, instruções SQL e I/O de rede. Exemplos incluem transaction_timeout do Spring, statement_timeout do MyBatis e query_timeout do driver JDBC do MySQL.

Essencialmente, a maioria desses mecanismos de timeout no lado do cliente precisa executar uma instrução Kill no banco de dados para interromper consultas. Em cenários de bancos de dados distribuídos, instruções Kill têm alto custo de execução, e a execução frequente consome uma quantidade significativa de recursos do sistema de banco de dados. Portanto, não recomendamos o uso extensivo desses mecanismos de timeout.

Como melhor prática, sua aplicação deve usar diretamente o parâmetro socket_timeout (timeout de socket de rede) na URL JDBC para especificar o timeout de execução de SQL. Isso ocorre porque o parâmetro depende do próprio mecanismo de timeout do protocolo TCP, e uma instrução Kill não é acionada quando ocorre um timeout. Por exemplo:

<bean id="dataSource" class="com.alibaba.druid.pool.DruidDataSource" init-method="init" destroy-method="close">
  <property name="url" value="jdbc:mysql://pxc-*****.public.polarx.rds.aliyuncs.com:3306/doc_test?socketTimeout=60000" />
  ...
  <property name="asyncInit" value="true" />
</bean>