Trabajar con notificaciones de consulta
Se aplica a: SQL Server
Las notificaciones de consulta se presentaron en SQL Server 2005 (9.x) y OLE DB Driver for SQL Server. Las notificaciones de consulta, creadas en la infraestructura de SQL Service Broker introducida en SQL Server 2005 (9.x), permiten notificar a las aplicaciones si los datos han cambiado. Esta característica es útil para las aplicaciones que proporcionan una caché de información de una base de datos, como una aplicación web, y necesitan recibir notificaciones si se modifican los datos de origen.
Mediante las notificaciones de consulta, el usuario puede solicitar notificaciones dentro de un período de tiempo de espera especificado si se modifican los datos subyacentes de una consulta. La solicitud especifica las opciones de notificación, entre las que se incluyen el nombre del servicio, el texto del mensaje y el valor de tiempo de espera para el servidor. Las notificaciones se entregan a través de una cola de Service Broker que las aplicaciones pueden sondear de cara a las notificaciones disponibles.
La sintaxis de la cadena de opciones de notificación de consulta es la siguiente:
service=<service-name>[;(local database=<database> | broker instance=<broker instance>)]
Por ejemplo:
service=mySSBService;local database=mydb
Las suscripciones de notificación duran más que el proceso que las inicia. Esto se debe a que una aplicación puede crear una suscripción de notificación y, después, finalizar. La suscripción sigue siendo válida y la notificación se produce si los datos cambian dentro del período de tiempo de espera especificado. Una notificación se identifica mediante la consulta ejecutada, las opciones de notificación y el texto del mensaje. Puede cancelarla estableciendo su valor de tiempo de espera en cero.
Las notificaciones se envían una sola vez. Para obtener notificaciones continuas de cambios de datos, cree una nueva suscripción ejecutando de nuevo la consulta después de procesar cada notificación.
Las aplicaciones de OLE DB Driver for SQL Server suelen recibir notificaciones mediante el comando de Transact-SQL RECEIVE. Usa este comando para leer notificaciones desde la cola asociada al servicio especificado en las opciones de notificación.
Nota:
Los nombres de tabla deben calificarse en las consultas para las que se requiere notificación. Por ejemplo, dbo.myTable
. Las tablas deben calificarse con nombres de dos partes. La suscripción no será válida si se usan nombres de tres o cuatro partes.
La infraestructura de notificación se crea a partir una característica de colas introducida en SQL Server 2005 (9.x). Normalmente, las notificaciones generadas en el servidor se envían a través de estas colas para procesarse más adelante.
Para poder usar notificaciones de consulta, debe haber una cola y un servicio en el servidor. Estos elementos se pueden crear con el comando de Transact-SQL, similar a los siguientes:
CREATE QUEUE myQueue
CREATE SERVICE myService ON QUEUE myQueue
([https://schemas.microsoft.com/SQL/Notifications/PostQueryNotification])
Nota:
El servicio debe usar el contrato predefinido, tal y como se indicó anteriormente.
Controlador OLE DB para SQL Server
OLE DB Driver for SQL Server admite las notificaciones de los consumidores tras la modificación del conjunto de filas. El consumidor recibe una notificación en cada fase de modificación del conjunto de filas y ante cualquiera intento de cambio.
Nota:
Pasar una consulta de notificación al servidor con ICommand::Execute es la única forma válida de suscribirse a notificaciones de consulta con el controlador OLE DB para SQL Server.
Conjunto de propiedades DBPROPSET_SQLSERVERROWSET
Para admitir notificaciones de consulta mediante OLE DB, OLE DB Driver for SQL Server agrega las siguientes propiedades nuevas al conjunto de propiedades DBPROPSET_SQLSERVERROWSET
.
Nombre | Escribir | Descripción |
---|---|---|
SSPROP_QP_NOTIFICATION_TIMEOUT | VT_UI4 | Número de segundos que la notificación de consulta va a permanecer activa. El valor predeterminado es 432 000 segundos (5 días). El valor mínimo es 1 segundo y el valor máximo es 2^31-1 segundos. |
SSPROP_QP_NOTIFICATION_MSGTEXT | VT_BSTR | Texto del mensaje de la notificación. Es un texto definido por el usuario y no tiene ningún formato predefinido. De forma predeterminada, la cadena está vacía. Especifique un mensaje utilizando entre 1 y 2000 caracteres. |
SSPROP_QP_NOTIFICATION_OPTIONS | VT_BSTR | Opciones de notificación de consulta. Estas opciones se especifican en una cadena con la sintaxis nombre=valor. El usuario es responsable de la creación del servicio y de la lectura de las notificaciones fuera de la cola. El valor predeterminado es una cadena vacía. |
La suscripción de notificación se confirma siempre. Esto ocurre independientemente de que la instrucción se haya ejecutado en una transacción de usuario o en una confirmación automática, o de que la transacción en la que se haya ejecutado la instrucción se haya confirmado o revertido. La notificación del servidor se activa ante cualquiera de las siguientes condiciones de notificación no válida: cambio de esquema o datos subyacentes o cuando se alcanza el período de tiempo de espera, lo que ocurra antes.
Los registros de notificación se eliminan en cuanto se activan. Por lo tanto, al recibir las notificaciones, la aplicación debe suscribirse de nuevo en caso de que deseen obtenerse actualizaciones posteriores.
Otra conexión o subproceso puede comprobar las notificaciones en la cola de destino. Por ejemplo:
WAITFOR (RECEIVE * FROM MyQueue); -- Where MyQueue is the queue name.
Nota
SELECT *
no elimina la entrada de la cola. Sin embargo, RECEIVE * FROM
sí lo hace. Esto detiene un subproceso del servidor si la cola está vacía. Si hay entradas de cola en el momento de la llamada, se devuelven inmediatamente. De lo contrario, la llamada espera hasta que se realiza una entrada de cola.
RECEIVE * FROM MyQueue
Esta instrucción devuelve inmediatamente un conjunto de resultados vacío si la cola está vacía. De lo contrario, devuelve todas las notificaciones en cola.
Si SSPROP_QP_NOTIFICATION_MSGTEXT
y SSPROP_QP_NOTIFICATION_OPTIONS
no son NULL ni están vacíos, se envía el encabezado TDS de notificaciones de consulta que incluye las tres propiedades definidas anteriormente al servidor. Este encabezado se envía con cada ejecución del comando. Si uno de ellos es NULL (o está vacío), el encabezado no se enviará y se generará DB_E_ERRORSOCCURRED
(o se generará DB_S_ERRORSOCCURRED
, si ambas propiedades están marcadas como opcionales). El valor de estado se establece entonces en DBPROPSTATUS_BADVALUE
. La validación se produce tras la ejecución y preparación. Del mismo modo, DB_S_ERRORSOCCURED
se genera cuando las propiedades de la notificación de consulta se han configurado para conexiones a versiones de SQL Server anteriores a SQL Server 2005 (9.x). En este caso, el valor de estado es DBPROPSTATUS_NOTSUPPORTED
.
El inicio de una suscripción no garantiza que los mensajes futuros se entreguen correctamente. Además, no se realiza ninguna comprobación de validez del nombre de servicio especificado.
Nota:
La preparación de instrucciones nunca hará que se inicie la suscripción. Solo la ejecución de instrucciones conseguirá el inicio. Las notificaciones de consulta no se ven afectadas por el uso de los servicios principales de OLE DB.
Para obtener más información sobre el conjunto de propiedades DBPROPSET_SQLSERVERROWSET
, consulte Propiedades y comportamientos de conjuntos de filas.
Consulte también
Comentarios
https://aka.ms/ContentUserFeedback.
Proximamente: Ao longo de 2024, retiraremos gradualmente GitHub Issues como mecanismo de comentarios sobre o contido e substituirémolo por un novo sistema de comentarios. Para obter máis información, consulte:Enviar e ver os comentarios