Cette rubrique explique comment démarrer avec PolarDB for MySQL, notamment comment créer un cluster, configurer une liste d'autorisation, créer un compte de base de données et se connecter à une base de données.
Instructions
Lisez le contenu en anglais pour comprendre CE qui doit être communiqué
Rédigez le français À PARTIR DE ZÉRO — oubliez la structure des phrases anglaises
Conservez exactement tout le formatage Markdown, les blocs de code, les liens et les images
Balises xref (
<a data-tag="xref" ...>texte</a>) — conservez la balise ENTIERE avec tous ses attributs dans l'ordre et la casse d'origine, traduisez UNIQUEMENT le texte visible entre > etAppliquez strictement toutes les règles linguistiques spécifiques
Appliquez les règles relatives aux mots interdits avec une tolérance zéro
Utilisez l'impératif dans les étapes numérotées et les listes à puces procédurales
Assurez la cohérence terminologique — un même terme doit toujours avoir la même traduction
Variez les amorces de phrase dans les listes et les tableaux — aucune amorce ne doit être répétée plus de 2 fois
-
Renvoyez UNIQUEMENT le document Markdown en français, sans explication
Tutoriel
Si vous avez des questions sur l'une des étapes suivantes, cliquez sur l'étape pour afficher les instructions détaillées.
1. Créer un cluster
Accédez à PolarDB et ouvrez la page d'achat rapide pour créer rapidement un cluster PolarDB for MySQL avec une configuration minimale. Configurez les paramètres du tableau suivant et conservez les valeurs par défaut pour tous les autres réglages. Pour obtenir des instructions détaillées sur la création d'un cluster, consultez Créer un cluster avec des configurations personnalisées.
Paramètre
Description
Billing Method
Sélectionnez le type de facturation du cluster. Pour plus d'informations, consultez Méthodes de facturation.
Abonnement : méthode de facturation prépayée. Lors de la création d'un cluster, vous devez sélectionner des ressources avec des spécifications fixes et payer le cluster à l'avance. Plus la période d'abonnement est longue, plus la remise est importante. Cette méthode de facturation convient généralement aux charges de travail dont les exigences sont stables sur le long terme.
Paiement à l'utilisation : méthode de facturation postpayée. Lors de la création d'un cluster, vous devez sélectionner des ressources avec des spécifications fixes, mais vous ne payez pas le cluster à l'avance. Cette méthode de facturation vous facture en fonction de la durée réelle d'utilisation et convient généralement aux charges de travail aux exigences flexibles.
Serverless : méthode de facturation postpayée. Lors de la création d'un cluster, vous n'avez pas besoin de sélectionner des ressources avec des spécifications fixes ni de payer le cluster à l'avance. Cette méthode de facturation offre aux clusters PolarDB des capacités de mise à l'échelle élastique dynamique qui s'adaptent aux variations de la charge de travail. Elle convient généralement aux charges de travail fluctuantes, aux charges incertaines ou aux besoins métier imprévisibles.
Region
Sélectionnez la région dans laquelle le cluster est déployé.
RemarqueAssurez-vous que PolarDB et l'instance ECS à laquelle vous souhaitez vous connecter se trouvent dans la même région. Sinon, ils ne pourront pas communiquer directement via le réseau interne.
Database Engine
Sélectionnez le moteur de base de données du cluster.
MySQL 8.0.1
MySQL 8.0.2
RemarqueL'achat rapide prend uniquement en charge la version MySQL 8.0. Pour acheter une autre version de MySQL, cliquez sur l'onglet Purchase en haut à gauche.
Service Edition
Sélectionnez l'édition du cluster.
Enterprise Edition
Standard Edition
RemarqueVous devez sélectionner l'édition du cluster uniquement si le type de facturation est défini sur Abonnement ou Paiement à l'utilisation.
Enterprise Edition et Standard Edition proposent des fonctionnalités différentes. Pour plus d'informations, consultez Comparaison des fonctionnalités entre Enterprise Edition et Standard Edition.
Network Type
Configurez le VPC et le vSwitch pour le cluster.
RemarqueSi vous avez déjà créé un VPC correspondant à votre plan réseau, vous pouvez sélectionner ce VPC et ce vSwitch directement. Par exemple, si vous avez déjà créé une instance ECS et que le VPC de cette instance correspond à votre plan, vous pouvez sélectionner ce VPC et ce vSwitch.
Si vous n'avez pas créé de VPC correspondant à votre plan réseau, vous pouvez utiliser le VPC et le vSwitch par défaut.
Deployment Mode (Facultatif)
Sélectionnez le nombre de nœuds et le mode de haute disponibilité pour le cluster. Pour plus d'informations, consultez Mode de haute disponibilité (cluster de secours à chaud).
L'option à nœud unique contient uniquement un nœud principal (nœud en lecture/écriture).
Nombre de nœuds : 1
Mode de haute disponibilité : Zone unique (cluster de stockage de secours à chaud désactivé)
L'option de haute disponibilité à deux nœuds contient un nœud principal (nœud en lecture/écriture) et un nœud en lecture seule.
Nombre de nœuds : 2
Mode de haute disponibilité : Zone unique (cluster de stockage de secours à chaud désactivé)
L'option de haute disponibilité interzones contient un nœud principal (nœud en lecture/écriture) et un nœud en lecture seule. Les données sont réparties sur plusieurs zones. La zone principale et la zone secondaire stockent chacune une copie complète des données.
Nombre de nœuds : 2
Mode de haute disponibilité : Multi-zones (cluster de stockage de secours à chaud activé)
RemarqueVous devez sélectionner le mode de haute disponibilité du cluster uniquement si le type de facturation est défini sur Abonnement ou Paiement à l'utilisation.
Node Specifications
Sélectionnez les spécifications des nœuds de calcul pour le cluster en fonction de vos besoins. Pour acheter d'autres spécifications, cliquez sur l'onglet Purchase en haut à gauche.
Storage Capacity (Facultatif)
Configurez la capacité de stockage du cluster.
RemarqueVous devez configurer la capacité de stockage du cluster uniquement si le type de facturation est défini sur Abonnement ou Paiement à l'utilisation, et si l'édition est définie sur Standard Edition.
2. Configurer une liste d'autorisation
Accédez à la console PolarDB. Dans la liste Clusters, cliquez sur l'ID du cluster cible pour accéder à la page des détails du cluster. Choisissez Configuration and Management > Cluster Whitelists pour ajouter une liste d'autorisation IP ou un groupe de sécurité. Pour plus d'informations, consultez Configurer les listes d'autorisation pour un cluster et Configurer un groupe de sécurité.
RemarqueSi vous utilisez une instance ECS pour accéder à PolarDB et que l'instance ECS et PolarDB se trouvent dans le même VPC, vous pouvez ajouter le bloc CIDR du VPC où réside l'instance ECS au groupe par défaut.
Si vous utilisez une instance ECS pour accéder à PolarDB, mais que l'instance ECS et PolarDB ne se trouvent pas dans le même VPC, vous pouvez ajouter l'adresse IP publique de l'instance ECS à un nouveau groupe de liste d'autorisation IP, ou ajouter le groupe de sécurité de l'instance ECS à la liste d'autorisation du cluster.
-
Si vous accédez à PolarDB depuis votre environnement local, ajoutez l'adresse IP publique de l'environnement local à un nouveau groupe de liste d'autorisation IP.
Pour obtenir l'adresse IP publique de votre environnement local, utilisez l'une des méthodes suivantes :
Pour le système d'exploitation Linux, ouvrez un terminal, saisissez la commande
curl ifconfig.meet appuyez sur Entrée.Pour le système d'exploitation Windows, ouvrez l'invite de commandes, saisissez la commande
curl ip.meet appuyez sur Entrée.Pour le système d'exploitation macOS, ouvrez un terminal, saisissez la commande
curl ifconfig.meet appuyez sur Entrée.
Si votre réseau local utilise un proxy ou une configuration similaire, l'adresse IP obtenue par les méthodes précédentes peut ne pas être votre adresse IP publique réelle. Vous pouvez ajouter le bloc CIDR
0.0.0.0/0à la liste d'autorisation du cluster PolarDB. Après vous être connecté au cluster, exécutez la commandeSHOW PROCESSLIST;pour obtenir votre adresse IP publique réelle et l'ajouter à la liste d'autorisation du cluster. Ensuite, supprimez le bloc CIDR0.0.0.0/0de la liste d'autorisation.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 Le bloc CIDR
0.0.0.0/0autorise toutes les sources à accéder au cluster. Son ajout à la liste d'autorisation du cluster présente un risque extrêmement élevé. Ne l'ajoutez pas à la liste d'autorisation sauf si cela est nécessaire.
3. Créer un compte de base de données
Accédez à la console PolarDB. Dans la liste Clusters, cliquez sur l'ID du cluster cible pour accéder à la page des détails du cluster. Choisissez Configuration and Management > Accounts pour créer un compte de base de données. Pour plus d'informations, consultez Créer et gérer des comptes de base de données.
RemarqueLes comptes de base de données peuvent être des Privileged Account ou des Standard Account, et ces deux types de comptes ont des privilèges différents. Créez un compte privilégié ou un compte standard en fonction de vos besoins métier. Pour plus d'informations, consultez Privilèges des comptes.
4. Obtenir le point de terminaison du cluster
Accédez à la console PolarDB. Dans la liste Clusters, cliquez sur l'ID du cluster cible pour accéder à sa page de détails. Choisissez Database Connections pour obtenir le point de terminaison de la base de données. Pour plus d'informations, consultez Gérer les points de terminaison. Sur la page Database Connection, recherchez la section Cluster Endpoint (Recommended) et cliquez sur Copy à côté du point de terminaison privé pour obtenir le point de terminaison de connexion.
Remarque(Recommandé) Utilisez le Cluster Endpoint. Le port par défaut est 3306.
-
Sélectionnez le point de terminaison Internal Network ou Internet en fonction de votre environnement d'accès.
Si vous utilisez une instance ECS pour accéder à PolarDB et que l'instance ECS et PolarDB se trouvent dans le même VPC, sélectionnez le point de terminaison Internal Network.
Si vous accédez à PolarDB depuis votre environnement local, sélectionnez le point de terminaison Internet. Pour le point de terminaison public, cliquez sur Application à droite.
Internet fait référence à Internet. L'accès via le point de terminaison Internet ne permet pas d'offrir des performances optimales pour un cluster PolarDB.
Les hôtes virtuels et les Simple Application Server ne peuvent pas utiliser le point de terminaison Internal Network pour se connecter à un cluster PolarDB.
5. Se connecter à la base de données
Choisissez une méthode de connexion adaptée à vos besoins :
Utiliser DMS pour se connecter au cluster
DMS est un service graphique de gestion des données d'Alibaba Cloud. Vous pouvez gérer votre cluster PolarDB directement dans DMS sans installer d'outils supplémentaires.
Accédez à la console PolarDB. Dans la Cluster List, cliquez sur l'ID du cluster cible pour accéder à la page des détails du cluster. Dans le coin supérieur droit de la page, cliquez sur Log on to Database.

Saisissez votre database account et votre database password pour le cluster PolarDB for MySQL, puis cliquez sur Log on.

Après la connexion, recherchez le cluster PolarDB for MySQL dans la liste Logged-in Instances du volet de navigation de gauche.

Utiliser un client pour se connecter au cluster
Vous pouvez utiliser n'importe quel client compatible MySQL pour vous connecter à un cluster PolarDB. L'exemple suivant utilise MySQL Workbench 8.0.29.
Téléchargez et installez MySQL Workbench.
Ouvrez MySQL Workbench et choisissez Database > Connect to Database.
-
Saisissez les informations de connexion et cliquez sur OK.

Paramètre
Description
Exemple
Hostname
pc-2***.rwlb.rds.aliyuncs.com
Port
Le numéro de port du point de terminaison de la base de données.
RemarqueLe port par défaut est 3306.
3306
Username
polardb_mysql_user
Password
Le mot de passe du compte de base de données.
Pass***233
Utiliser la ligne de commande pour se connecter au cluster
Si un client MySQL est installé sur votre serveur, exécutez la commande suivante pour vous connecter au cluster PolarDB for MySQL.
Syntaxe :
mysql -h<endpoint> -P<port> -u<database_username> -p<database_user_password>Exemple :
mysql -h pc-2***.rwlb.rds.aliyuncs.com -P3306 -upolardb_mysql_user -pPass***233Paramètre
Description
Exemple
-h
pc-2***.rwlb.rds.aliyuncs.com
-P
Le numéro de port du point de terminaison de la base de données.
RemarqueLe port par défaut est 3306.
Si le port est le port par défaut, vous pouvez omettre ce paramètre.
3306
-u
polardb_mysql_user
-p
Le mot de passe du compte de base de données.
RemarqueCe paramètre est obligatoire.
Si vous omettez ce paramètre, vous serez invité à saisir le mot de passe après
Enter password.Si vous incluez ce paramètre, n'ajoutez pas d'espace entre
-pet le mot de passe.
Pass***233
Utiliser une application pour se connecter au cluster
La connexion à un cluster PolarDB for MySQL est identique à la connexion à n'importe quelle base de données MySQL. Remplacez le point de terminaison, le port, le compte et le mot de passe par les valeurs de votre cluster PolarDB. Exemples par langage :
Java
Utilisez le pilote JDBC MySQL dans un projet Maven pour vous connecter à un cluster PolarDB for MySQL.
-
Ajoutez la dépendance du pilote JDBC MySQL à votre fichier pom.xml :
<dependency> <groupId>mysql</groupId> <artifactId>mysql-connector-java</artifactId> <version>8.0.27</version> </dependency> -
Connectez-vous au cluster. Remplacez
<HOST>,<USER>,<PASSWORD>,<DATABASE>,<YOUR_TABLE_NAME>et<YOUR_TABLE_COLUMN_NAME>par vos valeurs réelles.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
Utilisez la bibliothèque PyMySQL avec Python 3 pour vous connecter à un cluster PolarDB for MySQL.
-
Installez la bibliothèque PyMySQL :
pip3 install PyMySQL -
Connectez-vous au cluster. Remplacez
<HOST>,<USER>,<PASSWORD>,<DATABASE>et<YOUR_TABLE_NAME>par vos valeurs réelles.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
Utilisez le package
database/sqlet le pilotego-sql-driver/mysql(Go 1.23.0) pour vous connecter à un cluster PolarDB for MySQL.-
Installez le pilote
go-sql-driver/mysql:go get -u github.com/go-sql-driver/mysql -
Connectez-vous au cluster. Remplacez
<HOST>,<USER>,<PASSWORD>,<DATABASE>et<YOUR_TABLE_NAME>par vos valeurs réelles.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() }
Gestion des clusters
Gestion des nœuds
Modification de la configuration du cluster
Haute disponibilité
Sauvegarde et restauration
Proxy de base de données
Surveillance et optimisation
Gestion des versions
Gestion des journaux binaires
FAQ
La connexion ECS au cluster **PolarDB** échoue
Procédez au dépannage comme suit :
Vérifiez si le cluster PolarDB est dans l'état running.
Assurez-vous que le point de terminaison de la base de données, le port, le compte et le mot de passe sont corrects. Obtenir le point de terminaison et le port de la base de données.
-
Testez la connectivité réseau depuis l'instance ECS en utilisant
ping <database endpoint>outelnet <database endpoint> <port>.-
Si vous utilisez un point de terminaison de private network :
-
Vérifiez si l'instance ECS et le cluster PolarDB se trouvent dans le même VPC. S'ils ne sont pas dans le même VPC, vous ne pouvez pas utiliser le point de terminaison de private network. Utilisez l'une des solutions suivantes pour placer l'instance ECS et le cluster PolarDB dans le même VPC :
Changez le VPC de l'instance ECS.
Si votre cluster est un Cluster Edition cluster, vous pouvez <!--@xref {"id":"1647cf989dvoc","data-node":"4478033","href":"t2502691.xdita#17869d614ejh0","data-tag="xref"}-->changer le VPC du cluster.
Utilisez Cloud Enterprise Network (CEN) pour activer la communication entre les VPC d'une même région.
Vérifiez si l'adresse IP privée, la plage d'adresses IP ou le groupe de sécurité de l'instance ECS a été ajouté à la liste d'autorisation du cluster.
-
Si vous utilisez un point de terminaison de public network, vérifiez si l'adresse IP publique ou le groupe de sécurité de l'instance ECS a été ajouté à la liste d'autorisation du cluster.
-
RemarqueLes hôtes virtuels et les Simple Application Server ne peuvent pas se connecter à PolarDB via un point de terminaison de private network.
La connexion locale au cluster **PolarDB** échoue
Procédez au dépannage comme suit :
Vérifiez si le cluster PolarDB est dans l'état running.
-
Assurez-vous que le point de terminaison de la base de données, le port, le compte et le mot de passe sont corrects. Obtenir le point de terminaison et le port de la base de données.
RemarqueLe point de terminaison de la base de données doit être un point de terminaison de public network. Si vous utilisez une instance ECS située dans le même VPC que le cluster PolarDB, vous pouvez utiliser un point de terminaison de private network.
Testez la connectivité réseau depuis votre environnement local en utilisant
ping <database endpoint>outelnet <database endpoint> <port>.-
Vérifiez si l'adresse IP publique ou la plage d'adresses IP de votre environnement local a été ajoutée à la liste d'autorisation du cluster.
Obtenez votre adresse IP publique :
Système d'exploitation Linux : ouvrez le terminal et exécutez la commande
curl ifconfig.me.Système d'exploitation Windows : ouvrez l'invite de commandes et exécutez la commande
curl ip.me.Système d'exploitation macOS : ouvrez le terminal et exécutez la commande
curl ifconfig.me.
Si votre environnement réseau local utilise un serveur proxy ou présente d'autres configurations similaires, l'adresse IP obtenue à l'aide des méthodes précédentes peut ne pas correspondre à votre véritable adresse IP publique. Vous pouvez ajouter la plage d'adresses IP
0.0.0.0/0à la liste d'autorisation du cluster PolarDB. Une fois la connexion au cluster établie avec succès, exécutez la commandeSHOW PROCESSLIST;pour obtenir la véritable adresse IP publique et l'ajouter à la liste d'autorisation du cluster. Ensuite, supprimez la plage d'adresses IP0.0.0.0/0de la liste d'autorisation.
Impossible de se connecter à un cluster **PolarDB** avec l'erreur « Access denied for user 'xxx'@'xxx' (using password: YES) »
Le compte ou le mot de passe de la base de données est incorrect. Accédez à la console PolarDB et vérifiez ou réinitialisez les identifiants sur la page Configurations and Management > Account Management.
Impossible de se connecter à un cluster **PolarDB** avec l'erreur « Unknown MySQL server host 'xxx' »
Le point de terminaison de la base de données est incorrect. Le format correct est pc-xxxxxx.rwlb.rds.aliyuncs.com. Accédez à la console PolarDB et vérifiez le point de terminaison dans la section Basic Information > Database Connection.
Impossible de se connecter à un cluster PolarDB avec l'erreur « Can't connect to MySQL server on 'xxx' » ou « Connection timed out »**
L'adresse IP publique ou la plage d'adresses IP de votre environnement ne figure probablement pas dans la liste d'autorisation du cluster PolarDB, ou l'adresse IP saisie est incorrecte.
Obtenez votre adresse IP publique :
Système d'exploitation Linux : ouvrez le terminal et exécutez la commande
curl ifconfig.me.Système d'exploitation Windows : ouvrez l'invite de commandes et exécutez la commande
curl ip.me.Système d'exploitation macOS : ouvrez le terminal et exécutez la commande
curl ifconfig.me.
Si votre environnement réseau local utilise un serveur proxy ou présente d'autres configurations similaires, l'adresse IP obtenue à l'aide des méthodes précédentes peut ne pas correspondre à votre véritable adresse IP publique. Vous pouvez ajouter la plage d'adresses IP
0.0.0.0/0à la liste d'autorisation du cluster PolarDB. Une fois la connexion au cluster établie avec succès, exécutez la commandeSHOW PROCESSLIST;pour obtenir la véritable adresse IP publique et l'ajouter à la liste d'autorisation du cluster. Ensuite, supprimez la plage d'adresses IP0.0.0.0/0de la liste d'autorisation.