CREATE CONTRACT (Transact-SQL)

Se aplica a:SQL ServerAzure SQL Managed Instance

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.

Convenciones de sintaxis de Transact-SQL

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 tener hasta 128 caracteres.

AUTHORIZATION owner_name
Establece el propietario del contrato en el usuario o el rol de 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 rol 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 un rol al 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 initiator (el servicio que ha iniciado la conversación) y el extremo de target (el servicio con el que se pone en contacto el iniciador).

INITIATOR
Indica que solo el iniciador de la conversación puede enviar mensajes del tipo especificado. Un servicio que inicia una conversación se conoce como el initiator de la conversación.

TARGET
Indica que solo 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 target 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 usa estos tipos de mensaje para los mensajes del sistema con destino a la aplicación.

Un contrato no puede ser un objeto temporal. Se permiten los nombres de contrato que empiezan por #, aunque se trata de objetos permanentes.

Permisos

Los miembros de los roles fijos de base de datos db_ddladmin o db_owner y el rol fijo de servidor sysadmin pueden crear contratos de forma predeterminada.

El propietario del contrato, los miembros de los roles fijos de base de datos db_ddladmin o db_owner y los miembros del rol fijo de servidor sysadmin tienen permiso REFERENCES en un contrato de forma predeterminada.

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

DROP CONTRACT (Transact-SQL)
EVENTDATA (Transact-SQL)