SQLGetConnectAttr

適用於： SQL Server Azure SQL 資料庫 Azure SQL 受控執行個體 Azure Synapse Analytics Analytics Platform System (PDW)

SQL Server Native Client ODBC 驅動程式會定義驅動程式特定的連接屬性。 部分屬性可供 SQLGetConnectAttr 使用，而且函式可用來報告其目前設定。 在建立連接或使用 SQLSetConnectAttr 設定屬性之前，不保證會保證這些屬性所報告的值。

本主題列出只讀屬性。 如需其他 SQL Server Native Client ODBC 驅動程式特定連接屬性的相關信息，請參閱 SQLSetConnectAttr。

SQL_COPT_SS_CONNECTION_DEAD

SQL_COPT_SS_CONNECTION_DEAD屬性會報告與伺服器的連線狀態。 驅動程式會查詢網路以取得連線的目前狀態。

注意

標準 ODBC 連接屬性SQL_ATTR_CONNECTION_DEAD會傳回連接的最新狀態。 這可能不是目前的連線狀態。

值	Description
SQL_CD_TRUE	伺服器的連線已遺失。
SQL_CD_FALSE	連接已開啟，可供語句處理使用。

SQL_COPT_SS_CLIENT_CONNECTION_ID

SQL_COPT_SS_CLIENT_CONNECTION_ID屬性會擷取用戶端連線標識碼，然後可用來尋找：

• 啟用時，XEvents 記錄中的診斷資訊。

• 連接通道緩衝區中的連線錯誤資訊。

• 啟用時，數據存取追蹤記錄中的診斷資訊。

如需詳細資訊，請參閱 存取擴充事件記錄檔中的診斷資訊。

值	Description
SQL_ERROR	連接失敗。
SQL_SUCCESS	線上成功。 用戶端連線標識碼會在輸出緩衝區中找到。

SQL_COPT_SS_PERF_DATA

SQL_COPT_SS_PERF_DATA屬性會傳回包含目前驅動程式效能統計數據之 SQLPERF 結構的指標。 如果未啟用效能記錄，SQLGetConnectAttr 會傳回 NULL。 驅動程式不會動態更新 SQLPERF 結構中的統計數據。 每次需要重新整理效能統計數據時，呼叫 SQLGetConnectAttr 。

值	Description
NULL	未啟用效能記錄。
任何其他值	SQLPERF 結構的指標。

SQL_COPT_SS_PERF_QUERY

如果已啟用長時間執行的查詢記錄，SQL_COPT_SS_PERF_QUERY屬性會傳回TRUE。 如果查詢記錄不是使用中，要求會傳回 FALSE。

SQL_COPT_SS_USER_DATA

SQL_COPT_SS_USER_DATA屬性會擷取用戶數據指標。 用戶數據會儲存在用戶端擁有的記憶體中，並記錄每個連線。 如果未設定用戶數據指標，則會傳回SQL_UD_NOTSET NULL 指標。

值	Description
SQL_UD_NOTSET	未設定用戶數據指標。
任何其他值	用戶數據的指標。

服務主體名稱的 SQLGetConnectAttr 支援 （SPN）

SQLGetConnectAttr 可用來查詢新連接屬性的值，SQL_COPT_SS_SERVER_SPN、SQL_COPT_SS_FAILOVER_PARTNER_SPN、SQL_COPT_SS_MUTUALLY_AUTHENTICATED和SQL_COPT_SS_INTEGRATED_AUTHENTICATION_METHOD。 （SQLGetConnectOption 也可用來查詢這些值。

SQL_COPT_SS_INTEGRATED_AUTHENTICATION_METHOD僅適用於使用 Windows 驗證的開啟連線。

如果未設定SQL_COPT_SS_SERVER_SPN或SQL_COPT_SS_FAILOVER_PARTNER，則會傳回預設值 （空字串）。

如需SPN的詳細資訊，請參閱用戶端連接 （ODBC） 中的服務主體名稱 （SPN）。

另請參閱

SQLGetConnectAttr 函式
ODBC API 實作詳細數據
SET QUOTED_IDENTIFIER (Transact-SQL)
SET ANSI_NULLS (Transact-SQL)
SET ANSI_PADDING (Transact-SQL)
SET ANSI_WARNINGS (Transact-SQL)