Tüm Ürünler
Search
Belge Merkezi

Lindorm:Develop applications using the Druid connection pool for Java

Son Güncelleme:Oct 07, 2026

MySQL uyumlu uç nokta üzerinden LindormTable'a bağlanmak için Alibaba Druid bağlantı havuzunu kullanın.

Ön koşullar

Başlamadan önce aşağıdakilere sahip olduğunuzdan emin olun:

Bağımlılıkları ekleme

Maven projenizdeki pom.xml dosyasına aşağıdaki bağımlılıkları ekleyin:

<dependency>
  <groupId>com.alibaba</groupId>
  <artifactId>druid</artifactId>
  <version>1.2.11</version>
</dependency>
<dependency>
  <groupId>mysql</groupId>
  <artifactId>mysql-connector-j</artifactId>
  <version>8.3.0</version>
</dependency>

**Eğer druid-spring-boot-starter kullanıyorsanız**, paketle birlikte gelen druid bileşenini hariç tutun ve druid bağımlılığını açıkça belirtin:

<dependency>
  <groupId>com.alibaba</groupId>
  <artifactId>druid-spring-boot-starter</artifactId>
  <version>1.2.11</version>
  <exclusions>
    <exclusion>
      <groupId>com.alibaba</groupId>
      <artifactId>druid</artifactId>
    </exclusion>
  </exclusions>
</dependency>
<dependency>
  <groupId>com.alibaba</groupId>
  <artifactId>druid</artifactId>
  <version>1.2.11</version>
</dependency>
<dependency>
  <groupId>mysql</groupId>
  <artifactId>mysql-connector-j</artifactId>
  <version>8.3.0</version>
</dependency>

Bağlantı havuzunu yapılandırma

Maven projenizin src/main/resources dizininde aşağıdaki içeriğe sahip druid.properties dosyasını oluşturun:

# Driver class — keep this unchanged.
driverClassName=com.mysql.cj.jdbc.Driver

# Replace <endpoint> with your LindormTable endpoint for MySQL and <database> with your database name.
# To get the endpoint, see View endpoints: https://www.alibabacloud.com/help/en/lindorm/user-guide/view-endpoints
# Keep the other URL parameters unchanged to maintain optimal performance.
url=jdbc:mysql://<endpoint>:33060/<database>?sslMode=disabled&allowPublicKeyRetrieval=true&useServerPrepStmts=true&useLocalSessionState=true&rewriteBatchedStatements=true&cachePrepStmts=true&prepStmtCacheSize=100&prepStmtCacheSqlLimit=50000000&socketTimeout=120000
username=<username>
password=<password>

# Initialize the connection pool on startup — keep this unchanged.
init=true

# Number of connections to create during initialization.
initialSize=10
# Maximum number of connections in the pool. Set this to match your thread pool size.
maxActive=40
# Minimum number of idle connections. For high-throughput scenarios, set this equal to maxActive.
# For workloads with large fluctuations, use a smaller value.
minIdle=40
# Maximum time (ms) the client waits to get a connection — keep this unchanged.
maxWait=30000

# Limits how many times a single connection can be reused, preventing uneven load
# across Lindorm SQL frontend nodes. Has a minor performance impact.
phyMaxUseCount=30000

# Keep-alive settings — keep these unchanged to prevent unexpected disconnections.
druid.keepAlive=true
# If a connection has been idle for longer than this value (ms), its validity is checked.
druid.keepAliveBetweenTimeMillis=120000
# Interval (ms) at which idle connections are checked for eviction or keep-alive.
timeBetweenEvictionRunsMillis=60000
# Connections idle for longer than this value (ms) are candidates for eviction.
minEvictableIdleTimeMillis=1800000
maxEvictableIdleTimeMillis=1800000

# Connection validation settings — keep these unchanged.
testWhileIdle=true
testOnBorrow=false
testOnReturn=false

Bağlantı parametreleri

Parametre Açıklama
url JDBC bağlantı URL'si. Biçim: jdbc:mysql://<MySQL için LindormTable uç noktası>/<veritabanı adı>?<bağlantı ayarları>. Veritabanı adını belirtmezseniz istemci varsayılan veritabanına bağlanır. Tüm bağlantı ayarlarının ayrıntıları için bkz. Bağlantı ayarları.
username LindormTable kullanıcı adı. Parolayı unutursanız LindormTable küme yönetim sisteminde sıfırlayın. Bkz. Kullanıcı parolasını değiştirme.
password
Önemli
  • Uygulamanız bir Elastic Compute Service (ECS) örneğinde çalışıyorsa daha düşük gecikme süresi ve daha yüksek güvenlik için sanal özel bulut (VPC) bağlantısı kullanın. url parametresinde MySQL için LindormTable VPC uç noktasını belirtin.

  • Uygulamanız İnternet üzerinden bağlanıyorsa Lindorm konsolunda genel uç noktayı etkinleştirin: Database Connections > Wide Table Engine seçeneğine gidin ve Wide Table Engine sekmesinde Enable Public Endpoint seçeneğine tıklayın. Ardından url parametresinde MySQL için LindormTable Internet uç noktasını belirtin.

Bağlantı havuzu boyutlandırma

Lindorm SQL ön uç düğümleri, yük dengeleme için Server Load Balancer (SLB) kullanır. İsteklerin eşit dağıtılmasını sağlamak için bağlantıları uzun süreli tutmaktan kaçının. Bağlantı yeniden kullanımını sınırlamak için phyMaxUseCount parametresini yapılandırın.

  • maxActive değerini uygulamanızın iş parçacığı havuzu boyutuna eşit ayarlayın.

  • Yüksek aktarım hızı ve düşük gecikme süresi gerektiren iş yükleri için, bağlantıların her zaman hazır durumda olması amacıyla minIdle değerini maxActive değerine eşit ayarlayın.

  • Trafikte önemli dalgalanmalar olan iş yükleri için, boşta kaynak tüketimini azaltmak adına daha küçük bir minIdle değeri kullanın.

Bağlantı havuzunu başlatma

Yapılandırma dosyasını yükleyin ve veri kaynağını oluşturun:

// Load configuration from druid.properties.
Properties properties = new Properties();
InputStream inputStream = DruidPoolDemo.class.getClassLoader().getResourceAsStream("druid.properties");
properties.load(inputStream);

// Initialize the connection pool.
DataSource dataSource = DruidDataSourceFactory.createDataSource(properties);

CRUD işlemlerini çalıştırma

Tüm örnekler, try-with-resources kullanarak havuzdan bir bağlantı alır ve otomatik olarak geri döndürür. Try-with-resources kullanmazsanız conn.close() yöntemini açıkça çağırın; bu işlem bağlantıyı kapatmaz, havuza geri döndürür. Bir bağlantı geçersiz hale gelir ve havuza döndürülmezse Druid bu geçersiz durumu tespit edemez.

String tableName = "sql_table_" + new Random().nextInt(1000);

// Create a table.
try (Connection connection = dataSource.getConnection()) {
    try (Statement statement = connection.createStatement()) {
        String sql = "create table if not exists " + tableName + "(id VARCHAR, name VARCHAR, primary key(id))";
        int ret = statement.executeUpdate(sql);
        System.out.println(ret);
    }
}

// Insert a single row.
try (Connection connection = dataSource.getConnection()) {
    String sql = "insert into " + tableName + "(id,name) values(?,?)";
    try (PreparedStatement ps = connection.prepareStatement(sql)) {
        ps.setString(1, "aa");
        ps.setString(2, "bb");
        int ret = ps.executeUpdate();
        System.out.println(ret);
    }
}

// Batch insert.
String insertSql = "insert into " + tableName + "(id,name) values(?,?)";
int batchSize = 100;
try (Connection connection = dataSource.getConnection()) {
    try (PreparedStatement ps = connection.prepareStatement(insertSql)) {
        for (int i = 0; i < batchSize; i++) {
            ps.setString(1, "aa" + i);
            ps.setString(2, "bb" + i);
            ps.addBatch();
        }
        ps.executeBatch();
    }
}

// Query data.
try (Connection connection = dataSource.getConnection()) {
    String sql = "select * from " + tableName + " where id=?";
    try (PreparedStatement ps = connection.prepareStatement(sql)) {
        ps.setString(1, "aa");
        ResultSet rs = ps.executeQuery();
        while (rs.next()) {
            String id = rs.getString(1);
            String name = rs.getString(2);
            System.out.println("id=" + id);
            System.out.println("name=" + name);
        }
    }
}

// Delete data.
try (Connection connection = dataSource.getConnection()) {
    String sql = "delete from " + tableName + " where id=?";
    try (PreparedStatement ps = connection.prepareStatement(sql)) {
        ps.setString(1, "aa");
        ps.executeUpdate();
    }
}
Not
  • Lindorm SQL'de INSERT deyimi UPSERT ile eşdeğerdir. JDBC MySQL istemcisi INSERT için optimize edildiğinden veri yazarken INSERT sözdizimini kullanın.

  • batchSize değerini 50 ile 100 arasında tutun. Daha büyük toplu işler sunucuda bellek yetersizliği (OOM) hatalarına veya Full GC'ye neden olabilir.

  • Yazma aktarım hızını daha da artırmak için yazma eşzamanlılığını artırın.

Üretim ortamı hususları

Bağlantı kesintilerini yönetme

Karmaşık ağ ortamlarında ağ geçidi darboğazları, ağ titreşimleri veya yüksek paket kaybı nedeniyle bağlantı kesintileri yaşanabilir. druid.properties dosyasındaki canlı tutma ayarları boşta kalan bağlantıları korumaya yardımcı olur ancak geçici hatalar için uygulama kodunuzda ayrıca bir yeniden deneme mekanizması uygulamanız gerekir.

Sunucu yükseltildiğinde ve yeniden başlatıldığında aktif bağlantılar geçici olarak kesilebilir. Özel durumları yakalayın ve işlemi yeniden deneyin.

Bağlantı havuzunu izleme

Etkili yapılandırmaları ve bağlantı havuzu istatistiklerini düzenli olarak kontrol edin ve yapılandırmaları günlüklerde inceleyin:

druidDataSource.getStatData();  // Returns current pool statistics
druidDataSource.dump();         // Logs detailed pool configuration and state

SSS

**Uygulamam neden Read timed out hatası veriyor?**

Druid'deki varsayılan soket zaman aşımı 10 saniyedir. Bir sorgu bundan daha uzun sürerse bağlantı zaman aşımına uğrar ve bu hata oluşur. JDBC URL'sinde socketTimeout değerini milisaniye cinsinden ayarlayın. Önerilen değer 120000 (2 dakika) şeklindedir:

jdbc:mysql://<endpoint>:33060/<database>?sslMode=disabled&allowPublicKeyRetrieval=true&useServerPrepStmts=true&useLocalSessionState=true&rewriteBatchedStatements=true&cachePrepStmts=true&prepStmtCacheSize=100&prepStmtCacheSqlLimit=50000000&socketTimeout=120000