Todos os produtos
Search
Central de documentação

PolarDB:Guia de início rápido para clusters de borda

Última atualização: Nov 03, 2026

Este tópico descreve os primeiros passos com clusters de borda do PolarDB for MySQL, incluindo criação de cluster, configuração de lista de permissões, criação de conta de banco de dados e conexão ao banco de dados.

Regiões de borda suportadas

Atualmente, os clusters de borda do PolarDB for MySQL estão disponíveis apenas em Haikou Telecom, Türkiye (Istanbul)-1, Macao (China)-2 e Vietnam (Hanoi)-3.

1. Criar uma rede ENS

Crie uma rede de service de borda na região onde deseja implantar o cluster.

Nota

Se ainda não utilizou o Edge Node Service (ENS), forneça as informações necessárias conforme suas necessidades de negócios e solicite acesso em activate ENS.

  1. Faça login no console ENS. No painel de navegação à esquerda, escolha Network Management > Network e clique em Create Network.

  2. Na página Create Network, defina as configurações. Para verificar a disponibilidade por região, consulte Supported edge regions. Em seguida, create the required network (VPC and vSwitch).

2. Criar um cluster de borda

Acesse a PolarDB página de compra de cluster de borda para criar rapidamente um cluster de borda do PolarDB for MySQL. Configure os parâmetros abaixo e mantenha as demais configurações com os valores padrão.

Parâmetro

Descrição

Billing Method

Os clusters de borda suportam apenas o método de faturamento Subscription.

Nota

Subscription é um modelo de pagamento antecipado. Ao criar um cluster, selecione recursos com especificações fixas e pague pelo cluster adiantadamente. Quanto maior o período da assinatura, maior o desconto. Este método é geralmente adequado para cenários com demandas de negócios estáveis e de longo prazo.

Edge Primary Data Center

Selecione o nó de borda onde o cluster estará localizado.

Nota

Certifique-se de que o cluster PolarDB e a instância ENS de destino estejam na mesma região. Caso contrário, a comunicação via rede interna não será possível.

Compatibility

Escolha a versão compatível com MySQL para o cluster.

  • MySQL 8.0.2: Totalmente compatível com MySQL 8.0.18 Community Edition e versões anteriores.

  • MySQL 8.0.1: Totalmente compatível com MySQL 8.0.13 Community Edition e versões anteriores.

Sub-series

Escolha entre as sub-séries Dedicated e General-purpose:

  • Dedicated: Cada cluster utiliza exclusivamente os recursos de computação alocados a ele, como cpu, sem compartilhamento com outros clusters no mesmo servidor. O desempenho é mais estável e confiável.

  • General-purpose: Diferentes clusters no mesmo servidor aproveitam integralmente os recursos ociosos uns dos outros, como cpu. Ao reutilizar recursos de computação, esses clusters obtêm economia de escala e são mais econômicos.

Para uma comparação detalhada entre as duas sub-séries, consulte Choose between General-purpose and Dedicated specifications.

Network

Selecione the ENS network that you created in step 1. Se já criou uma instância de cloud de borda e a VPC onde ela reside atende ao seu planejamento, selecione essa VPC e vSwitch.

Specification

Defina a especificação do nó. As especificações variam em cpu, memória, capacidade máxima de armazenamento e IOPS. Escolha a especificação adequada às necessidades do seu negócio.

Nodes

O padrão são dois nós: um nó de leitura/gravação e um nó somente leitura. Configure a quantidade de nós conforme as demandas do seu negócio.

Nota
  • Ao adquirir um cluster, se a quantidade de nós somente leitura for igual ou superior a 1, não será possível alterá-la para 0 após a compra. Para definir a quantidade de nós somente leitura como 0 em um cluster existente, adquira um novo cluster e migre os dados do cluster original utilizando uma ferramenta como DTS ou o recurso de atualização de versão principal.

  • Descrições dos nós:

    • Nó de leitura/gravação: Também conhecido como nó primário, executa operações de escrita e algumas de leitura. A sincronização de dados entre o nó primário e os nós somente leitura ocorre via replicação física.

    • Nó somente leitura: Executa operações de leitura, alivia a carga do nó primário e oferece alta disponibilidade e escalabilidade.

    • Read-only IMCI Node: Nó funcional destinado ao recurso In-Memory Column Index (IMCI). Utiliza armazenamento colunar para acelerar consultas analíticas (OLAP), reduz a carga nos nós primários e somente leitura, além de proporcionar alta disponibilidade e escalabilidade.

Tipo de armazenamento

O PolarDB para clusters de borda baseia-se no ENS Cloud Disk, um product de armazenamento em nível de bloco fornecido pela Alibaba Cloud para ENS. Oferece baixa latência, alto desempenho, durabilidade e alta confiabilidade. Duas especificações estão disponíveis:

  • ESSD PL0: Enhanced SSD (ESSD) com nível de desempenho 0 (PL0).

  • ESSD PL1: Em comparação ao PL0, o ESSD com nível de desempenho 1 (PL1) oferece cinco vezes mais IOPS.

Capacidade de armazenamento

Defina antecipadamente a capacidade de armazenamento desejada. O valor padrão é 100 GB.

3. Criar uma conta de banco de dados

Faça login no console PolarDB para clusters de borda. Em Edge Clusters, clique no ID do cluster desejado para abrir a página de detalhes. Em Configuration and Management > Accounts, crie uma conta de banco de dados. Clique em Create Account. Na caixa de diálogo, insira o nome da Database Account, selecione o Account Type, defina a Password e Confirm Password e clique em OK. A conta de banco de dados será criada.

Nota

Os tipos de conta incluem Privileged Account e Standard Account. Cada tipo possui permissões distintas. Crie a conta que melhor atenda às necessidades do seu negócio. Para mais informações, consulte Account privileges.

4. Obter o endpoint do cluster

Faça login no console PolarDB para clusters de borda. Em Edge Clusters, clique no ID do cluster desejado para acessar a página de detalhes. Obtenha o endpoint do banco de dados em Database Connections. Na página Database Connections, localize o cartão Cluster Endpoint [Recommended]. Na linha de endereço Private Network, clique em Copy para obter o endpoint privado do cluster.

Nota
  • O endpoint privado corresponde a um endereço IP dentro da sua VPC de cloud de borda. O sistema utiliza um balanceador de carga para associar os nós de computação.

  • (Recomendado) Utilize o Cluster Endpoint. A porta padrão é 3306.

5. Conectar-se ao banco de dados

Escolha o método de conexão mais adequado às suas necessidades:

Usar um cliente para conectar-se ao cluster

Utilize qualquer cliente compatível com MySQL para conectar-se a um cluster PolarDB. O exemplo a seguir utiliza 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 OK.

    Parâmetro

    Descrição

    Exemplo

    Hostname

    O database endpoint.

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

    Port

    Número da porta do endpoint do banco de dados.

    Nota

    A porta padrão é 3306.

    3306

    Username

    O database account.

    polardb_mysql_user

    Password

    Senha da conta de banco de dados.

    Pass***233

Usar a linha de comando para conectar-se ao cluster

Caso tenha um cliente MySQL instalado no servidor, execute o comando abaixo 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 database endpoint.

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

-P

Número da porta do endpoint do banco de dados.

Nota
  • A porta padrão é 3306.

  • Se estiver usando a porta padrão, este parâmetro pode ser omitido.

3306

-u

O database account.

polardb_mysql_user

-p

Senha da conta de banco de dados.

Nota

Este parâmetro é obrigatório.

  • Se omitido, o sistema solicitará a senha após a mensagem Enter password.

  • Ao 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, porta, conta e senha pelos valores correspondentes ao seu cluster PolarDB. Exemplos por linguagem:

Java

Utilize 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 seu arquivo pom.xml:

    <dependency>
        <groupId>mysql</groupId>
        <artifactId>mysql-connector-java</artifactId>
        <version>8.0.27</version>
    </dependency>
  2. Conecte-se ao cluster. Substitua &lt;HOST&gt;, &lt;USER&gt;, &lt;PASSWORD&gt;, &lt;DATABASE&gt;, &lt;YOUR_TABLE_NAME&gt; e &lt;YOUR_TABLE_COLUMN_NAME&gt; 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

Utilize 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 &lt;HOST&gt;, &lt;USER&gt;, &lt;PASSWORD&gt;, &lt;DATABASE&gt; e &lt;YOUR_TABLE_NAME&gt; 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

Utilize 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 &lt;HOST&gt;, &lt;USER&gt;, &lt;PASSWORD&gt;, &lt;DATABASE&gt; e &lt;YOUR_TABLE_NAME&gt; 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()
    }