sys.conversation_endpoints (Transact-SQL)

 

Updated: June 10, 2016

THIS TOPIC APPLIES TO:yesSQL Server (starting with 2008)noAzure SQL DatabasenoAzure SQL Data Warehouse noParallel Data Warehouse

Each side of a Service Broker conversation is represented by a conversation endpoint. This catalog view contains a row per conversation endpoint in the database.

Column nameData typeDescription
conversation_handleuniqueidentifierIdentifier for this conversation endpoint. Not NULLABLE.
conversation_iduniqueidentifierIdentifier for the conversation. This identifier is shared by both participants in the conversation. This together with the is_initiator column is unique within the database. Not NULLABLE.
is_initiatortinyintWhether this endpoint is the initiator or the target of the conversation. Not NULLABLE.

1 = Initiator

0 = Target
service_contract_idintIdentifier of the contract for this conversation. Not NULLABLE.
conversation_group_iduniqueidentifierIdentifier for the conversation group this conversation belongs to. Not NULLABLE.
service_idintIdentifier for the service for this side of the conversation. Not NULLABLE.
lifetimedatetimeExpiration date/time for this conversation. Not NULLABLE.
statechar(2)The current state of the conversation. Not NULLABLE. One of:

SO Started outbound. SQL Server processed a BEGIN CONVERSATION for this conversation, but no messages have yet been sent.

SI Started inbound. Another instance started a new conversation with SQL Server, but SQL Server has not yet completely received the first message. SQL Server may create the conversation in this state if the first message is fragmented or SQL Server receives messages out of order. However, SQL Server might create the conversation in the CO (conversing) state if the first transmission received for the conversation contains the entire first message.

CO Conversing. The conversation is established, and both sides of the conversation may send messages. Most of the communication for a typical service takes place when the conversation is in this state.

DI Disconnected inbound. The remote side of the conversation has issued an END CONVERSATION. The conversation remains in this state until the local side of the conversation issues an END CONVERSATION. An application might still receive messages for the conversation. Because the remote side of the conversation has ended the conversation, an application cannot send messages on this conversation. When an application issues an END CONVERSATION, the conversation moves to the CD (Closed) state.

DO Disconnected outbound. The local side of the conversation has issued an END CONVERSATION. The conversation remains in this state until the remote side of the conversation acknowledges the END CONVERSATION. An application cannot send or receive messages for the conversation. When the remote side of the conversation acknowledges the END CONVERSATION, the conversation moves to the CD (Closed) state.

ER Error. An error has occurred on this endpoint. The error message is placed in the application queue. If the application queue is empty, this indicates that the application already consumed the error message.

CD Closed. The conversation endpoint is no longer in use.
state_descnvarchar(60)Description of endpoint conversation state. This column is NULLABLE. One of:

 STARTED_OUTBOUND

 STARTED_INBOUND

 CONVERSING

 DISCONNECTED_INBOUND

 DISCONNECTED_OUTBOUND

 CLOSED

 ERROR
far_servicenvarchar(256)Name of the service on the remote side of conversation. Not NULLABLE.
far_broker_instancenvarchar(128)The broker instance for the remote side of the conversation. NULLABLE.
principal_idintIdentifier of the principal whose certificate is used by the local side of the dialog. Not NULLABLE.
far_principal_idintIdentifier of the user whose certificate is used by the remote side of the dialog. Not NULLABLE.
outbound_session_key_identifieruniqueidentifierIdentifier for outbound encryption key for this dialog. Not NULLABLE.
inbound_session_key_identifieruniqueidentifierIdentifier for inbound encryption key for this dialog. Not NULLABLE.
security_timestampdatetimeTime at the local session key was created. Not NULLABLE.
dialog_timerdatetimeThe time at which the conversation timer for this dialog sends a DialogTimer message. Not NULLABLE.
send_sequencebigintNext message number in the send sequence. Not NULLABLE.
last_send_tran_idbinary(6)Internal transaction ID of last transaction to send a message. Not NULLABLE.
end_dialog_sequencebigintThe sequence number of the End Dialog message. Not NULLABLE.
receive_sequencebigintNext message number expected in message receive sequence. Not NULLABLE.
receive_sequence_fragintNext message fragment number expected in message receive sequence. Not NULLABLE.
system_sequencebigintThe sequence number of the last system message for this dialog. Not NULLABLE.
first_out_of_order_sequencebigintThe sequence number of the first message in the out of order messages for this dialog. Not NULLABLE.
last_out_of_order_sequencebigintThe sequence number of the last message in the out of order messages for this dialog. Not NULLABLE.
last_out_of_order_fragintSequence number of the last message in the out of order fragments for this dialog. Not NULLABLE.
is_systembit1 if this is a system dialog. Not NULLABLE.
prioritytinyintThe conversation priority that is assigned to this conversation endpoint. Not NULLABLE.

The visibility of the metadata in catalog views is limited to securables that a user either owns or on which the user has been granted some permission. For more information, see Metadata Visibility Configuration.

Community Additions

ADD
Show: