CREATE CONTRACT (Transact-SQL)
Crea un nuevo contrato. Un contrato define los tipos de mensaje usados en una conversación de Service Broker y también determina qué lado de la conversación puede enviar mensajes de ese tipo. Cada conversación obedece a un contrato. El servicio iniciador especifica el contrato para la conversación cuando se inicia la conversación. El servicio de destino especifica los contratos que el servicio de destino acepta para conversaciones.
.gif "Icono de vínculo a temas")
Sintaxis
CREATE CONTRACT contract_name
[ AUTHORIZATION owner_name ]
( { { message_type_name | [ DEFAULT ] }
SENT BY { INITIATOR | TARGET | ANY }
} [ ,...n] )
[ ; ]
Argumentos
contract_name
Es el nombre del contrato que se va a crear. Se crea un contrato nuevo en la base de datos actual, que pertenece a la entidad de seguridad especificada en la cláusula AUTHORIZATION. No se pueden especificar nombres de servidor, base de datos o esquema. contract_name puede contener 128 caracteres, como máximo.Nota
No cree un contrato que utilice la palabra clave ANY para contract_name. Cuando especifica ANY para un nombre de contrato en CREATE BROKER PRIORITY, la prioridad se considera para todos los contratos. No se limita a un contrato cuyo nombre sea ANY.
AUTHORIZATION owner_name
Establece el propietario del contrato en el usuario o la función de la base de datos que se ha especificado. Cuando el usuario actual es dbo o sa, owner_name puede ser el nombre de cualquier usuario o función válidos. En caso contrario, owner_name debe ser el nombre del usuario actual, el nombre de un usuario para el que el usuario actual tiene permisos de suplantación o el nombre de una función a la que pertenece el usuario actual. Si se omite esta cláusula, el contrato pertenece al usuario actual.message_type_name
Es el nombre de un tipo de mensaje que se incluirá como parte del contrato.SENT BY
Especifica qué extremo puede enviar un mensaje del tipo de mensaje indicado. Los contratos documentan los mensajes que pueden usar los servicios para tener determinadas conversaciones. Cada conversación tiene dos extremos: el extremo iniciador, el servicio que ha iniciado la conversación, y el extremo de destino, el servicio con el que se pone en contacto el iniciador.INITIATOR
Indica que sólo el iniciador de la conversación puede enviar mensajes del tipo especificado. Un servicio que inicia una conversación se conoce como el iniciador de la conversación.TARGET
Indica que sólo el destino de la conversación puede enviar mensajes del tipo especificado. Un servicio que acepta una conversación que inició otro servicio se conoce como el destino de la conversación.ANY
Indica que los mensajes de este tipo se pueden enviar por el iniciador y el destino.[DEFAULT]
Indica que este contrato admite mensajes del tipo predeterminado. De forma predeterminada, todas las bases de datos contienen un tipo de mensaje denominado DEFAULT. Este tipo de mensaje usa una validación de NONE. En el contexto de esta cláusula, DEFAULT no es una palabra clave y debe delimitarse como un identificador. Microsoft SQL Server también proporciona un contrato DEFAULT que especifica el tipo de mensaje DEFAULT.
Comentarios
El orden de los tipos de mensaje del contrato no es significativo. Después de que el destino haya recibido el primer mensaje, Service Broker permite a cualquier lado de la conversación enviar los mensajes permitidos para ese lado de la conversación en cualquier momento. Por ejemplo, si el iniciador de la conversación puede enviar el tipo de mensaje //Adventure-Works.com/Expenses/SubmitExpense, Service Broker permite al iniciador enviar cualquier número de mensajes SubmitExpense durante la conversación.
Los tipos de mensaje y direcciones de un contrato no se pueden cambiar. Para cambiar AUTHORIZATION para un contrato, utilice la instrucción ALTER AUTHORIZATION.
Un contrato debe permitir al iniciador enviar un mensaje. La instrucción CREATE CONTRACT genera errores cuando el contrato no contiene al menos un tipo de mensaje SENT BY ANY o SENT BY INITIATOR.
Independientemente del contrato, un servicio siempre puede recibir los tipos de mensaje https://schemas.microsoft.com/SQL/ServiceBroker/DialogTimer, https://schemas.microsoft.com/SQL/ServiceBroker/Error y https://schemas.microsoft.com/SQL/ServiceBroker/EndDialog. Service Broker utiliza estos tipos de mensaje para los mensajes del sistema con destino a la aplicación. Para obtener más información acerca de los tipos de mensaje proporcionados por el agente, vea mensajes del sistema de Broker.
Un contrato no puede ser un objeto temporal. Se permiten los nombres de contrato que empiezan por #, aunque se trata de objetos permanentes.
Permisos
De forma predeterminada, los miembros de las funciones de base de datos fijas db_ddladmin o db_owner y la función fija del servidor sysadmin pueden crear contratos.
De forma predeterminada, el propietario del contrato, los miembros de las funciones de base de datos fijas db_ddladmin o db_owner y los miembros de la función fija del servidor sysadmin tienen permiso REFERENCES en un contrato.
El usuario que ejecuta la instrucción CREATE CONTRACT debe tener permiso REFERENCES en todos los tipos de mensaje especificados.
Ejemplos
A. Crear un contrato
En el siguiente ejemplo se crea un contrato de reembolso de gastos basándose en tres tipos de mensaje.
CREATE MESSAGE TYPE
[//Adventure-Works.com/Expenses/SubmitExpense]
VALIDATION = WELL_FORMED_XML ;
CREATE MESSAGE TYPE
[//Adventure-Works.com/Expenses/ExpenseApprovedOrDenied]
VALIDATION = WELL_FORMED_XML ;
CREATE MESSAGE TYPE
[//Adventure-Works.com/Expenses/ExpenseReimbursed]
VALIDATION= WELL_FORMED_XML ;
CREATE CONTRACT
[//Adventure-Works.com/Expenses/ExpenseSubmission]
( [//Adventure-Works.com/Expenses/SubmitExpense]
SENT BY INITIATOR,
[//Adventure-Works.com/Expenses/ExpenseApprovedOrDenied]
SENT BY TARGET,
[//Adventure-Works.com/Expenses/ExpenseReimbursed]
SENT BY TARGET
) ;
Vea también