JDBC 驅動程式的 Always Encrypted API 參考
Always Encrypted 可讓用戶端將用戶端應用程式內的敏感性資料進行加密，且絕不會向伺服器顯示加密金鑰。 安裝在用戶端電腦上且啟用 Always Encrypted 的驅動程式，透過自動將用戶端應用程式中的敏感性資料加密與解密，進而達到此功能。
驅動程式會先將敏感資料行中的資料進行加密，才會將資料傳遞至 SQL Server，並自動重寫查詢以將語意保留至應用程式。 同樣地，驅動程式會以透明的方式，將查詢結果中加密資料庫資料行所儲存的資料解密。 如需詳細資訊，請參閱 Always Encrypted (資料庫引擎) 和搭配使用 Always Encrypted 與 JDBC 驅動程式。
注意
僅搭配 Azure SQL Database 的 Microsoft JDBC Driver 6.0 for SQL Server 或更新版本，以及 SQL Server 2016 和更新版本才會支援 Always Encrypted。
Always Encrypted API 參考
針對使用一律加密的用戶端應用程式所用，JDBC 驅動程式 API 有幾項新項目及修改項目。
SQLServerConnection 類別
| 名稱 | 描述 |
|---|---|
| 新的連接字串關鍵字： columnEncryptionSetting |
columnEncryptionSetting=Enabled 會啟用連線的 Always Encrypted 功能，而 columnEncryptionSetting=Disabled 會予以停用。 接受的值為 Enabled/Disabled。 預設值為 Disabled。 |
| 新的連接字串關鍵字：(MS JDBC 7.4 及更新版本) keyVaultProviderClientId keyVaultProviderClientKey |
keyVaultProviderClientId=<ClientID>;keyVaultProviderClientKey=<ClientKey> 註冊 SQLServerColumnEncryptionAzureKeyVaultProvider 並使用 ClientID 和 ClientKey 值來從 Azure Key Vault 擷取資料行主要金鑰 |
新方法：public static void setColumnEncryptionTrustedMasterKeyPaths(Map<String, List\<String>> trustedKeyPaths)public static void updateColumnEncryptionTrustedMasterKeyPaths(String server, List\<String> trustedKeyPaths)public static void removeColumnEncryptionTrustedMasterKeyPaths(String server) |
可讓您為資料庫伺服器設定/更新/移除受信任的金鑰路徑清單。 如果驅動程式在處理應用程式查詢時接收到不在清單上的金鑰路徑，則查詢會失敗。 此屬性會提供額外保護，防範安全性攻擊傳送假的金鑰路徑入侵伺服器，從而導致金鑰存放區認證外洩。 |
新方法：public static Map<String, List\<String>> getColumnEncryptionTrustedMasterKeyPaths() |
會傳回資料庫伺服器的受信任金鑰路徑清單。 |
新方法：public static void registerColumnEncryptionKeyStoreProviders (Map\<String, SQLServerColumnEncryptionKeyStoreProvider> clientKeyStoreProviders) |
可讓您註冊自訂金鑰存放區提供者。 它是一個字典，會將金鑰存放區提供者名稱對應至金鑰存放區提供者實作。 若要使用 JVM 金鑰存放區，您需要使用 JVM 金鑰存放區認證將 SQLServerColumnEncryptionJVMKeyStoreProvider 物件具現化，並向驅動程式註冊它。 此提供者的名稱必須是 'MSSQL_JVM_KEYSTORE'。 若要使用 Azure Key Vault 存放區，您需要將 SQLServerColumnEncryptionAzureKeyStoreProvider 物件具現化，並向驅動程式加以註冊。 此提供者的名稱必須是 'AZURE_KEY_VAULT'。 |
新方法：public static void unregisterColumnEncryptionKeyStoreProviders (Map\<String, SQLServerColumnEncryptionKeyStoreProvider> clientKeyStoreProviders) |
可讓您清除將金鑰存放區提供者名稱對應至金鑰存放區提供者實作的字典，以取消註冊所有自訂金鑰存放區提供者。 |
public final boolean getSendTimeAsDatetime() |
傳回 sendTimeAsDatetime 連線屬性的設定。 |
public void setSendTimeAsDatetime(boolean sendTimeAsDateTimeValue) |
修改 sendTimeAsDatetime 連線屬性的設定。 |
SQLServerConnectionPoolProxy 類別
| 名稱 | 描述 |
|---|---|
public final boolean getSendTimeAsDatetime() |
傳回 sendTimeAsDatetime 連線屬性的設定。 |
public void setSendTimeAsDatetime(boolean sendTimeAsDateTimeValue) |
修改 sendTimeAsDatetime 連線屬性的設定。 |
SQLServerDataSource 類別
| 名稱 | 描述 |
|---|---|
public void setColumnEncryptionSetting(String columnEncryptionSetting) |
啟用/停用資料來源物件的一律加密功能。 預設值為 Disabled。 |
public String getColumnEncryptionSetting() |
擷取資料來源物件的一律加密功能設定。 |
public void setKeyStoreAuthentication(String keyStoreAuthentication) |
設定可識別金鑰存放區的名稱。 唯一支援的值是用來識別 Java 金鑰存放區的 JavaKeyStorePassword。 預設值是 null。 |
public String getKeyStoreAuthentication() |
取得資料來源物件之 keyStoreAuthentication 設定的值。 |
public void setKeyStoreSecret(String keyStoreSecret) |
設定 Java 金鑰存放區的密碼。 金鑰存放區和金鑰的密碼必須相同。 keyStoreAuthentication 必須搭配 JavaKeyStorePassword 設定。 |
public void setKeyStoreLocation(String keyStoreLocation) |
設定包含 Java 金鑰存放區檔案名稱的位置。 keyStoreAuthentication 必須搭配 JavaKeyStorePassword 設定。 |
public String getKeyStoreLocation() |
擷取 Java 金鑰存放區的 keyStoreLocation。 |
SQLServerColumnEncryptionJavaKeyStoreProvider 類別
Java 金鑰存放區的金鑰存放區提供者實作。 此類別可讓您將儲存在 Java 金鑰存放區中的憑證，當成資料行主要金鑰使用。
建構函式：
| 名稱 | 描述 |
|---|---|
public SQLServerColumnEncryptionJavaKeyStoreProvider (String keyStoreLocation, char[] keyStoreSecret) |
Java 金鑰存放區的金鑰存放區提供者。 |
方法：
| 名稱 | 描述 |
|---|---|
public byte[] decryptColumnEncryptionKey (String masterKeyPath, String encryptionAlgorithm, byte[] encryptedColumnEncryptionKey) |
解密資料行加密金鑰指定的加密值。 加密值應該使用憑證和指定的機碼路徑並使用指定的演算法加密。 金鑰路徑的格式應為下列其中一個： 指紋：<certificate_thumbprint> 別名：<certificate_alias> (覆寫 SQLServerColumnEncryptionKeyStoreProvider。 decryptColumnEncryptionKey(String, String, Byte[])。) |
public byte[] encryptColumnEncryptionKey (String masterKeyPath, String encryptionAlgorithm, byte[] plainTextColumnEncryptionKey) |
使用憑證和指定的金鑰路徑並使用指定的演算法加密資料行加密金鑰。 金鑰路徑的格式應為下列其中一個： 指紋：<certificate_thumbprint> 別名：<certificate_alias> (覆寫 SQLServerColumnEncryptionKeyStoreProvider。 encryptColumnEncryptionKey(String, String, Byte[])。) |
public boolean verifyColumnEncryptionKey (String masterKeyPath, boolean allowEnclaveComputations, byte[] signature) |
使用憑證驗證資料行加密金鑰的簽章。 金鑰路徑的格式應為下列其中一個： 指紋：<certificate_thumbprint> 別名：<certificate_alias> (覆寫 SQLServerColumnEncryptionKeyStoreProvider。 verifyColumnEncryptionKey(String, boolean, Byte[])。) |
public void setName (String name) |
設定此金鑰存放區提供者的名稱。 |
public String getName () |
取得此金鑰存放區提供者的名稱。 |
SQLServerColumnEncryptionAzureKeyVaultProvider 類別
Azure Key Vault 的金鑰存放區提供者實作。 此類別可讓您將儲存在 Azure Key Vault 中的金鑰作為資料行主要金鑰使用。
建構函式：
| 名稱 | 描述 |
|---|---|
public SQLServerColumnEncryptionAzureKeyVaultProvider () |
建構 SQLServerColumnEncryptionAzureKeyVaultProvider 以向 Azure Key Vault 進行驗證。 |
public SQLServerColumnEncryptionAzureKeyVaultProvider (String clientId) |
建構 SQLServerColumnEncryptionAzureKeyVaultProvider，以使用要求權杖的用戶端識別碼向 Azure Key Vault 庫進行驗證。 |
public SQLServerColumnEncryptionAzureKeyVaultProvider (String clientId, String clientKey) |
建構 SQLServerColumnEncryptionAzureKeyVaultProvider，以使用要求權杖的用戶端識別碼和金鑰向 Azure Key Vault 庫進行驗證。 |
public SQLServerColumnEncryptionAzureKeyVaultProvider (TokenCredential tokenCredential) |
建構 SQLServerColumnEncryptionAzureKeyVaultProvider，以使用提供的 TokenCredential 向 Azure Key Vault 庫進行驗證。 |
方法：
| 名稱 | 描述 |
|---|---|
public byte[] decryptColumnEncryptionKey (String masterKeyPath, String encryptionAlgorithm, byte[] encryptedColumnEncryptionKey) |
將加密的資料行加密金鑰 (CEK) 解密。 此解密是透過使用由主要金鑰路徑所指定之非對稱金鑰的 RSA 加密演算法來達成。 (覆寫 SQLServerColumnEncryptionKeyStoreProvider。 decryptColumnEncryptionKey(String, String, Byte[])。) |
public byte[] encryptColumnEncryptionKey (String masterKeyPath, String encryptionAlgorithm, byte[] columnEncryptionKey) |
透過將指定的資料行主要金鑰給予指定的演算法，來對資料行加密金鑰進行加密。 (覆寫 SQLServerColumnEncryptionKeyStoreProvider。 encryptColumnEncryptionKey(String, String, Byte[])。) |
public void setName (String name) |
設定此金鑰存放區提供者的名稱。 |
public String getName () |
取得此金鑰存放區提供者的名稱。 |
SQLServerKeyVaultAuthenticationCallback 介面
此介面包含適用於 Azure Key Vault 驗證的單一方法，其將由使用者實作。
方法：
| 名稱 | 描述 |
|---|---|
public String getAccessToken(String authority, String resource, String scope); |
必須覆寫方法。 方法是用來取得 Azure Key Vault 的存取權杖。 |
SQLServerColumnEncryptionKeyStoreProvider 類別
擴充此類別來實作自訂金鑰存放區提供者。
| 名稱 | 描述 |
|---|---|
| SQLServerColumnEncryptionKeyStoreProvider | 所有金鑰存放區提供者的基底類別。 自訂提供者必須衍生自此類別並覆寫其成員函式，然後使用 SQLServerConnection 予以註冊。 registerColumnEncryptionKeyStoreProviders()。 |
方法：
| 名稱 | 描述 |
|---|---|
public abstract byte[] decryptColumnEncryptionKey (String masterKeyPath, String encryptionAlgorithm, byte [] encryptedColumnEncryptionKey) |
用來將資料行加密金鑰的指定加密值解密的基底類別方法。 加密的值必須使用具有指定金鑰路徑的資料行主要金鑰和指定的演算法，進而加以加密。 |
public abstract byte[] encryptColumnEncryptionKey (String masterKeyPath, String encryptionAlgorithm, byte[] columnEncryptionKey) |
基底類別方法，使用具指定金鑰路徑的資料行主要金鑰，以及指定的演算法，進而將資料加密金鑰加密。 |
public abstract void setName(String name) |
設定此金鑰存放區提供者的名稱。 |
public abstract String getName() |
取得此金鑰存放區提供者的名稱。 |
SQLServerPreparedStatement 類別中之新的或多載的方法
| 名稱 | 描述 |
|---|---|
public void setBigDecimal(int parameterIndex, BigDecimal x, int precision, int scale)public void setObject(int parameterIndex, Object x, int targetSqlType, Integer precision, int scale)public void setObject(int parameterIndex, Object x, SQLType targetSqlType, Integer precision, Integer scale)public void setTime(int parameterIndex, java.sql.Time x, int scale)public void setTimestamp(int parameterIndex, java.sql.Timestamp x, int scale) public void setDateTimeOffset(int parameterIndex, microsoft.sql.DateTimeOffset x, int scale) |
這些方法會搭配精確度或小數位數引數 (或兩者) 進行多載，以針對需要精確度和小數位數資訊的特定資料類型支援 Always Encrypted。 |
public void setMoney(int parameterIndex, BigDecimal x)public void setSmallMoney(int parameterIndex, BigDecimal x)public void setUniqueIdentifier(int parameterIndex, String guid)public void setDateTime(int parameterIndex, java.sql.Timestamp x)public void setSmallDateTime(int parameterIndex, java.sql.Timestamp x) |
這些方法會新增 money、smallmoney、uniqueidentifier、datetime 及 smalldatetime 資料類型對 Always Encrypted 的支援。 現有的 setTimestamp() 方法是用於將參數值傳送到加密的 datetime2 資料行。 針對加密的 datetime 和 smalldatetime 資料行，請分別使用新的 setDateTime() 與 setSmallDateTime() 方法。 |
public final void setBigDecimal(int parameterIndex, BigDecimal x, int precision, int scale, boolean forceEncrypt)public final void setMoney(int parameterIndex, BigDecimal x, boolean forceEncrypt)public final void setSmallMoney(int parameterIndex, BigDecimal x, boolean forceEncrypt)public final void setBoolean(int parameterIndex, boolean x, boolean forceEncrypt)public final void setByte(int parameterIndex, byte x, boolean forceEncrypt)public final void setBytes(int parameterIndex, byte x[], boolean forceEncrypt)public final void setUniqueIdentifier(int parameterIndex, String guid, boolean forceEncrypt)public final void setDouble(int parameterIndex, double x, boolean forceEncrypt)public final void setFloat(int parameterIndex, float x, boolean forceEncrypt)public final void setInt(int parameterIndex, int value, boolean forceEncrypt)public final void setLong(int parameterIndex, long x, boolean forceEncrypt)public final setObject(int parameterIndex, Object x, int targetSqlType, Integer precision, int scale, boolean forceEncrypt)public final void setObject(int parameterIndex, Object x, SQLType targetSqlType, Integer precision, Integer scale, boolean forceEncrypt)public final void setShort(int parameterIndex, short x, boolean forceEncrypt)public final void setString(int parameterIndex, String str, boolean forceEncrypt)public final void setNString(int parameterIndex, String value, boolean forceEncrypt)public final void setTime(int parameterIndex, java.sql.Time x, int scale, boolean forceEncrypt)public final void setTimestamp(int parameterIndex, java.sql.Timestamp x, int scale, boolean forceEncrypt)public final void setDateTimeOffset(int parameterIndex, microsoft.sql.DateTimeOffset x, int scale, boolean forceEncrypt)public final void setDateTime(int parameterIndex, java.sql.Timestamp x, boolean forceEncrypt)public final void setSmallDateTime(int parameterIndex, java.sql.Timestamp x, boolean forceEncrypt)public final void setDate(int parameterIndex, java.sql.Date x, java.util.Calendar cal, boolean forceEncrypt)public final void setTime(int parameterIndex, java.sql.Time x, java.util.Calendar cal, boolean forceEncrypt)public final void setTimestamp(int parameterIndex, java.sql.Timestamp x, java.util.Calendar cal, boolean forceEncrypt) |
將具名參數設定為指定的 Java 值。 如果布林值 forceEncrypt 設定為 true，則只會在指定的資料行已加密，且在連線或在陳述式上啟用了 Always Encrypted 時，才會設定查詢參數。如果布林值 forceEncrypt 已設定為 false，驅動程式將不會在參數上強制加密。 |
SQLServerCallableStatement 類別中新的或多載的方法
| 名稱 | 描述 |
|---|---|
public void registerOutParameter(int parameterIndex, int sqlType, int precision, int scale)public void registerOutParameter(int parameterIndex, SQLType sqlType, int precision, int scale)public void registerOutParameter(String parameterName, int sqlType, int precision, int scale)public void registerOutParameter(String parameterName, SQLType sqlType, int precision, int scale)public void setBigDecimal(String parameterName, BigDecimal bd, int precision, int scale)public void setTime(String parameterName, java.sql.Time t, int scale)public void setTimestamp(String parameterName, java.sql.Timestamp t, int scale)public void setDateTimeOffset(String parameterName, microsoft.sql.DateTimeOffset t, int scale)public final void setObject(String sCol, Object x, int targetSqlType, Integer precision, int scale) |
這些方法會搭配精確度或小數位數引數 (或兩者) 進行多載，以針對需要精確度和小數位數資訊的特定資料類型支援 Always Encrypted。 |
public void setDateTime(String parameterName, java.sql.Timestamp x)public void setSmallDateTime(String parameterName, java.sql.Timestamp x)public void setUniqueIdentifier(String parameterName, String guid)public void setMoney(String parameterName, BigDecimal bd)public void setSmallMoney(String parameterName, BigDecimal bd)public Timestamp getDateTime(int index)public Timestamp getDateTime(String sCol)public Timestamp getDateTime(int index, Calendar cal)public Timestamp getSmallDateTime(int index)public Timestamp getSmallDateTime(String sCol)public Timestamp getSmallDateTime(int index, Calendar cal)public Timestamp getSmallDateTime(String name, Calendar cal)public BigDecimal getMoney(int index)public BigDecimal getMoney(String sCol)public BigDecimal getSmallMoney(int index)public BigDecimal getSmallMoney(String sCol) |
這些方法會新增 money、smallmoney、uniqueidentifier、datetime 及 smalldatetime 資料類型對 Always Encrypted 的支援。 現有的 setTimestamp() 方法是用於將參數值傳送到加密的 datetime2 資料行。 針對加密的 datetime 和 smalldatetime 資料行，請分別使用新的 setDateTime() 與 setSmallDateTime() 方法。 |
public void setObject(String parameterName, Object o, int n, int m, boolean forceEncrypt)public void setObject(String parameterName, Object obj, SQLType jdbcType, int scale, boolean forceEncrypt)public void setDate(String parameterName, java.sql.Date x, Calendar c, boolean forceEncrypt)public void setTime(String parameterName, java.sql.Time t, int scale, boolean forceEncrypt)public void setTime(String parameterName, java.sql.Time x, Calendar c, boolean forceEncrypt)public void setDateTime(String parameterName, java.sql.Timestamp x, boolean forceEncrypt)public void setDateTimeOffset(String parameterName, microsoft.sql.DateTimeOffset t, int scale, boolean forceEncrypt)public void setSmallDateTime(String parameterName, java.sql.Timestamp x, boolean forceEncrypt)public void setTimestamp(String parameterName, java.sql.Timestamp t, int scale, boolean forceEncrypt)public void setTimestamp(String parameterName, java.sql.Timestamp x, boolean forceEncrypt)public void setUniqueIdentifier(String parameterName, String guid, boolean forceEncrypt)public void setBytes(String parameterName, byte[] b, boolean forceEncrypt)public void setByte(String parameterName, byte b, boolean forceEncrypt)public void setString(String parameterName, String s, boolean forceEncrypt)public final void setNString(String parameterName, String value, boolean forceEncrypt)<br /><br /> public void setMoney(String parameterName, BigDecimal bd, boolean forceEncrypt)public void setSmallMoney(String parameterName, BigDecimal bd, boolean forceEncrypt)public void setBigDecimal(String parameterName, BigDecimal bd, int precision, int scale, boolean forceEncrypt)public void setDouble(String parameterName, double d, boolean forceEncrypt)public void setFloat(String parameterName, float f, boolean forceEncrypt)public void setInt(String parameterName, int i, boolean forceEncrypt)public void setLong(String parameterName, long l, boolean forceEncrypt)public void setShort(String parameterName, short s, boolean forceEncrypt)public void setBoolean(String parameterNames, boolean b, boolean forceEncrypt)public void setTimeStamp(String sCol, java.sql.Timestamp x, Calendar c, Boolean forceEncrypt) |
將具名參數設定為指定的 Java 值。 如果布林值 forceEncrypt 設定為 true，則只會在指定資料行已加密，且在連線或在陳述式上啟用了 Always Encrypted 時，才會設定查詢參數。 如果布林值 forceEncrypt 已設定為 false，驅動程式將不會在參數上強制加密。 |
SQLServerResultSet 類別中新的或多載的方法
| 名稱 | 描述 |
|---|---|
public String getUniqueIdentifier(int columnIndex)public String getUniqueIdentifier(String columnLabel)public java.sql.Timestamp getDateTime(int columnIndex) public java.sql.Timestamp getDateTime(String columnName) public java.sql.Timestamp getDateTime(int columnIndex, Calendar cal) public java.sql.Timestamp getDateTime(String colName, Calendar cal) public java.sql.Timestamp getSmallDateTime(int columnIndex) public java.sql.Timestamp getSmallDateTime(String columnName) public java.sql.Timestamp getSmallDateTime(int columnIndex, Calendar cal) public java.sql.Timestamp getSmallDateTime(String colName, Calendar cal) public BigDecimal getMoney(int columnIndex) public BigDecimal getMoney(String columnName) public BigDecimal getSmallMoney(int columnIndex) public BigDecimal getSmallMoney(String columnName) public void updateMoney(String columnName, BigDecimal x) public void updateSmallMoney(String columnName, BigDecimal x) public void updateDateTime(int index, java.sql.Timestamp x) public void updateSmallDateTime(int index, java.sql.Timestamp x) |
這些方法會新增 money、smallmoney、uniqueidentifier、datetime 及 smalldatetime 資料類型對 Always Encrypted 的支援。 現有的 updateTimestamp() 方法是用於更新加密的 datetime2 資料行。 針對加密的 datetime 與 smalldatetime 資料行，請分別使用新的 updateDateTime() 與 updateSmallDateTime() 方法。 |
public void updateBoolean(int index, boolean x, boolean forceEncrypt) public void updateByte(int index, byte x, boolean forceEncrypt) public void updateShort(int index, short x, boolean forceEncrypt) public void updateInt(int index, int x, boolean forceEncrypt) public void updateLong(int index, long x, boolean forceEncrypt) public void updateFloat(int index, float x, boolean forceEncrypt) public void updateDouble(int index, double x, boolean forceEncrypt) public void updateMoney(int index, BigDecimal x, boolean forceEncrypt) public void updateMoney(String columnName, BigDecimal x, boolean forceEncrypt) public void updateSmallMoney(int index, BigDecimal x, boolean forceEncrypt) public void updateSmallMoney(String columnName, BigDecimal x, boolean forceEncrypt) public void updateBigDecimal(int index, BigDecimal x, Integer precision, Integer scale, boolean forceEncrypt) public void updateString(int columnIndex, String stringValue, boolean forceEncrypt) public void updateNString(int columnIndex, String nString, boolean forceEncrypt) public void updateNString(String columnLabel, String nString, boolean forceEncrypt) public void updateBytes(int index, byte x[], boolean forceEncrypt) <br/><br/> public void updateDate(int index, java.sql.Date x, boolean forceEncrypt) public void updateTime(int index, java.sql.Time x, Integer scale, boolean forceEncrypt) public void updateTimestamp(int index, java.sql.Timestamp x, int scale, boolean forceEncrypt) public void updateDateTime(int index, java.sql.Timestamp x, Integer scale, boolean forceEncrypt) public void updateSmallDateTime(int index, java.sql.Timestamp x, Integer scale, boolean forceEncrypt) public void updateDateTimeOffset(int index, microsoft.sql.DateTimeOffset x, Integer scale, boolean forceEncrypt) public void updateUniqueIdentifier(int index, String x, boolean forceEncrypt) public void updateObject(int index, Object x, int precision, int scale, boolean forceEncrypt) public void updateObject(int index, Object obj, SQLType targetSqlType, int scale, boolean forceEncrypt) public void updateBoolean(String columnName, boolean x, boolean forceEncrypt) public void updateByte(String columnName, byte x, boolean forceEncrypt) public void updateShort(String columnName, short x, boolean forceEncrypt) public void updateInt(String columnName, int x, boolean forceEncrypt) public void updateLong(String columnName, long x, boolean forceEncrypt) public void updateFloat(String columnName, float x, boolean forceEncrypt) public void updateDouble(String columnName, double x, boolean forceEncrypt) <br/><br/> public void updateBigDecimal(String columnName, BigDecimal x, boolean forceEncrypt) public void updateBigDecimal(String columnName, BigDecimal x, Integer precision, Integer scale, boolean forceEncrypt) public void updateString(String columnName, String x, boolean forceEncrypt) public void updateBytes(String columnName, byte x[], boolean forceEncrypt) public void updateDate(String columnName, java.sql.Date x, boolean forceEncrypt) public void updateTime(String columnName, java.sql.Time x, int scale, boolean forceEncrypt) public void updateTimestamp(String columnName, java.sql.Timestamp x, int scale, boolean forceEncrypt) public void updateDateTime(String columnName, java.sql.Timestamp x, int scale, boolean forceEncrypt) public void updateSmallDateTime(String columnName, java.sql.Timestamp x, int scale, boolean forceEncrypt) public void updateDateTimeOffset(String columnName, microsoft.sql.DateTimeOffset x, int scale, boolean forceEncrypt) public void updateUniqueIdentifier(String columnName, String x, boolean forceEncrypt)public void updateObject(String columnName, Object x, int precision, int scale, boolean forceEncrypt)public void updateObject(String columnName, Object obj, SQLType targetSqlType, int scale, boolean forceEncrypt) |
將具名資料行更新為指定的 Java 值。 如果布林值 forceEncrypt 設定為 true，只會在資料行已加密，且在連線或在陳述式上啟用了 Always Encrypted，才會設定此資料行。如果布林值 forceEncrypt 設定為 false，驅動程式將不會在參數上強制加密。 |
microsoft.sql.Types 類別中的新類型
| 名稱 | 描述 |
|---|---|
| DATETIME、SMALLDATETIME、MONEY、SMALLMONEY、GUID | 在使用 setObject()/updateObject() API 方法將參數值傳送到加密的 datetime, smalldatetime, money, smallmoney, uniqueidentifier 資料行時，使用這些類型作為目標 SQL 類型。 |
SQLServerStatementColumnEncryptionSetting 列舉
指定讀取及寫入加密的資料行時，資料的傳送及接收方式。 根據您的特定查詢，當使用非加密的資料行時，略過 Always Encrypted 驅動程式的處理可能會降低對效能的影響。 這些設定不能用來略過加密並存取純文字資料。
語法：
Public enum SQLServerStatementColumnEncryptionSetting
成員：
| 名稱 | 描述 |
|---|---|
| UseConnectionSetting | 指定命令應該預設為連接字串中的 Always Encrypted 設定。 |
| 啟用 | 啟用查詢的 Always Encrypted。 |
| ResultSetOnly | 指定驅動程式中的 Always Encrypted 常式只應處理命令的結果。 當命令沒有需要加密的參數時，請使用這個值。 |
| 已停用 | 停用查詢的 Always Encrypted。 |
AE 的陳述式層級設定已新增至 SQLServerConnection 類別和 SQLServerConnectionPoolProxy 類別。 這些類別中的下列方法已搭配新的設定進行多載。
| 名稱 | 描述 |
|---|---|
public Statement createStatement(int nType, int nConcur, int statementHoldability, SQLServerStatementColumnEncryptionSetting stmtColEncSetting) |
建立會搭配指定類型、並行、保留性及資料行加密設定產生 ResultSet 物件的 Statement 物件。 |
public CallableStatement prepareCall(String sql, int nType, int nConcur, int statementHoldability, SQLServerStatementColumnEncryptionSetting stmtColEncSetting) |
建立具有會搭配指定類型、並行及保留性產生 ResultSet 物件之指定資料行加密設定的 CallableStatement 物件。 |
public PreparedStatement prepareStatement(String sql, int autogeneratedKeys, SQLServerStatementColumnEncryptionSetting stmtColEncSetting) |
建立 PreparedStatement 物件，其具有指定的資料行加密設定，能夠擷取自動產生的金鑰。 |
public PreparedStatement prepareStatement(String sql, String[] columnNames, SQLServerStatementColumnEncryptionSetting stmtColEncSetting) |
建立具有會搭配指定資料行名稱產生 ResultSet 物件之指定資料行加密設定的 PreparedStatement 物件。 |
public PreparedStatement prepareStatement(String sql, int[] columnIndexes, SQLServerStatementColumnEncryptionSetting stmtColEncSetting |
建立具有會搭配指定資料行索引產生 ResultSet 物件之指定資料行加密設定的 PreparedStatement 物件。 |
public PreparedStatement prepareStatement(String sql, int nType, int nConcur, int nHold, SQLServerStatementColumnEncryptionSetting stmtColEncSetting) |
建立具有會搭配指定類型、並行及保留性產生 ResultSet 物件之指定資料行加密設定的 PreparedStatement 物件。 |
注意
如果 Always Encrypted 已針對查詢停用，且該查詢具有需要加密的參數 (對應至已加密資料行的參數)，則該查詢將會失敗。
如果 Always Encrypted 已針對查詢停用，且該查詢傳回來自已加密資料行的結果，則該查詢將會傳回已加密的值。 已加密的值將具有 varbinary 資料類型。