Todos os produtos
Search
Central de documentação

PolarDB:Quick start

Última atualização: Jul 10, 2026

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.

  • Assinatura: modelo de pagamento antecipado em que você paga por recursos fixos ao criar o cluster. Assinaturas mais longas oferecem maiores descontos. Ideal para cargas de trabalho estáveis e de longo prazo.

  • Pagamento conforme o uso: modelo pós-pago. Você seleciona recursos de especificação fixa ao criar o cluster, mas não paga antecipadamente. O faturamento ocorre com base no uso real. Recomendado para cargas de trabalho com demanda flexível.

  • Serverless: modelo de pagamento conforme o uso. Ao criar o cluster, não é necessário selecionar recursos com especificações fixas nem pagar antecipadamente. Esse modelo oferece aos clusters PolarDB capacidade de dimensionamento dinâmico e elástico, ajustando automaticamente os recursos conforme as mudanças na carga de trabalho. Adequado para cenários com flutuações de negócios, cargas incertas ou demandas imprevisíveis.

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.

  • MySQL 8.0.1

  • MySQL 8.0.2

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.

  • Enterprise Edition

  • Standard Edition

Nota

Network Type

Configure a VPC e o vSwitch do cluster.

Nota
  • Se já possuir uma VPC que atenda aos seus requisitos de rede, selecione essa VPC e o respectivo vSwitch. Por exemplo, use a VPC de uma instância ECS existente.

  • Caso não tenha uma VPC adequada, use a VPC e o vSwitch padrão.

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

  • Nó único: contém apenas um nó primário (leitura/gravação).

    • Número de Nós: 1

    • Modo de alta disponibilidade: Zona única (cluster standby quente desativado)

  • Alta disponibilidade com dois nós: contém um nó primário (leitura/gravação) e um nó somente leitura.

    • Número de Nós: 2

    • Modo de alta disponibilidade: Zona única (cluster standby quente desativado)

  • Alta disponibilidade entre zonas: contém um nó primário (leitura/gravação) e um nó somente leitura. Os dados são distribuídos por múltiplas zonas de disponibilidade. As zonas primária e secundária armazenam, cada uma, uma cópia completa dos dados.

    • Número de Nós: 2

    • Modo de alta disponibilidade: Múltiplas zonas (cluster standby quente ativado)

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.

Nota
  • 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 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 bloco CIDR 0.0.0.0/0 da 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/0 permite 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.

Nota

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.

Nota
  • 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.

  1. 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.image

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

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

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.

  1. Baixe e instale o MySQL Workbench.

  2. Abra o MySQL Workbench e selecione Database > Connect to Database.

  3. Insira as informações de conexão e clique em em OK.

    Connection dialog

    Parâmetro

    Descrição

    Exemplo

    Hostname

    O endpoint do banco de dados.

    pc-2***.rwlb.rds.aliyuncs.com

    Port

    O número da porta do endpoint do banco de dados.

    Nota

    A porta padrão é 3306.

    3306

    Username

    A conta do banco de dados.

    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

O endpoint do banco de dados.

pc-2***.rwlb.rds.aliyuncs.com

-P

O número da porta do endpoint do banco de dados.

Nota
  • A porta padrão é 3306.

  • Se a porta for a padrão, omita este parâmetro.

3306

-u

A conta do banco de dados.

polardb_mysql_user

-p

A senha da conta do banco de dados.

Nota

Este parâmetro é obrigatório.

  • Se você omitir este parâmetro, será solicitado a inserir a senha após Enter password.

  • Se incluir este parâmetro, não adicione espaço entre -p e a senha.

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.

  1. 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>
  2. 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.

  1. Instale a biblioteca PyMySQL:

    pip3 install PyMySQL
  2. 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.

  1. Instale o driver go-sql-driver/mysql:

    go get -u github.com/go-sql-driver/mysql
  2. 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:

  1. Verifique se o cluster PolarDB está no estado running.

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

  3. Teste a conectividade de rede a partir da instância ECS usando ping <database endpoint> ou telnet <database endpoint> <port>.

    1. Se estiver usando um endpoint de private network:

      1. 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:

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

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

Nota

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:

  1. Verifique se o cluster PolarDB está no estado running.

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

    Nota

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

  3. Teste a conectividade de rede do seu ambiente local usando ping <database endpoint> ou telnet <database endpoint> <port>.

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

    image

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.

image