Tous les produits
Search
Centre de documentation

PolarDB:Quick start

Dernière mise à jour :Oct 10, 2026

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

  1. Lisez le contenu en anglais pour comprendre CE qui doit être communiqué

  2. Rédigez le français À PARTIR DE ZÉRO — oubliez la structure des phrases anglaises

  3. Conservez exactement tout le formatage Markdown, les blocs de code, les liens et les images

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

  5. Appliquez strictement toutes les règles linguistiques spécifiques

  6. Appliquez les règles relatives aux mots interdits avec une tolérance zéro

  7. Utilisez l'impératif dans les étapes numérotées et les listes à puces procédurales

  8. Assurez la cohérence terminologique — un même terme doit toujours avoir la même traduction

  9. Variez les amorces de phrase dans les listes et les tableaux — aucune amorce ne doit être répétée plus de 2 fois

  10. 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é.

    Remarque

    Assurez-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

    Remarque

    L'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

    Remarque

    Network Type

    Configurez le VPC et le vSwitch pour le cluster.

    Remarque
    • Si 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é)

    Remarque

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

    Remarque

    Vous 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é.

    Remarque
    • Si 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.me et appuyez sur Entrée.

      • Pour le système d'exploitation Windows, ouvrez l'invite de commandes, saisissez la commande curl ip.me et appuyez sur Entrée.

      • Pour le système d'exploitation macOS, ouvrez un terminal, saisissez la commande curl ifconfig.me et 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 commande SHOW PROCESSLIST; pour obtenir votre adresse IP publique réelle et l'ajouter à la liste d'autorisation du cluster. Ensuite, supprimez le bloc CIDR 0.0.0.0/0 de 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/0 autorise 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.

    Remarque

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

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

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

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

    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.

    1. Téléchargez et installez MySQL Workbench.

    2. Ouvrez MySQL Workbench et choisissez Database > Connect to Database.

    3. Saisissez les informations de connexion et cliquez sur OK.

      Connection dialog

      Paramètre

      Description

      Exemple

      Hostname

      Le point de terminaison de la base de données.

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

      Port

      Le numéro de port du point de terminaison de la base de données.

      Remarque

      Le port par défaut est 3306.

      3306

      Username

      Le compte de base de données.

      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***233

    Paramètre

    Description

    Exemple

    -h

    Le point de terminaison de la base de données.

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

    -P

    Le numéro de port du point de terminaison de la base de données.

    Remarque
    • Le port par défaut est 3306.

    • Si le port est le port par défaut, vous pouvez omettre ce paramètre.

    3306

    -u

    Le compte de base de données.

    polardb_mysql_user

    -p

    Le mot de passe du compte de base de données.

    Remarque

    Ce 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 -p et 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.

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

    1. Installez la bibliothèque PyMySQL :

      pip3 install PyMySQL
    2. 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/sql et le pilote go-sql-driver/mysql (Go 1.23.0) pour vous connecter à un cluster PolarDB for MySQL.

    1. Installez le pilote go-sql-driver/mysql :

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

    1. Vérifiez si le cluster PolarDB est dans l'état running.

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

    3. Testez la connectivité réseau depuis l'instance ECS en utilisant ping <database endpoint> ou telnet <database endpoint> <port>.

      1. Si vous utilisez un point de terminaison de private network :

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

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

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

    Remarque

    Les 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 :

    1. Vérifiez si le cluster PolarDB est dans l'état running.

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

      Remarque

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

    3. Testez la connectivité réseau depuis votre environnement local en utilisant ping <database endpoint> ou telnet <database endpoint> <port>.

    4. 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 commande SHOW PROCESSLIST; pour obtenir la véritable adresse IP publique et l'ajouter à la liste d'autorisation du cluster. Ensuite, supprimez la plage d'adresses IP 0.0.0.0/0 de la liste d'autorisation.

      image

    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 commande SHOW PROCESSLIST; pour obtenir la véritable adresse IP publique et l'ajouter à la liste d'autorisation du cluster. Ensuite, supprimez la plage d'adresses IP 0.0.0.0/0 de la liste d'autorisation.

    image