SQLGetConnectAttr

  • 發行項

適用於：SQL ServerAzure SQL DatabaseAzure SQL 受控執行個體Azure Synapse AnalyticsAnalytics 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)