Język

Włączanie powiadomień o zapytaniach

Aby używać powiadomień dotyczących zapytań, skonfiguruj bazę danych w celu ich obsługi i przyznaj podmiotowi zabezpieczeń bazy danych wymagane uprawnienia.

Aby korzystać z powiadomień dotyczących zapytań, musisz:

  • Włącz powiadomienia dotyczące zapytań dla bazy danych.

  • Upewnij się, że identyfikator użytkownika używany do nawiązywania połączenia z bazą danych ma niezbędne uprawnienia.

  • Użyj polecenia SqlCommand, aby wykonać prawidłową instrukcję SELECT z powiązanym obiektem SqlDependency lub SqlNotificationRequest.

  • Podaj kod, aby przetworzyć powiadomienie, jeśli monitorowane dane zmieniają się.

Wymagania dotyczące powiadomień dotyczących zapytań

Powiadomienia o zapytaniach są obsługiwane tylko dla instrukcji SELECT spełniających listę określonych wymagań. Poniższa tabela zawiera linki do dokumentacji usługi Service Broker i powiadomień zapytań w dokumentacji programu SQL Server.

SQL Server documentation (Dokumentacja programu SQL Server)

Włączanie powiadomień zapytań w celu uruchomienia przykładowego kodu

Aby włączyć usługę Service Broker w AdventureWorks bazie danych przy użyciu SQL Server Management Studio, wykonaj następującą instrukcję Transact-SQL:

ALTER DATABASE AdventureWorks SET ENABLE_BROKER;

Aby przykłady powiadomień działały poprawnie, następujące polecenia Transact-SQL muszą być wykonane na serwerze bazy danych.

CREATE QUEUE ContactChangeMessages;

CREATE SERVICE ContactChangeNotifications
  ON QUEUE ContactChangeMessages
([http://schemas.microsoft.com/SQL/Notifications/PostQueryNotification]);

Uprawnienia zapytań o powiadomienia

Przyznaj podmiotowi zabezpieczeń bazy danych SUBSCRIBE QUERY NOTIFICATIONS i usłudze Service Broker uprawnienia wymagane przez konfigurację kolejki. Na przykład zastąp symbol zastępczy istniejącym użytkownikiem bazy danych:

GRANT SUBSCRIBE QUERY NOTIFICATIONS TO [<database_user>];

Współczesna platforma .NET nie obsługuje zabezpieczeń dostępu do kodu. Nie używaj SqlClientPermission.Demand do autoryzowania powiadomień o zapytaniach; zamiast tego skonfiguruj uprawnienia bazy danych.

Wybieranie obiektu powiadomienia

Obsługa powiadomień o zapytaniach zapewnia dwa obiekty do przetwarzania powiadomień: SqlDependency i SqlNotificationRequest. Użyj SqlDependency, aby odbierać zdarzenia zmiany i unieważniać pamięć podręczną aplikacji. Użyj SqlNotificationRequest, jeśli musisz zaimplementować własny odbiornik powiadomień.

Important

Nie używaj System.Data.SqlClient do nowych prac programistycznych. Zamiast tego użyj Microsoft.Data.SqlClient. Klasa ASP.NET Framework SqlCacheDependency wymaga System.Data.SqlClient i nie jest zintegrowana z Microsoft.Data.SqlClient. W przypadku nowych aplikacji Microsoft.Data.SqlClient obsłuż SqlDependency.OnChange i zaktualizuj pamięć podręczną za pośrednictwem interfejsu API pamięci podręcznej aplikacji.

Korzystanie z programu SqlDependency

Aby można było używać SqlDependencyprogramu , należy włączyć usługę Service Broker dla używanej bazy danych programu SQL Server, a użytkownicy muszą mieć uprawnienia do odbierania powiadomień. Obiekty usługi Service Broker, takie jak kolejka powiadomień, są wstępnie zdefiniowane.

Ponadto SqlDependency automatycznie uruchamia wątek roboczy do przetwarzania powiadomień, gdy są umieszczane w kolejce. Analizuje również komunikat Service Broker, przekazując informacje w postaci danych argumentu zdarzenia. SqlDependency należy zainicjować przez wywołanie Start metody w celu ustanowienia zależności z bazą danych. Jest to metoda statyczna, która musi być wywoływana tylko raz podczas inicjowania aplikacji dla każdego wymaganego połączenia z bazą danych. Metodę Stop należy wywołać po zakończeniu działania aplikacji dla każdego utworzonego połączenia zależności.

Korzystanie z metody SqlNotificationRequest

Z kolei SqlNotificationRequest wymaga samodzielnego zaimplementowania całej infrastruktury nasłuchiwania. Ponadto należy zdefiniować wszystkie pomocnicze obiekty usługi Service Broker, takie jak kolejka, usługa i typy komunikatów obsługiwane przez kolejkę. Zastosowanie podejścia ręcznego jest przydatne, jeśli aplikacja wymaga specjalnych komunikatów lub zachowań dotyczących powiadomień, bądź jest częścią większej aplikacji Service Broker.

Zobacz także