Database Autonomy Service:EncJDBC の統合

JDBC プロパティ構成

標準 JDBC からインスタンスに接続する場合は、Properties 設定を構成する必要があります。 コード例：

// 実際のシナリオに基づいて、エンドポイント（hostname）、ポート番号（port）、インスタンス名（dbname）、ユーザー名（username）、パスワード（password）などの接続情報を更新します。
// ...

String hostname = "your-hostname"; // エンドポイント
String port = "your-port"; // ポート番号
String dbname = "your-database-name"; // インスタンス名
String username = "your-username"; // ユーザー名
String password = "your-password"; // パスワード

// 環境変数から AccessKey ID と AccessKey シークレットを取得します。
String accessKeyId = System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID");
String accessKeySecret = System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET");
// STS 一時アクセス認証情報を使用して KMS キーを読み取る場合は、取得した STS セキュリティトークン（SecurityToken）も入力する必要があります。
// String stsToken= "yourSecurityToken";

// KMS インスタンスエンドポイント。パブリックネットワークアクセスにはパブリックエンドポイントを使用します。 VPC ネットワークアクセスには、インスタンス VPC エンドポイントを使用します。
String kmsEndpoint = "kms.cn-hangzhou.aliyuncs.com"; // KMS インスタンスエンドポイント

Properties props = new Properties();
props.setProperty("user", username);
props.setProperty("password", password);
props.setProperty("ALIBABA_CLOUD_ACCESS_KEY_ID", accessKeyId);
props.setProperty("ALIBABA_CLOUD_ACCESS_KEY_SECRET", accessKeySecret);
props.setProperty("ALIBABA_CLOUD_KMS_ENDPOINT", kmsEndpoint);
// props.setProperty("ALIBABA_CLOUD_STS_TOKEN","stsToken");



// MySQL データベースの接続 URL 形式「jdbc:mysql:encdb://%s:%s/%s」。
String dbUrl = String.format("jdbc:mysql:encdb://%s:%s/%s", hostname, port, dbname);

// MySQL データベースの EncJDBC ドライバを読み込みます。
Class.forName("com.aliyun.encdb.mysql.jdbc.EncDriver");

// データベース接続を取得します。
Connection connection = DriverManager.getConnection(dbUrl, props);

// ... クエリを開始 ...

URL 構成

URL で MEK を指定できます。 コード例：

// 実際のシナリオに基づいて、エンドポイント（hostname）、ポート番号（port）、インスタンス名（dbname）、ユーザー名（username）、パスワード（password）などの接続情報を更新します。
// ...
String hostname = "your-hostname"; // エンドポイント
String port = "your-port"; // ポート番号
String dbname = "your-database-name"; // インスタンス名
String username = "your-username"; // ユーザー名
String password = "your-password"; // パスワード

// 環境変数から AccessKey ID と AccessKey シークレットを取得します。
String accessKeyId = System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID");
String accessKeySecret = System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET");
// STS 一時アクセス認証情報を使用して KMS キーを読み取る場合は、取得した STS セキュリティトークン（SecurityToken）も入力する必要があります。
// String stsToken= "yourSecurityToken";

// KMS インスタンスエンドポイント。パブリックネットワークアクセスにはパブリックエンドポイントを使用します。 VPC ネットワークアクセスには、インスタンス VPC エンドポイントを使用します。
String kmsEndpoint = "kms.cn-hangzhou.aliyuncs.com"; // KMS インスタンスエンドポイント


// MySQL データベースの接続 URL 形式。
String dbUrl = String.format("jdbc:mysql:encdb://%s:%s/%s?ALIBABA_CLOUD_ACCESS_KEY_ID=%s&ALIBABA_CLOUD_ACCESS_KEY_SECRET=%s&ALIBABA_CLOUD_KMS_ENDPOINT=%s", hostname, port, dbname, accessKeyId,accessKeySecret,kmsEndpoint);
// STS トークンを使用します。
// String dbUrl = String.format("jdbc:mysql:encdb://%s:%s/%s?ALIBABA_CLOUD_ACCESS_KEY_ID=%s&ALIBABA_CLOUD_ACCESS_KEY_SECRET=%s&ALIBABA_CLOUD_KMS_ENDPOINT=%s&ALIBABA_CLOUD_STS_TOKEN=%s", hostname, port, dbname, accessKeyId,accessKeySecret,kmsEndpoint,stsToken);

// MySQL データベースの EncJDBC ドライバを読み込みます。
Class.forName("com.aliyun.encdb.mysql.jdbc.EncDriver");

// データベース接続を取得します。
Connection connection = DriverManager.getConnection(dbUrl, username, password);

// ... クエリを開始 ...

JDBC プロパティ構成

標準 JDBC は、接続時に Properties を介してユーザー定義のプロパティを設定できます。 JDBC プロパティを構成して JDBC を実行する例を次に示します。

// 接続アドレス（hostname）、ポート（port）、データベースインスタンス名（dbname）、ユーザー名（username）、パスワード（password）などの接続情報を準備します。
// ...

String hostname = "your-hostname"; // エンドポイント
String port = "your-port"; // ポート番号
String dbname = "your-database-name"; // データベースインスタンス名
String username = "your-username"; // ユーザー名
String password = "your-password"; // パスワード
String mek = "00112233445566778899aabbccddeeff"; // マスターキー

Properties props = new Properties();
props.setProperty("user", username);
props.setProperty("password", password);
props.setProperty("MEK", mek);

// MySQL データベースの接続 URL 形式「jdbc:mysql:encdb://%s:%s/%s」。 PostgreSQL データベースの場合、接続 URL 形式を「jdbc:postgresql:encdb://%s:%s/%s」に置き換える必要があります。
String dbUrl = String.format("jdbc:mysql:encdb://%s:%s/%s", hostname, port, dbname);

// MySQL データベースの EncJDBC ドライバを読み込んでいます。 PostgreSQL データベースの場合、EncJDBC ドライバの読み込みを「com.aliyun.encdb.postgresql.jdbc.EncDriver」に置き換える必要があります。
Class.forName("com.aliyun.encdb.mysql.jdbc.EncDriver");

// データベース接続を取得します。
Connection connection = DriverManager.getConnection(dbUrl, props);

// ... クエリを開始 ...

ファイル構成

パラメータは構成ファイルからインポートでき、必要な MEK とその他のパラメータを構成できます。

プロジェクトに encJdbcConfigFile という名前の property を設定し、その値を構成ファイルパスに設定できます（デフォルトでは、ファイル encjdbc.conf を使用します）。 構成ファイルの内容は次のとおりです。

MEK=00112233445566778899aabbccddeeff

構成ファイルは、次の 2 つの方法で配置できます。

• 以下に示すように、ファイルをプロジェクトの resources ディレクトリに配置します。

  

• プログラムのランタイムディレクトリであるプロジェクト ルートディレクトリにファイルを配置します。

ファイル構成方法では、ファイル構成を完了した後、以下に示すように、プログラムで追加の構成を行う必要はありません。

// 接続アドレス（hostname）、ポート（port）、データベースインスタンス名（dbname）、ユーザー名（username）、パスワード（password）などの接続情報を準備します。
// ...
String hostname = "your-hostname"; // エンドポイント
String port = "your-port"; // ポート
String dbname = "your-database-name"; // データベースインスタンス名
String username = "your-username"; // ユーザー名
String password = "your-password"; // パスワード

// MySQL データベースの接続 URL 形式「jdbc:mysql:encdb://%s:%s/%s」。 PostgreSQL データベースの場合、接続 URL 形式を「jdbc:postgresql:encdb://%s:%s/%s」に置き換える必要があります。
String dbUrl = String.format("jdbc:mysql:encdb://%s:%s/%s", hostname, port, dbname);

// MySQL データベースの EncJDBC ドライバを読み込んでいます。 PostgreSQL データベースの場合、EncJDBC ドライバの読み込みを「com.aliyun.encdb.postgresql.jdbc.EncDriver」に置き換える必要があります。
Class.forName("com.aliyun.encdb.mysql.jdbc.EncDriver");

// データベース接続を取得します。
Connection connection = DriverManager.getConnection(dbUrl, username, password);

// ... クエリを開始 ...

URL 構成

MEK などのパラメータは、URL リンクに埋め込むことができます。 以下に示すように：

// 接続アドレス（hostname）、ポート（port）、データベースインスタンス名（dbname）、ユーザー名（username）、パスワード（password）などの接続情報を準備します。
// ...
String hostname = "your-hostname"; // エンドポイント
String port = "your-port"; // ポート
String dbname = "your-database-name"; // データベースインスタンス名
String username = "your-username"; // ユーザー名
String password = "your-password"; // パスワード
String mek = "00112233445566778899aabbccddeeff"; // マスターキー

// MySQL データベースの接続 URL 形式「jdbc:mysql:encdb://%s:%s/%s?MEK=%s」。 PostgreSQL データベースの場合、接続 URL 形式を「jdbc:postgresql:encdb://%s:%s/%s?MEK=%s」に置き換える必要があります。
String dbUrl = String.format("jdbc:mysql:encdb://%s:%s/%s?MEK=%s", hostname, port, dbname, mek);

// MySQL データベースの EncJDBC ドライバを読み込んでいます。 PostgreSQL データベースの場合、EncJDBC ドライバの読み込みを「com.aliyun.encdb.postgresql.jdbc.EncDriver」に置き換える必要があります。
Class.forName("com.aliyun.encdb.mysql.jdbc.EncDriver");

// データベース接続を取得します。
Connection connection = DriverManager.getConnection(dbUrl, username, password);

// ... クエリを開始 ...