JDBC 驅動程式的備妥陳述式中繼資料快取
此文章提供這兩個變更的相關資訊，實作之後可強化驅動程式的效能。
備妥陳述式的未準備批次處理
從 6.1.6-preview 版開始，效能的改善已透過將伺服器來回行程降至 SQL Server 來實作。 先前，針對每個 prepareStatement 查詢，也會傳送對 unprepare 的呼叫。 現在，驅動程式會批次處理 unprepare 查詢，最高可達閾值 "ServerPreparedStatementDiscardThreshold"，其預設值為 10。
注意
使用者可以使用下列方法變更預設值：setServerPreparedStatementDiscardThreshold(int value)
從 6.1.6-preview 導入的另一項變更是，在此版本之前，驅動程式一律會呼叫 sp_prepexec。 現在，在第一次執行備妥的陳述式時，驅動程式會呼叫 sp_executesql，而在之後則會執行 sp_prepexec 並為其指派控制代碼。 在 這裡可以找到更多詳細資訊。
從 11.2 版開始，在初始 sp_executesql 呼叫之後，驅動程式可以根據 prepareMethod 連接字串屬性中指定的值，執行 sp_prepare 或 sp_prepexec 進行其他呼叫。 如需詳細資訊，請參閱設定連線屬性。
注意
使用者可以使用下列方法，將 enablePrepareOnFirstPreparedStatementCall 設定為 true，以便將預設行為變更為舊版的一律呼叫 sp_prepexec：setEnablePrepareOnFirstPreparedStatementCall(boolean value)
與這項變更一起引入之新 API 的清單，適用於備妥陳述式的未準備批次處理
SQLServerConnection
| 新的方法 | 描述 |
|---|---|
| int getDiscardedServerPreparedStatementCount() | 傳回目前未完成未準備動作的數目。 |
| void closeUnreferencedPreparedStatementHandles() | 強制執行任何未完成捨棄備妥陳述式的未準備要求。 |
| boolean getEnablePrepareOnFirstPreparedStatementCall() | 傳回特定連線執行個體的行為。 如果為 false，則第一次執行會呼叫 sp_executesql，而且不會準備陳述式。 如果發生第二次執行，便會呼叫 sp_prepare 或 sp_prepexec，實際上會設定已備妥的陳述式控制代碼。 稍後的執行會呼叫 sp_execute。 如果該陳述式僅執行一次，則此行為無需在備妥陳述式結束時使用 sp_unprepare。 您可以藉由呼叫 setDefaultEnablePrepareOnFirstPreparedStatementCall() 來變更這個選項的預設值。 |
| void setEnablePrepareOnFirstPreparedStatementCall(boolean value) | 指定特定連線執行個體的行為。 如果值為 false，則第一次執行會呼叫 sp_executesql，而且不會準備陳述式。 如果發生第二次執行，便會呼叫 sp_prepare 或 sp_prepexec，實際上會設定已備妥的陳述式控制代碼。 稍後的執行會呼叫 sp_execute。 如果該陳述式僅執行一次，則此行為無需在備妥陳述式結束時使用 sp_unprepare。 |
| int getServerPreparedStatementDiscardThreshold() | 傳回特定連線執行個體的行為。 此設定可控制在執行清理伺服器上未完成控制代碼的呼叫之前，每個連線可以有多少個未完成的捨棄動作 (sp_unprepare)。 如果設定為 <= 1，就會在備妥陳述式一結束時，立即執行取消準備動作。 如果將其設定為 {@literal >} 1，則會將這些呼叫一併進行批次處理，以避免太常呼叫 sp_unprepare 所造成的額外負荷。 您可以藉由呼叫 getDefaultServerPreparedStatementDiscardThreshold() 來變更這個選項的預設值。 |
| void setServerPreparedStatementDiscardThreshold(int value) | 指定特定連線執行個體的行為。 此設定可控制在執行清理伺服器上未完成控制代碼的呼叫之前，每個連線可以有多少個未完成的捨棄動作 (sp_unprepare)。 如果設定為 <= 1，就會在備妥陳述式一結束時，立即執行取消準備動作。 如果將其設定為 > 1，則會將這些呼叫一併進行批次處理，以避免太常呼叫 sp_unprepare 所造成的額外負荷。 |
SQLServerDataSource
| 新的方法 | 描述 |
|---|---|
| void setEnablePrepareOnFirstPreparedStatementCall(boolean enablePrepareOnFirstPreparedStatementCall) | 如果此設定為 false，則已備妥陳述式的第一次執行會呼叫 sp_executesql，而且不會備妥陳述式。 如果發生第二次執行，便會呼叫 sp_prepare 或 sp_prepexec，實際上會設定已備妥的陳述式控制代碼。 稍後的執行會呼叫 sp_execute。 如果該陳述式僅執行一次，則此行為無需在備妥陳述式結束時使用 sp_unprepare。 |
| boolean getEnablePrepareOnFirstPreparedStatementCall() | 如果此設定傳回 false，則已備妥陳述式的第一次執行會呼叫 sp_executesql，而且不會備妥陳述式。 如果發生第二次執行，便會呼叫 sp_prepare 或 sp_prepexec，實際上會設定已備妥的陳述式控制代碼。 稍後的執行會呼叫 sp_execute。 如果該陳述式僅執行一次，則此行為無需在備妥陳述式結束時使用 sp_unprepare。 |
| void setServerPreparedStatementDiscardThreshold(int serverPreparedStatementDiscardThreshold) | 此設定可控制在執行清理伺服器上未完成控制代碼的呼叫之前，每個連線可以有多少個未完成的捨棄動作 (sp_unprepare)。 如果設定為 <= 1，就會在備妥陳述式一結束時，立即執行取消準備動作。 如果將其設定為 {@literal >} 1，則會將這些呼叫一併進行批次處理，以避免太常呼叫 sp_unprepare 所造成的額外負荷 |
| int getServerPreparedStatementDiscardThreshold() | 此設定可控制在執行清理伺服器上未完成控制代碼的呼叫之前，每個連線可以有多少個未完成的捨棄動作 (sp_unprepare)。 如果設定為 <= 1，就會在備妥陳述式一結束時，立即執行取消準備動作。 如果將其設定為 {@literal >} 1，則會將這些呼叫一併進行批次處理，以避免太常呼叫 sp_unprepare 所造成的額外負荷。 |
已備妥的陳述式中繼資料快取
從 6.3.0-preview 版開始，適用於 SQL Server 的 Microsoft JDBC 驅動程式支援備妥陳述式快取。 在 v6.3.0-preview 之前，如果有人執行已經備妥並儲存在快取中的查詢，則再次呼叫相同的查詢並不會導致準備該查詢。 現在，驅動程式會查閱快取中的查詢，並尋找控制代碼，然後使用 sp_execute 加以執行。
備妥陳述式中繼資料快取預設為停用狀態。 若要啟用，您必須針對連線物件呼叫下列方法：
setStatementPoolingCacheSize(int value) //value is the desired cache size (any value bigger than 0)
setDisableStatementPooling(boolean value) //false allows the caching to take place
例如：connection.setStatementPoolingCacheSize(10)connection.setDisableStatementPooling(false)
與這項變更一起引入之新 API 的清單，適用於備妥陳述式中繼資料快取
SQLServerConnection
| 新的方法 | 描述 |
|---|---|
| void setDisableStatementPooling(boolean value) | 將陳述式共用設定為 true 或 false。 |
| boolean getDisableStatementPooling() | 如果陳述式共用遭到停用，則傳回 true。 |
| void setStatementPoolingCacheSize(int value) | 指定此連線之備妥陳述式快取的大小。 小於 1 的值表示沒有快取。 |
| int getStatementPoolingCacheSize() | 傳回此連線備妥陳述式快取的大小。 小於 1 的值表示沒有快取。 |
| int getStatementHandleCacheEntryCount() | 傳回目前共用備妥陳述式控制代碼的數目。 |
| boolean isPreparedStatementCachingEnabled() | 無論陳述式共用是否已針對此連線啟用。 |
SQLServerDataSource
| 新的方法 | 描述 |
|---|---|
| void setDisableStatementPooling(boolean disableStatementPooling) | 將陳述式共用設定為 true 或 false |
| boolean getDisableStatementPooling() | 如果陳述式共用遭到停用，則傳回 true。 |
| void setStatementPoolingCacheSize(int statementPoolingCacheSize) | 指定此連線之備妥陳述式快取的大小。 小於 1 的值表示沒有快取。 |
| int getStatementPoolingCacheSize() | 傳回此連線備妥陳述式快取的大小。 小於 1 的值表示沒有快取。 |