使用语言驱动程序进行连接

驱动程序与部署建立连接所需的所有信息都在连接字符串的 "mysql" 部分中。 该表包含供参考的细目。

• 0... 指示数组中的一个或多个条目。

当给定在连接信息的“组合”字段中找到 URI 格式的连接字符串时，许多 MySQL 驱动程序能够与您的部署建立连接。 例如

mysql://ibm_cloud_30399dec_4835_4967_a23d_30587a08d9a8:$PASSWORD@981ac415-5a35-4ac7-b6bb-fb609326dc42.8f7bfd8f3faa4218aec56e069eb46187.databases.appdomain.cloud:32704/ibmclouddb?ssl-mode=verify-full

有关 ssl-mode 状态的更多信息，请参阅 其他连接参数。

以下示例使用连接字符串和 Java 驱动程序 jdbc 中的信息来连接到数据库。

import java.sql.Connection;
import java.sql.DriverManager;
import java.sql.ResultSet;
import java.sql.SQLException;
import java.sql.Statement;
import java.util.Properties;

public class App {
 private final String STATUS_COMMAND = "SHOW VARIABLES LIKE '%version%';";

 private Connection connect = null;
 private Statement stmt = null;
 private ResultSet rs = null;

 private final String url = "mysql://127.0.0.1:30799";
 private final String username = "";
 private final String password = "";
 private final Boolean useSSL = true;

 public static void main(String args[]) throws Exception {
   App app = new App();
   final byte maxConnectionAttempt = 5;
   byte currentConnectionAttempt = 0;

   while (!app.connectDatabase() && currentConnectionAttempt < maxConnectionAttempt)
      ++currentConnectionAttempt;

   if (currentConnectionAttempt >= maxConnectionAttempt) {
      System.out.println(currentConnectionAttempt + " weren't successfull!");
         } else {
            app.printStatus();
            app.closeConnection();
         }
   }

   public void printStatus() {
         try {
            stmt = connect.createStatement();
            rs = stmt.executeQuery(STATUS_COMMAND);
            while (rs.next())
            System.out.println(rs.getString(1) + ": " + rs.getString(2));
         } catch (SQLException ex) {
            System.out.println("SQLException: " + ex.getMessage());
            System.out.println("SQLState: " + ex.getSQLState());
            System.out.println("VendorError: " + ex.getErrorCode());
            closeConnection();
         }
   }

   private void closeConnection() {
      try {
         if (rs != null) {
            rs.close();
         }

         if (stmt != null) {
            stmt.close();
         }

         if (connect != null) {
            connect.close();
         }
      } catch (Exception e) {
         System.out.println(e.getMessage());
      }
      System.out.println("Connection closed.");
   }

   public boolean connectDatabase() {
      // https://dev.mysql.com/doc/connector-j/8.0/en/connector-j-usagenotes-connect-drivermanager.html
      try {
            Properties props = new Properties();
            props.setProperty("user", username);
            props.setProperty("password", password);
            props.setProperty("useSSL", Boolean.toString(useSSL));
            props.setProperty("sslMode", (useSSL ? "REQUIRED" : "DISABLED"));
            props.setProperty("requireSSL", Boolean.toString(useSSL));
            props.setProperty("verifyServerCertificate", Boolean.toString(useSSL));

            Class.forName("com.mysql.cj.jdbc.Driver");
            connect = DriverManager.getConnection("jdbc:" + url, props);
            return true;
      } catch (SQLException ex) {
            System.out.println("SQLException: " + ex.getMessage());
            System.out.println("SQLState: " + ex.getSQLState());
            System.out.println("VendorError: " + ex.getErrorCode());
      } catch (ClassNotFoundException ex) {
            System.out.println("Connector class can not be found: " + ex.getMessage());
      }
      return false;
   }
}

以下示例使用连接字符串和 Python 驱动程序 pymysql 中的信息来连接到数据库。 这只是一个简单的连接示例，没有错误处理或重试逻辑，可能不适合生产。

import pymysql
connection = pymysql.connect(
  host="hostname",
  port=32089,
  user="username",
  passwd="password",
  ssl_ca="/home/user/mysql_ca.crt",
  ssl_verify_cert=True,
  ssl_verify_identity=True)

cursor = connection.cursor()
cursor.execute("SHOW STATUS;")

for row in cursor:
    print(row[0] + "\t" + row[1])

cursor.close()
connection.close()

驱动程序 TLS 和服务专有证书支持

与 Databases for MySQL 的所有连接都已启用 TLS 1.2，因此用于连接的驱动程序需要能够支持加密。 您的部署还附带了服务专有证书，这样驱动程序就能在连接时验证服务器。

有关更多信息，请参阅 Cloud Databases 证书常见问题。

使用服务专有证书

1. 从 端点 面板或连接信息的 Base64 字段复制证书信息。
2. 如果需要，将 Base64 字符串解码为文本。
3. 将证书保存到文件中。 (可以使用提供的名称或您自己的文件名)。
4. 向驱动程序或客户机提供证书的路径。

其他驱动程序

MySQL 具有一组语言驱动程序。 下表介绍了几种最常见的情况。 有关详细信息，请查阅MySQL's 连接器和 API。

使用 PHP 连接到 MySQL 时，需要将认证插件从 sha256_password 更改为 mysql_native_password。