Tüm Ürünler
Search
Belge Merkezi

PolarDB:Connect to a database

Son Güncelleme:Nov 03, 2026

DMS, bir MySQL istemcisi, komut satırı veya uygulama kodu kullanarak bir PolarDB for MySQL kümesine bağlanın.

Önkoşullar

Bağlantı kurmadan önce aşağıdaki görevleri tamamlayın:

  • Veritabanı uç noktasını ve bağlantı noktasını edinin

    PolarDB konsolu adresine gidin. Clusters bölümünde hedef kümenin kimliğine tıklayarak küme ayrıntıları sayfasına gidin. Database Connections bölümünden veritabanı uç noktasını (birincil uç nokta, küme uç noktası ve özel uç nokta) edinin.

    Not
    • Cluster Endpoint kullanın. Varsayılan bağlantı noktası 3306'dır.

    • Erişim ortamınıza göre Private veya Public seçeneğini belirleyin.

      • PolarDB hizmetine erişmek için bir ECS örneği kullanıyorsanız ve ECS örneği ile PolarDB kümesi aynı VPC içindeyse Private seçeneğini belirleyin.

      • PolarDB hizmetine şirket içi bir ortamdan erişiyorsanız Public seçeneğini belirleyin. Genel bir uç nokta elde etmek için sağ taraftaki Apply düğmesine tıklayın.

    • Public İnternet anlamına gelir. Kümelere Public üzerinden erişmek, PolarDB kümeleriniz için en iyi performansı sunmayabilir.

    • Sanal ana bilgisayarlar ve Simple Application Server örnekleri, bir PolarDB kümesine Private uç nokta üzerinden bağlanamaz.

  • Bir veritabanı hesabı oluşturun

    PolarDB konsolu adresine gidin. Clusters bölümünde hedef kümenin kimliğine tıklayarak küme ayrıntıları sayfasına gidin. Settings and Management > Accounts sayfasında bir veritabanı hesabı oluşturun.

    Not

    Veritabanı hesapları farklı izinlere sahip Privileged Account ve Standard Account olarak sınıflandırılır. İhtiyaçlarınıza göre bir hesap oluşturun.

  • Bir küme izin listesini yapılandırın

    PolarDB konsolu adresine gidin. Clusters bölümünde hedef kümenin kimliğine tıklayarak küme ayrıntıları sayfasına gidin. Settings and Management > Cluster Whitelists sayfasında bir IP izin listesi veya güvenlik grubu ekleyin.

    Not
    • PolarDB hizmetine erişmek için bir ECS örneği kullanıyorsanız ve ECS örneği ile PolarDB kümesi aynı VPC içindeyse ECS örneğinin özel IP adresini yeni bir IP izin listesi grubuna ekleyebilir veya ECS örneğinin güvenlik grubunu küme izin listesine ekleyebilirsiniz.

    • PolarDB hizmetine erişmek için bir ECS örneği kullanıyorsanız ancak ECS örneği ile PolarDB kümesi aynı VPC içinde değilse ECS örneğinin genel IP adresini yeni bir IP izin listesi grubuna ekleyebilir veya ECS örneğinin güvenlik grubunu küme izin listesine ekleyebilirsiniz.

    • PolarDB hizmetine şirket içi bir ortamdan erişiyorsanız şirket içi ortamınızın genel IP adresini yeni bir IP izin listesi grubuna ekleyin.

      Genel IP adresinizi şu şekilde edinebilirsiniz:

      • Linux işletim sistemi: Terminali açın ve curl ifconfig.me komutunu çalıştırın.

      • Windows işletim sistemi: Komut istemini açın ve curl ip.me komutunu çalıştırın.

      • macOS işletim sistemi: Terminali açın ve curl ifconfig.me komutunu çalıştırın.

      Şirket içi ağ ortamınız bir proxy sunucusu kullanıyorsa veya benzer diğer yapılandırmalar mevcutsa önceki yöntemlerle elde edilen IP adresi gerçek genel IP adresiniz olmayabilir. 0.0.0.0/0 IP adres aralığını PolarDB küme izin listesine ekleyebilirsiniz. Kümeyle başarılı bir şekilde bağlantı kurduktan sonra gerçek genel IP adresini edinmek ve bunu küme izin listesine eklemek için SHOW PROCESSLIST; komutunu çalıştırın. Ardından 0.0.0.0/0 IP adres aralığını izin listesinden kaldırın.

    • 0.0.0.0/0 IP adres aralığı tüm kaynaklardan erişime izin verir ve bu durum önemli bir güvenlik tehdidi oluşturur. Gerekmedikçe izin listesine eklemeyin.

Önkoşulları tamamladıktan sonra kümeye bağlanın.

Bir veritabanı kümesine bağlanma

İhtiyaçlarınıza uygun bir bağlantı yöntemi seçin:

Kümeye bağlanmak için DMS'yi kullanma

DMS, Alibaba Cloud'un grafiksel bir veri yönetimi hizmetidir. Ek araçlar yüklemeden PolarDB kümenizi doğrudan DMS üzerinden yönetebilirsiniz.

  1. PolarDB konsolu adresine gidin. Clusters bölümünde hedef kümenin kimliğine tıklayarak küme ayrıntıları sayfasına gidin. Sayfanın sağ üst köşesindeki Log on to Database düğmesine tıklayın.

  2. İletişim kutusunda PolarDB for MySQL kümesinin database account ve database password girin ve ardından Log on düğmesine tıklayın.

  3. Oturum açtıktan sonra Logged-in Instances bölümünde oturum açtığınız PolarDB for MySQL kümesini görüntüleyebilir ve yönetim işlemleri yapabilirsiniz.

Kümeye bağlanmak için bir istemci kullanma

Bir PolarDB kümesine bağlanmak için MySQL uyumlu herhangi bir istemci kullanabilirsiniz. Aşağıdaki örnekte MySQL Workbench 8.0.29 kullanılmıştır.

  1. MySQL Workbench uygulamasını indirin ve yükleyin.

  2. MySQL Workbench'i açın ve Database > Connect to Database seçeneklerini belirleyin.

  3. Bağlantı bilgilerini girin ve OK düğmesine tıklayın.

    Parametre

    Açıklama

    Örnek

    Hostname

    Veritabanı uç noktası.

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

    Port

    Veritabanı uç noktasının bağlantı noktası numarası.

    Not

    Varsayılan bağlantı noktası 3306'dır.

    3306

    Username

    Veritabanı hesabı.

    polardb_mysql_user

    Password

    Veritabanı hesabının parolası.

    Pass***233

Kümeye bağlanmak için komut satırını kullanma

Sunucunuzda bir MySQL istemcisi yüklüyse PolarDB for MySQL kümesine bağlanmak için aşağıdaki komutu çalıştırın.

Söz dizimi:

mysql -h<endpoint> -P<port> -u<database_username> -p<database_user_password>

Örnek:

mysql -h pc-2***.rwlb.rds.aliyuncs.com -P3306 -upolardb_mysql_user -pPass***233

Parametre

Açıklama

Örnek

-h

Veritabanı uç noktası.

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

-P

Veritabanı uç noktasının bağlantı noktası numarası.

Not
  • Varsayılan bağlantı noktası 3306'dır.

  • Bağlantı noktası varsayılan bağlantı noktasıysa bu parametreyi atlayabilirsiniz.

3306

-u

Veritabanı hesabı.

polardb_mysql_user

-p

Veritabanı hesabının parolası.

Not

Bu parametre gereklidir.

  • Bu parametreyi atlarsanız Enter password isteminden sonra parola girmeniz istenir.

  • Bu parametreyi dahil ederseniz -p ile parola arasında boşluk bırakmayın.

Pass***233

Kümeye bağlanmak için bir uygulama kullanma

Bir PolarDB for MySQL kümesine bağlanmak herhangi bir MySQL veritabanına bağlanmakla aynıdır. Uç nokta, bağlantı noktası, hesap ve parola değerlerini PolarDB kümenizdeki değerlerle değiştirin. Dil bazlı örnekler:

Java

Bir Maven projesinde PolarDB for MySQL kümesine bağlanmak için MySQL JDBC sürücüsünü kullanın.

  1. pom.xml dosyanıza MySQL JDBC sürücü bağımlılığını ekleyin:

    <dependency>
        <groupId>mysql</groupId>
        <artifactId>mysql-connector-java</artifactId>
        <version>8.0.27</version>
    </dependency>
  2. Kümeye bağlanın. <HOST>, <USER>, <PASSWORD>, <DATABASE>, <YOUR_TABLE_NAME> ve <YOUR_TABLE_COLUMN_NAME> değerlerini kendi gerçek değerlerinizle değiştirin.

    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

PolarDB for MySQL kümesine bağlanmak için Python 3 ile PyMySQL kitaplığını kullanın.

  1. PyMySQL kitaplığını yükleyin:

    pip3 install PyMySQL
  2. Kümeye bağlanın. <HOST>, <USER>, <PASSWORD>, <DATABASE> ve <YOUR_TABLE_NAME> değerlerini kendi gerçek değerlerinizle değiştirin.

    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

Bir PolarDB for MySQL kümesine bağlanmak için database/sql paketini ve go-sql-driver/mysql sürücüsünü (Go 1.23.0) kullanın.

  1. go-sql-driver/mysql sürücüsünü yükleyin:

    go get -u github.com/go-sql-driver/mysql
  2. Kümeye bağlanın. <HOST>, <USER>, <PASSWORD>, <DATABASE> ve <YOUR_TABLE_NAME> değerlerini kendi gerçek değerlerinizle değiştirin.

    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()
    }

SSS

Bir ECS örneği bir**PolarDB**kümesine bağlanamıyor

Sorun giderme adımları:

  1. PolarDB kümesinin Running durumunda olup olmadığını kontrol edin.

  2. Veritabanı uç noktasının, bağlantı noktasının, hesabın ve parolanın doğru olduğunu doğrulayın. Veritabanı uç noktasını ve bağlantı noktasını edinin.

  3. ECS örneğinden ping <database endpoint> veya telnet <database endpoint> <port> kullanarak ağ bağlantısını test edin.

    1. Bir Private uç nokta kullanıyorsanız:

      1. ECS örneği ile PolarDB kümesinin aynı VPC içinde olup olmadığını kontrol edin. Aynı VPC içinde değillerse Private uç noktayı kullanamazsınız. ECS örneğini ve PolarDB kümesini aynı VPC içine almak için aşağıdaki çözümlerden birini kullanın:

      2. ECS örneğinin özel IP adresinin, IP adres aralığının veya güvenlik grubunun küme izin listesine eklenip eklenmediğini kontrol edin.

    2. Bir Public uç nokta kullanıyorsanız ECS örneğinin genel IP adresinin veya güvenlik grubunun küme izin listesine eklenip eklenmediğini kontrol edin.

Not

Sanal ana bilgisayarlar ve Simple Application Server örnekleri, bir PolarDB kümesine Private uç nokta üzerinden bağlanamaz.

Şirket içi bir ortam bir**PolarDB**kümesine bağlanamıyor

Sorun giderme adımları:

  1. PolarDB kümesinin Running durumunda olup olmadığını kontrol edin.

  2. Veritabanı uç noktasının, bağlantı noktasının, hesabın ve parolanın doğru olduğunu doğrulayın. Veritabanı uç noktasını ve bağlantı noktasını edinin.

    Not

    Veritabanı uç noktası bir Public uç nokta olmalıdır. PolarDB kümesiyle aynı VPC içinde olan bir ECS örneği kullanıyorsanız bir Private uç nokta kullanabilirsiniz.

  3. Şirket içi ortamınızdan ping <database endpoint> veya telnet <database endpoint> <port> kullanarak ağ bağlantısını test edin.

  4. Şirket içi ortamınızın genel IP adresinin veya IP adres aralığının küme izin listesine eklenip eklenmediğini kontrol edin.

    Genel IP adresinizi şu şekilde edinebilirsiniz:

    • Linux işletim sistemi: Terminali açın ve curl ifconfig.me komutunu çalıştırın.

    • Windows işletim sistemi: Komut istemini açın ve curl ip.me komutunu çalıştırın.

    • macOS işletim sistemi: Terminali açın ve curl ifconfig.me komutunu çalıştırın.

    Şirket içi ağ ortamınız bir proxy sunucusu kullanıyorsa veya benzer diğer yapılandırmalar mevcutsa önceki yöntemlerle elde edilen IP adresi gerçek genel IP adresiniz olmayabilir. 0.0.0.0/0 IP adres aralığını PolarDB küme izin listesine ekleyebilirsiniz. Kümeyle başarılı bir şekilde bağlantı kurduktan sonra gerçek genel IP adresini edinmek ve bunu küme izin listesine eklemek için SHOW PROCESSLIST; komutunu çalıştırın. Ardından 0.0.0.0/0 IP adres aralığını izin listesinden kaldırın.

"Access denied for user 'xxx'@'xxx' (using password: YES)" hatasıyla birPolarDBkümesine bağlanılamıyor

Veritabanı hesabı veya parola yanlış. PolarDB konsolu adresine gidin ve Settings and Management > Accounts sayfasında kimlik bilgilerini doğrulayın veya sıfırlayın.

"Unknown MySQL server host 'xxx'" hatasıyla birPolarDBkümesine bağlanılamıyor

Veritabanı uç noktası yanlış. Doğru biçim pc-xxxxxx.rwlb.rds.aliyuncs.com şeklindedir. PolarDB konsolu adresine gidin ve Basic Information > Database Connections bölümündeki uç noktayı doğrulayın.

"Can't connect to MySQL server on 'xxx'" veya "Connection timed out" hatasıyla birPolarDBkümesine bağlanılamıyor

Ortamınızın genel IP adresi veya IP adres aralığı muhtemelen PolarDB küme izin listesinde değildir veya girdiğiniz IP adresi yanlıştır.

Genel IP adresinizi şu şekilde edinebilirsiniz:

  • Linux işletim sistemi: Terminali açın ve curl ifconfig.me komutunu çalıştırın.

  • Windows işletim sistemi: Komut istemini açın ve curl ip.me komutunu çalıştırın.

  • macOS işletim sistemi: Terminali açın ve curl ifconfig.me komutunu çalıştırın.

Şirket içi ağ ortamınız bir proxy sunucusu kullanıyorsa veya benzer diğer yapılandırmalar mevcutsa önceki yöntemlerle elde edilen IP adresi gerçek genel IP adresiniz olmayabilir. 0.0.0.0/0 IP adres aralığını PolarDB küme izin listesine ekleyebilirsiniz. Kümeyle başarılı bir şekilde bağlantı kurduktan sonra gerçek genel IP adresini edinmek ve bunu küme izin listesine eklemek için SHOW PROCESSLIST; komutunu çalıştırın. Ardından 0.0.0.0/0 IP adres aralığını izin listesinden kaldırın.

DMS'de bir**PolarDBkümesine bağlanmak üzere kullanılan bağlantı yöntemini nasılCluster Endpointolarak değiştiririm?

Bir kümeye DMS kullanarak bağlandığınızda DMS varsayılan olarak Primary Endpoint üzerinden bağlantı kurar. In-Memory Column Index (IMCI) ve PolarDB for AI gibi özellikleri kullanmak için Cluster Endpoint seçeneğine geçiş yapın. Böylece PolarDB veritabanı proxy'si SQL deyimlerini ilgili işlevsel düğümlere yönlendirir.

Yordam:

  1. DMS üzerinden kümeye bağlandıktan sonra sol gezinme bölmesindeki Database Instances > Logged-in Instances listesinde hedef kümeyi bulun, sağ tıklayın ve Edit Instance seçeneğini belirleyin.

  2. Örneği Düzenle iletişim kutusunda Basic Information > Entry Method ayarını Connection String olarak değiştirin, kümenin Cluster Endpoint değerini girin ve Save düğmesine tıklayın.

Önemli

Uç noktayı değiştirdikten sonra mevcut SQL penceresini kapatın ve yeni bir pencere açın. Orijinal pencere güncellenen Primary Endpoint yerine hala Connection String Address kullanmaya devam eder.

Bir küme uç noktasındaki salt okunur bir düğümün ağırlığını 0 olarak ayarlayıp ardından düğümü kaldırdıktan sonra neden bağlantı hataları oluşur?

  • Senaryo: Bir küme uç noktasından bir salt okunur düğümü kaldırmanız gerekir. Düğüme yapılan bağlantıları etkilememek için öncelikle salt okunur düğümün okuma/yazma ayrıştırma ağırlığını 0 olarak ayarlarsınız. Ağırlık 0 olarak ayarlandıktan sonra sonraki okuma isteklerinin bu salt okunur düğüme gönderilmemesini beklersiniz. Ancak düğümü küme uç noktasından kaldırdıktan sonra uygulama tarafında bağlantı hataları oluşur.

  • Neden: Bir küme uç noktasının iki Load Balancing Policy vardır: Active Request-based Load Balancing ve Connections-based Load Balancing:

    • Active Request-based Load Balancing: Bir salt okunur düğümün ağırlığı 0'a düşürüldükten sonra sonraki istekler artık o düğüme yönlendirilmez.

    • Connections-based Load Balancing: Yük dengeleme yalnızca bağlantı kurulumu aşamasında yapılır. Daha önce kurulmuş bir bağlantı bir salt okunur düğüme bağlıysa bu bağlantı üzerindeki sonraki istekler her zaman o salt okunur düğüme gönderilir.

  • Çözüm:

    1. Küme uç noktası için Load Balancing Policy ayarını Active Request-based Load Balancing olarak değiştirin.

    2. Hedef salt okunur düğümün okuma/yazma ayrıştırma ağırlığını 0 olarak ayarlayın.

    3. Salt okunur düğümü kaldırın.

Referanslar