SEND (Transact-SQL)

Article
05/30/2023

S’applique à : SQL Server Azure SQL Managed Instance

Envoie un message à l'aide d'une ou de plusieurs conversations existantes.

Syntaxe

  
SEND  
   ON CONVERSATION [(]conversation_handle [,.. @conversation_handle_n][)]  
   [ MESSAGE TYPE message_type_name ]  
   [ ( message_body_expression ) ]  
[ ; ]

Arguments

ON CONVERSATION conversation_handle [.. @conversation_handle_n]
Spécifie les conversations auxquelles appartient le message. conversation_handle doit contenir un identificateur de conversation valide. Le même descripteur de conversation ne peut pas être utilisé plus d’une fois.

MESSAGE TYPE message_type_name
Spécifie le type du message envoyé. Ce type de message doit être inclus dans les contrats de service qu'utilisent ces conversations. Ces contrats doivent autoriser l'envoi de ce type de message depuis cette partie de la conversation. Par exemple, les services cibles des conversations ne peuvent envoyer que les messages spécifiés dans le contrat comme SENT BY TARGET ou SENT BY ANY. Si cette clause est omise, le message est du type DEFAULT.

message_body_expression
Fournit une expression représentant le corps du message. message_body_expression est facultatif. Toutefois, si message_body_expression est présent, le type d’expression doit pouvoir être converti vers le type varbinary(max). Cette expression ne peut pas avoir la valeur NULL. Si cette clause est omise, le corps du message est vide.

Remarques

Important

Si l’instruction SEND n’est pas la première instruction d’un traitement ou d’une procédure stockée, celle qui précède doit se terminer par un point-virgule (;).

L'instruction SEND transmet un message à partir des services situés à une extrémité d'une ou de plusieurs conversations Service Broker aux services situés à l'autre extrémité de ces conversations. L'instruction RECEIVE permet ensuite de récupérer le message envoyé depuis les files d'attente associées aux services cibles.

Les descripteurs de conversation fournis à la clause ON CONVERSATION proviennent de l'une des trois sources suivantes :

Lorsqu’un message envoyé n’est pas une réponse à un message reçu d’un autre service, utilisez le descripteur de conversation retourné par l’instruction BEGIN DIALOG qui a créé la conversation.
Lorsqu’un message envoyé est une réponse à un message reçu précédemment d’un autre service, utilisez le descripteur de conversation retourné par l’instruction RECEIVE qui a renvoyé le message d’origine.
Le code qui contient l’instruction SEND est parfois séparé du code qui contient l’instruction BEGIN DIALOG ou RECEIVE qui fournit le descripteur de conversation. Dans ces cas, le descripteur de conversation doit être l’un des éléments de données inclus dans les informations d’état transmises au code contenant l’instruction SEND.

Les messages qui sont envoyés aux services dans d’autres instances du Moteur de base de données SQL Server sont stockés dans une file d’attente de transmission dans la base de données actuelle jusqu’à ce qu’ils puissent être transmis aux files d’attente de service dans les instances distantes. Les messages envoyés aux services dans la même instance du Moteur de base de données sont placés directement dans les files d’attente associées à ces services. Si une condition empêche de placer un message local directement dans la file d’attente du service cible, la file d’attente de transmission peut le stocker jusqu’à ce que la condition soit résolue. Cela peut se produire, par exemple, pour certains types d’erreur ou lorsque la file d’attente du service cible est inactive. Vous pouvez utiliser la vue système sys.transmission_queue pour consulter les messages dans la file d’attente de transmission.

SEND est une instruction atomique. Si une instruction SEND envoie un message sur plusieurs conversations et échoue, par exemple lorsqu’une conversation se trouve dans un état d’erreur, aucun message n’est stocké dans la file d’attente de transmission ou placé dans une file d’attente de service cible.

Service Broker optimise le stockage et la transmission des messages envoyés sur plusieurs conversations dans la même instruction SEND.

Les messages dans les files d'attente de transmission d'une instance sont transmis dans un ordre défini selon les critères suivants :

Le niveau de priorité du point de terminaison de leur conversation associée.
dans un même niveau de priorité, leur ordre d'envoi dans la conversation.

Les niveaux de priorité spécifiés dans les conversations ne sont appliqués aux messages dans la file d’attente de transmission que si l’option de base de données HONOR_BROKER_PRIORITY a la valeur ON. Si HONOR_BROKER_PRIORITY a la valeur OFF, le niveau de priorité par défaut (5) est attribué à tous les messages placés dans la file d’attente de transmission pour cette base de données. Les niveaux de priorité ne sont pas appliqués à une instruction SEND où les messages sont placés directement dans une file d’attente de service dans la même instance de Moteur de base de données.

L'instruction SEND verrouille séparément chaque conversation sur laquelle un message est envoyé pour garantir la remise ordonnée par conversation.

L’instruction SEND n’est pas valide dans une fonction définie par l’utilisateur.

Autorisations

Pour envoyer un message, l'utilisateur actuel doit avoir l'autorisation RECEIVE sur la file d'attente de chaque service qui envoie le message.

Exemples

L'exemple ci-dessous illustre le début d'un dialogue et l'envoi d'un message XML dans le cadre du dialogue. Pour envoyer le message, l’exemple convertit l’objet xml au format varbinary(max).

DECLARE @dialog_handle UNIQUEIDENTIFIER,
    @ExpenseReport XML;

SET @ExpenseReport = <construct message as appropriate for the application>;

BEGIN DIALOG @dialog_handle
    FROM SERVICE [//Adventure-Works.com/Expenses/ExpenseClient]
    TO SERVICE '//Adventure-Works.com/Expenses'
    ON CONTRACT [//Adventure-Works.com/Expenses/ExpenseProcessing];

SEND ON CONVERSATION @dialog_handle
    MESSAGE TYPE [//Adventure-Works.com/Expenses/SubmitExpense](@ExpenseReport);

L'exemple ci-dessous illustre le début de trois dialogues et l'envoi d'un message XML dans le cadre de ces dialogues.

DECLARE
    @dialog_handle1 UNIQUEIDENTIFIER,
    @dialog_handle2 UNIQUEIDENTIFIER,
    @dialog_handle3 UNIQUEIDENTIFIER,
    @OrderMsg XML;

SET @OrderMsg = '<construct message as appropriate for the application>';

BEGIN DIALOG @dialog_handle1
    FROM SERVICE [//InitiatorDB/InitiatorService]
    TO SERVICE '//TargetDB1/TargetService'
    ON CONTRACT [//AllDBs/OrderProcessing];

BEGIN DIALOG @dialog_handle2
    FROM SERVICE [//InitiatorDB/InitiatorService]
    TO SERVICE '//TargetDB2/TargetService'
    ON CONTRACT [//AllDBs/OrderProcessing];

BEGIN DIALOG @dialog_handle3
    FROM SERVICE [//InitiatorDB/InitiatorService]
    TO SERVICE '//TargetDB3/TargetService'
    ON CONTRACT [//AllDBs/OrderProcessing];

SEND ON CONVERSATION (
    @dialog_handle1,
    @dialog_handle2,
    @dialog_handle3
)
    MESSAGE TYPE [//AllDBs/OrderMsg](@OrderMsg);

Voir aussi

BEGIN DIALOG CONVERSATION (Transact-SQL)
END CONVERSATION (Transact-SQL)
RECEIVE (Transact-SQL)
sys.transmission_queue (Transact-SQL)

Partage via