Este tópico explica como começar a usar o PolarDB for MySQL: crie um cluster, configure uma lista de permissões, crie uma conta de banco de dados e conecte-se ao cluster.
Tutorial
Se tiver dúvidas sobre as etapas a seguir, clique em na etapa desejada para visualizar instruções detalhadas.
1. Criar um cluster
Acesse a página de Compra Rápida do PolarDB para criar rapidamente um cluster PolarDB for MySQL com configuração mínima. Defina os parâmetros da tabela a seguir e mantenha os valores padrão para as demais configurações. Para obter instruções detalhadas sobre a criação de clusters, consulte Criar um cluster com configurações personalizadas.
|
Parâmetro |
Descrição |
|
Billing Method |
Selecione o método de faturamento do cluster. Para mais informações, consulte Métodos de faturamento.
|
|
Region |
Selecione a região onde o cluster será implantado. Nota
O cluster PolarDB e a instância ECS devem estar na mesma região para permitir comunicação via rede interna. |
|
Database Engine |
Selecione o mecanismo de banco de dados do cluster.
Nota
A Compra Rápida suporta apenas o MySQL 8.0. Para adquirir outra versão do MySQL, clique em na aba Purchase no canto superior esquerdo. |
|
Service Edition |
Selecione a edição do banco de dados do cluster.
Nota
|
|
Network Type |
Configure a VPC e o vSwitch do cluster. Nota
|
|
Deployment Mode (Opcional) |
Selecione o número de nós e o modo de alta disponibilidade do cluster. Para mais informações, consulte Modo de alta disponibilidade (cluster standby quente).
Nota
Esta opção está disponível apenas para os métodos de faturamento Assinatura e Pagamento conforme o uso. |
|
Node Specifications |
Selecione um tipo de nó de computação para o cluster conforme suas necessidades. Caso precise adquirir outros tipos, clique em na aba Purchase no canto superior esquerdo. |
|
Storage Capacity (Opcional) |
Configure a capacidade de armazenamento do cluster. Nota
Esta opção é obrigatória apenas quando o método de faturamento é Assinatura ou Pagamento conforme o uso e a edição do banco de dados é Standard Edition. |
2. Configurar uma lista de permissões
Acesse o console do PolarDB. Na lista de Clusters, clique em no ID do cluster desejado para acessar a página de detalhes. Selecione Configuration and Management > Cluster Whitelists para adicionar uma lista de permissões de endereços IP ou um grupo de segurança. Para mais informações, consulte Configurar listas de permissões para um cluster e Configurar um grupo de segurança.
Ao usar uma instância ECS para acessar o PolarDB, se a instância ECS e o cluster PolarDB estiverem na mesma VPC, adicione o bloco CIDR da VPC ao grupo padrão.
Caso utilize uma instância ECS para acessar o PolarDB, mas a instância ECS e o cluster PolarDB não estejam na mesma VPC, adicione o endereço IP público da instância ECS a um novo grupo de lista de permissões de IP ou adicione o grupo de segurança da instância ECS à lista de permissões do cluster.
-
Para acessos ao PolarDB a partir de um ambiente local, adicione o endereço IP público desse ambiente ao novo grupo de lista de permissões de IP.
Para descobrir o endereço IP público do seu ambiente local, use um dos seguintes comandos:
Linux: abra um terminal e execute o comando
curl ifconfig.me.Windows: abra o Prompt de Comando e execute o comando
curl ip.me.macOS: abra um terminal e execute o comando
curl ifconfig.me.
Se sua rede local usar um proxy, o endereço IP retornado pelos comandos acima pode não ser o seu endereço IP público real. Nesse caso, adicione o bloco CIDR
0.0.0.0/0à lista de permissões do cluster PolarDB. Após conectar-se ao cluster, execute o comandoSHOW PROCESSLIST;para obter o endereço IP público real e adicione-o à lista de permissões do cluster. Em seguida, remova o bloco CIDR0.0.0.0/0da lista de permissões.xxx | aurora | 100.104.xxx.xxx:59236 | information_schema | Sleep | 47 | | NULL 268459868 | polardb_mysql_account | 47.94.74.xxx:39160 | NULL | Query | 0 | starting | SHOW PROCESSLIST O bloco CIDR
0.0.0.0/0permite acesso de qualquer endereço IP e representa um risco significativo de segurança. Adicione este bloco CIDR apenas quando necessário.
3. Criar uma conta de banco de dados
Acesse o console do PolarDB. Na lista de Clusters, clique em no ID do cluster desejado para acessar a página de detalhes. Selecione Configuration and Management > Accounts para criar uma conta de banco de dados. Para mais informações, consulte Criar e gerenciar contas de banco de dados.
As contas de banco de dados podem ser Privileged Account ou Standard Account, cada uma com privilégios diferentes. Crie o tipo de conta que melhor atenda às suas necessidades. Para mais informações, consulte Privilégios de conta.
4. Obter o endpoint do cluster
Acesse o console do PolarDB. Na lista de Clusters, clique em no ID do cluster desejado para acessar a página de detalhes. Selecione Database Connections para obter o endpoint do cluster. Para mais informações, consulte Gerenciar endpoints. Na página Database Connections, localize a seção Cluster Endpoint (Recommended) e clique em em Copy ao lado do endpoint privado.
Recomendamos o uso do Cluster Endpoint. A porta padrão é 3306.
-
Selecione um endpoint de Internal Network ou Internet com base no seu ambiente de acesso.
Se usar ECS para acessar o PolarDB e ambos estiverem na mesma VPC, selecione Internal Network.
Para acessar um cluster PolarDB a partir do seu ambiente local, selecione Internet. Para solicitar um endpoint público, clique em em Application à direita.
Um endpoint de Internet utiliza a internet pública. Para obter desempenho ideal, evite acessar seu cluster PolarDB pela Internet.
Não é possível usar um endpoint de Internal Network para conectar-se a um cluster PolarDB a partir de hosts virtuais ou servidores leves.
5. Conectar-se ao cluster
Escolha o método de conexão adequado às suas necessidades:
Usar o DMS para conectar-se ao cluster
O DMS é um serviço gráfico de gerenciamento de dados da Alibaba Cloud. Gerencie seu cluster PolarDB diretamente no DMS sem instalar ferramentas adicionais.
Acesse o console do PolarDB. Na Cluster List, clique em no ID do cluster desejado para ir à página de detalhes do cluster. No canto superior direito da página, clique em em Log on to Database.

Insira sua database account e database password do cluster PolarDB for MySQL e clique em em Log on.

Após fazer login, localize o cluster PolarDB for MySQL na lista Logged-in Instances no painel de navegação à esquerda.

Usar um cliente para conectar-se ao cluster
Use qualquer cliente compatível com MySQL para conectar-se a um cluster PolarDB. O exemplo a seguir usa o MySQL Workbench 8.0.29.
Baixe e instale o MySQL Workbench.
Abra o MySQL Workbench e selecione Database > Connect to Database.
-
Insira as informações de conexão e clique em em OK.

Parâmetro
Descrição
Exemplo
Hostname
pc-2***.rwlb.rds.aliyuncs.com
Port
O número da porta do endpoint do banco de dados.
NotaA porta padrão é 3306.
3306
Username
polardb_mysql_user
Password
A senha da conta do banco de dados.
Pass***233
Usar a linha de comando para conectar-se ao cluster
Se houver um cliente MySQL instalado no servidor, execute o seguinte comando para conectar-se ao cluster PolarDB for MySQL.
Sintaxe:
mysql -h<endpoint> -P<port> -u<database_username> -p<database_user_password>
Exemplo:
mysql -h pc-2***.rwlb.rds.aliyuncs.com -P3306 -upolardb_mysql_user -pPass***233
Parâmetro | Descrição | Exemplo |
-h | pc-2***.rwlb.rds.aliyuncs.com | |
-P | O número da porta do endpoint do banco de dados. Nota
| 3306 |
-u | polardb_mysql_user | |
-p | A senha da conta do banco de dados. Nota Este parâmetro é obrigatório.
| Pass***233 |
Usar uma aplicação para conectar-se ao cluster
A conexão a um cluster PolarDB for MySQL segue o mesmo processo de conexão a qualquer banco de dados MySQL. Substitua o endpoint, a porta, a conta e a senha pelos valores do seu cluster PolarDB. Exemplos por linguagem:
Java
Use o driver JDBC do MySQL em um projeto Maven para conectar-se a um cluster PolarDB for MySQL.
-
Adicione a dependência do driver JDBC do MySQL ao arquivo pom.xml:
<dependency> <groupId>mysql</groupId> <artifactId>mysql-connector-java</artifactId> <version>8.0.27</version> </dependency> -
Conecte-se ao cluster. Substitua
<HOST>,<USER>,<PASSWORD>,<DATABASE>,<YOUR_TABLE_NAME>e<YOUR_TABLE_COLUMN_NAME>pelos valores reais.import java.sql.Connection; import java.sql.DriverManager; import java.sql.ResultSet; import java.sql.Statement; public class DatabaseConnection { public DatabaseConnection() { } public static void main(String[] args) { // The endpoint, port, and name of the database to connect to. String url = "jdbc:mysql://<HOST>:3306/<DATABASE>?useSSL=false&serverTimezone=UTC"; // The database account. String user = "<USER>"; // The password of the database account. String password = "<PASSWORD>"; try { Class.forName("com.mysql.cj.jdbc.Driver"); Connection conn = DriverManager.getConnection(url, user, password); Statement stmt = conn.createStatement(); // The name of the data table to retrieve. ResultSet rs = stmt.executeQuery("SELECT * FROM `<YOUR_TABLE_NAME>`"); while(rs.next()) { // The name of the column in the data table to retrieve. System.out.println(rs.getString("<YOUR_TABLE_COLUMN_NAME>")); } rs.close(); stmt.close(); conn.close(); } catch (Exception var7) { var7.printStackTrace(); } } }
Python
Use a biblioteca PyMySQL com Python 3 para conectar-se a um cluster PolarDB for MySQL.
-
Instale a biblioteca PyMySQL:
pip3 install PyMySQL -
Conecte-se ao cluster. Substitua
<HOST>,<USER>,<PASSWORD>,<DATABASE>e<YOUR_TABLE_NAME>pelos valores reais.import pymysql # Database connection parameters host = '<HOST>' # The endpoint of the PolarDB cluster port = 3306 # The default port is 3306 user = '<USER>' # The database account password = '<PASSWORD>' # The password of the database account database = '<DATABASE>' # The name of the database to connect to try: # Create a database connection connection = pymysql.connect( host=host, port=port, user=user, passwd=password, db=database ) # Get the cursor with connection.cursor() as cursor: # Execute an SQL query sql = "SELECT * FROM `<YOUR_TABLE_NAME>`" # The name of the data table to retrieve cursor.execute(sql) # Get the query results results = cursor.fetchall() for row in results: print(row) finally: # Close the database connection if 'connection' in locals() and connection.open: connection.close()
Go
Use o pacote database/sql e o driver go-sql-driver/mysql (Go 1.23.0) para conectar-se a um cluster PolarDB for MySQL.
-
Instale o driver
go-sql-driver/mysql:go get -u github.com/go-sql-driver/mysql -
Conecte-se ao cluster. Substitua
<HOST>,<USER>,<PASSWORD>,<DATABASE>e<YOUR_TABLE_NAME>pelos valores reais.package main import ( "database/sql" "fmt" "log" _ "github.com/go-sql-driver/mysql" ) func main() { // Database connection parameters dbHost := "<HOST>" // The endpoint of the PolarDB cluster dbPort := "3306" // The default port is 3306 dbUser := "<USER>" // The database account dbPass := "<PASSWORD>" // The password of the database account dbName := "<DATABASE>" // The name of the database to connect to // Build the Data Source Name (DSN) dsn := fmt.Sprintf("%s:%s@tcp(%s:%s)/%s?charset=utf8mb4&parseTime=True&loc=Local", dbUser, dbPass, dbHost, dbPort, dbName) // Open a database connection db, err := sql.Open("mysql", dsn) if err != nil { log.Fatalf("Failed to connect to database: %v", err) } defer db.Close() // Test the connection err = db.Ping() if err != nil { log.Fatalf("Failed to ping database: %v", err) } // Create a cursor var result string err = db.QueryRow("SELECT VERSION()").Scan(&result) if err != nil { log.Fatalf("Failed to execute query: %v", err) } // Print the database version fmt.Printf("Connected to database, version: %s\n", result) // Execute an SQL query rows, err := db.Query("SELECT * FROM `<YOUR_TABLE_NAME>`") // The name of the data table to retrieve if err != nil { log.Fatalf("Failed to execute query: %v", err) } defer rows.Close() }
Gerenciamento de cluster
|
Gerenciamento de nós |
Especificações do cluster |
Alta disponibilidade |
Backup e restauração |
|
PolarProxy |
Monitoramento e otimização |
Gerenciamento de versões |
Gerenciamento de binary log |
FAQ
Falha na conexão do ECS com o **PolarDB**
Siga as etapas abaixo para solucionar o problema:
Verifique se o cluster PolarDB está no estado running.
Confirme se o endpoint do banco de dados, a porta, a conta e a senha estão corretos. Obter o endpoint e a porta do banco de dados.
-
Teste a conectividade de rede a partir da instância ECS usando
ping <database endpoint>outelnet <database endpoint> <port>.-
Se estiver usando um endpoint de private network:
-
Verifique se a instância ECS e o cluster PolarDB estão na mesma VPC. Caso contrário, não será possível usar o endpoint de private network. Use uma das soluções a seguir para colocar a instância ECS e o cluster PolarDB na mesma VPC:
Altere a VPC da instância ECS.
Se o cluster for da Cluster Edition, você pode alterar a VPC do cluster.
Use a Cloud Enterprise Network (CEN) para habilitar a comunicação entre VPCs na mesma região.
Verifique se o endereço IP privado, o intervalo de endereços IP ou o grupo de segurança da instância ECS foi adicionado à lista de permissões do cluster.
-
Caso esteja utilizando um endpoint de public network, verifique se o endereço IP público ou o grupo de segurança da instância ECS foi adicionado à lista de permissões do cluster.
-
Hosts virtuais e Simple Application Servers não conseguem se conectar ao PolarDB através de um endpoint de private network.
Falha na conexão local com o **PolarDB**
Siga as etapas abaixo para solucionar o problema:
Verifique se o cluster PolarDB está no estado running.
-
Confirme se o endpoint do banco de dados, a porta, a conta e a senha estão corretos. Obter o endpoint e a porta do banco de dados.
NotaO endpoint do banco de dados deve ser um endpoint de public network. Se você estiver usando uma instância ECS que está na mesma VPC que o cluster PolarDB, poderá usar um endpoint de private network.
Teste a conectividade de rede do seu ambiente local usando
ping <database endpoint>outelnet <database endpoint> <port>.-
Verifique se o endereço IP público ou o intervalo de endereços IP do seu ambiente local foi adicionado à lista de permissões do cluster.
Obtenha seu endereço IP público:
Sistema operacional Linux: abra o terminal e execute o comando
curl ifconfig.me.Sistema operacional Windows: abra o prompt de comando e execute o comando
curl ip.me.Sistema operacional macOS: abra o terminal e execute o comando
curl ifconfig.me.
Se o ambiente de rede local usar um servidor proxy ou tiver outras configurações semelhantes, o endereço IP obtido pelos métodos acima 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 do cluster PolarDB. Após conectar-se com sucesso ao cluster, execute o comandoSHOW PROCESSLIST;para obter o endereço IP público real e adicione-o à lista de permissões do cluster. Em seguida, remova o intervalo de endereços IP0.0.0.0/0da lista de permissões.
Impossível conectar-se a um cluster **PolarDB** com o erro "Access denied for user 'xxx'@'xxx' (using password: YES)"
A conta ou senha do banco de dados está incorreta. Acesse o console do PolarDB e verifique ou redefina as credenciais na página Configurations and Management > Account Management.
Impossível conectar-se a um cluster **PolarDB** com o erro "Unknown MySQL server host 'xxx'"
O endpoint do banco de dados está incorreto. O formato correto é pc-xxxxxx.rwlb.rds.aliyuncs.com. Acesse o console do PolarDB e verifique o endpoint na seção Basic Information > Database Connection.
Impossível conectar-se a um cluster PolarDB com o erro "Can't connect to MySQL server on 'xxx'" ou "Connection timed out"
Provavelmente o endereço IP público ou o intervalo de endereços IP do seu ambiente não está na lista de permissões do cluster PolarDB, ou o endereço IP inserido está incorreto.
Obtenha seu endereço IP público:
Sistema operacional Linux: abra o terminal e execute o comando
curl ifconfig.me.Sistema operacional Windows: abra o prompt de comando e execute o comando
curl ip.me.Sistema operacional macOS: abra o terminal e execute o comando
curl ifconfig.me.
Se o ambiente de rede local usar um servidor proxy ou tiver outras configurações semelhantes, o endereço IP obtido pelos métodos acima 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 do cluster PolarDB. Após conectar-se com sucesso ao cluster, execute o comando SHOW PROCESSLIST; para obter o endereço IP público real e adicione-o à lista de permissões do cluster. Em seguida, remova o intervalo de endereços IP 0.0.0.0/0 da lista de permissões.
