共用方式為


使用查詢通知

適用於:SQL Server

下載 OLE DB 驅動程式

查詢通知是在 SQL Server 2005 (9.x) 和 OLE DB Driver for SQL Server 中導入的。 查詢通知是根據 SQL Server 2005 (9.x) 中引進的 SQL Service Broker 基礎結構而建置,可讓應用程式在資料變更時收到通知。 此功能對於從資料庫中提供資訊快取的應用程式 (如 Web 應用程式),及需要在來源資料變更時收到通知的應用程式來說很有用。

當查詢的底層資料變更時,您可以使用查詢通知,在指定的逾時期間要求通知。 要求會指定通知選項,其中包含服務名稱、訊息文字和伺服器的逾時值。 通知會透過 Service Broker 佇列傳遞,應用程式會輪詢此佇列以查看是否有可用的通知。

查詢通知選項字串的語法為:

service=<service-name>[;(local database=<database> | broker instance=<broker instance>)]

例如:

service=mySSBService;local database=mydb

通知訂閱的存留時間會超過開始這些訂閱的程序。 這是因為應用程式可以建立通知訂閱,然後結束。 訂閱仍會保持有效,而如果資料在指定的逾時期間內變更,就會發生通知。 通知會由執行的查詢、通知選項和訊息文字來識別。 您可以將其逾時值設定為零來取消通知。

通知只會傳送一次。 若要持續收到資料變更的通知,必須在處理過每個通知之後重新執行查詢,以建立新的訂閱。

OLE DB Driver for SQL Server 應用程式通常會使用 Transact-SQL RECEIVE 命令來接收通知。 此應用程式會使用此命令,從與通知選項中所指定服務相關聯的佇列讀取通知。

注意

您必須在需要通知的查詢中限定資料表名稱。 例如: dbo.myTable 。 資料表名稱必須使用兩部分的名稱來加以限定。 如果使用三或四部份的名稱,則訂閱無效。

通知基礎結構是依照 SQL Server 2005 (9.x) 中引進的佇列功能而建立。 一般而言,在伺服器所產生的通知會透過這些佇列傳送,以供稍後處理。

若要使用查詢通知,伺服器上必須有佇列和服務。 這些項目可以使用類似下列的 Transact-SQL 命令來建立:

CREATE QUEUE myQueue
CREATE SERVICE myService ON QUEUE myQueue
([https://schemas.microsoft.com/SQL/Notifications/PostQueryNotification])

注意

服務必須使用預先定義的合約,如上所示。

OLE DB Driver for SQL Server

OLE DB Driver for SQL Server 支援在資料列集修改時使用取用者通知。 使用者會在資料列集修改的每個階段以及嘗試進行任何變更時收到通知。

注意

使用 ICommand::Execute 將通知查詢傳遞至伺服器,是使用 OLE DB Driver for SQL Server 訂閱查詢通知的唯一有效方法。

DBPROPSET_SQLSERVERROWSET 屬性集

為了透過 OLE DB 支援查詢通知,OLE DB Driver for SQL Server 會將下列屬性新增至 DBPROPSET_SQLSERVERROWSET 屬性集。

名稱 類型​​ 描述
SSPROP_QP_NOTIFICATION_TIMEOUT VT_UI4 查詢通知要維持使用中的秒數。

預設值為 432,000 秒 (5 天)。 最小值為 1 秒,最大值為 2^31-1 秒。
SSPROP_QP_NOTIFICATION_MSGTEXT VT_BSTR 通知的訊息文字。 這是使用者定義的文字,而且沒有預先定義的格式。

根據預設,字串是空的。 請使用 1 到 2000 個字元來指定訊息。
SSPROP_QP_NOTIFICATION_OPTIONS VT_BSTR 查詢通知選項。 這些選項是使用 name=value 語法在字串中指定。 使用者負責建立此服務以及從佇列讀取通知。

預設值是空字串。

系統永遠都會認可通知訂閱。 無論陳述式是以使用者交易或自動認可方式執行,也無論陳述式在其中執行的交易是否已經認可或回復,都會發生這個情況。 伺服器通知會在發生下列任何無效通知條件時觸發:基礎資料或結構描述變更,或達到逾時期限 (視何者為先)。

通知註冊會在引發之後立刻刪除。 因此在接到通知後,應用程式必須再次訂閱,才能取得進一步的更新。

其他的連接或執行緒可以檢查目的地佇列是否有通知。 例如:

WAITFOR (RECEIVE * FROM MyQueue); -- Where MyQueue is the queue name.

注意

SELECT * 不會刪除佇列中的項目。 不過,RECEIVE * FROM 會刪除。 如果佇列是空的,這麼做會使伺服器延滯。 如果呼叫時有佇列項目,則會立即傳回這些項目。 否則,呼叫會等到建立佇列項目為止。

RECEIVE * FROM MyQueue

如果佇列是空的,這個陳述式會立即傳回空的結果集。 否則會傳回所有佇列通知。

如果 SSPROP_QP_NOTIFICATION_MSGTEXTSSPROP_QP_NOTIFICATION_OPTIONS 為非 Null 且非空白,則會將包含以上定義的三個屬性的查詢通知 TDS 標頭傳送至伺服器。 這個標頭會隨著每次執行命令一起傳送。 如果其中一個屬性為 Null (或空白),則不會傳送標頭並引發 DB_E_ERRORSOCCURRED (如果屬性同時標示為選擇性,則會引發 DB_S_ERRORSOCCURRED)。 接著,狀態值會設為 DBPROPSTATUS_BADVALUE。 在執行和準備時會進行驗證。 同樣地,當針對 SQL Server 2005 (9.x) 之前的 SQL Server 版本連線設定查詢通知屬性時,會引發 DB_S_ERRORSOCCURED。 此案例中的狀態值為 DBPROPSTATUS_NOTSUPPORTED

開始訂用帳戶並不保證未來的訊息能成功傳遞。 此外,系統也不會檢查所指定服務名稱的有效性。

注意

準備陳述式永遠不會導致起始訂閱。 只有執行陳述式才會完成起始。 查詢通知不會因為使用 OLE DB 核心服務而受到影響。

如需有關 DBPROPSET_SQLSERVERROWSET 屬性集的詳細資訊,請參閱資料列集屬性和行為

另請參閱

OLE DB Driver for SQL Server 功能