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.
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.
Faça login no console ENS. No painel de navegação à esquerda, escolha e clique em Create Network.
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.
|
|
Sub-series |
Escolha entre as sub-séries Dedicated e General-purpose:
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
|
|
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:
|
|
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 , 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.
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.
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.
Baixe e instale o MySQL Workbench.
Abra o MySQL Workbench e selecione .
-
Insira as informações de conexão e clique em OK.
Parâmetro
Descrição
Exemplo
Hostname
pc-2***.rwlb.rds.aliyuncs.com
Port
Número da porta do endpoint do banco de dados.
NotaA porta padrão é 3306.
3306
Username
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 | pc-2***.rwlb.rds.aliyuncs.com | |
-P | Número da porta do endpoint do banco de dados. Nota
| 3306 |
-u | polardb_mysql_user | |
-p | Senha da conta de 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, 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.
-
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> -
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
Utilize 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
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.
-
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() }