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:
Lindorm örneğinizde MySQL uyumluluk özelliğinin etkinleştirilmiş olması. Bkz. MySQL uyumluluk özelliğini etkinleştirme
JDK V1.8 veya sonraki bir sürümün yüklenmiş olması
İstemci IP adresinizin Lindorm örneğinizin izin listesine eklenmiş olması. Bkz. İzin listelerini yapılandırma
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 |
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.
urlparametresinde 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
urlparametresinde 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.
maxActivedeğ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
minIdledeğerinimaxActivedeğ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
minIdledeğ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();
}
}
Lindorm SQL'de
INSERTdeyimiUPSERTile eşdeğerdir. JDBC MySQL istemcisiINSERTiçin optimize edildiğinden veri yazarkenINSERTsözdizimini kullanın.batchSizedeğ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