MSdistribution_agents (Transact-SQL)
The MSdistribution_agents table contains one row for each Distribution Agent running at the local Distributor. This table is stored in the distribution database.
Column name |
Data type |
Description |
|---|---|---|
id |
int |
The ID of the Distribution Agent. |
name |
nvarchar(100) |
The name of the Distribution Agent. |
publisher_database_id |
int |
The ID of the Publisher database. |
publisher_id |
smallint |
The ID of the Publisher. |
publisher_db |
sysname |
The name of the Publisher database. |
publication |
sysname |
The name of the publication. |
subscriber_id |
smallint |
The ID of the Subscriber, used by well-known agents only. For anonymous agents, this column is reserved. |
subscriber_db |
sysname |
The Name of the subscription database. |
subscription_type |
int |
The type of subscription: 0 = Push. 1 = Pull. 2 = Anonymous. |
local_job |
bit |
Indicates whether there is a SQL Server Agent job on the local Distributor. |
job_id |
binary(16) |
The job identification number. |
subscription_guid |
binary(16) |
The ID of the subscriptions of this agent. |
profile_id |
int |
The configuration ID from the MSagent_profiles (Transact-SQL) table. |
anonymous_subid |
uniqueidentifier |
The ID of an anonymous agent. |
subscriber_name |
sysname |
The name of the Subscriber, used by anonymous agents only. |
virtual_agent_id |
int |
Identified for informational purposes only. Not supported. Future compatibility is not guaranteed. |
anonymous_agent_id |
int |
Identified for informational purposes only. Not supported. Future compatibility is not guaranteed. |
creation_date |
datetime |
The datetime when the Distribution or Merge Agent was created. |
queue_id |
sysname |
The identifier to locate the queue for queued updating subscriptions. For non-queued subscriptions, the value is NULL. For Microsoft Message Queuing-based publications, the value is a GUID that uniquely identifies the queue to be used for the subscription. For SQL Server-based queue publications, the column contains the value SQL. Note Using Microsoft Message Queuing has been deprecated and is no longer supported. |
queue_status |
int |
Identified for informational purposes only. Not supported. Future compatibility is not guaranteed. |
offload_enabled |
bit |
Indicates whether the agent can be activated remotely. 0 specifies that the agent cannot be activated remotely. 1 specifies that the agent will be activated remotely, and on the remote computer specified in the offload_server property. |
offload_server |
sysname |
The network name of server to be used for remote agent activation. |
dts_package_name |
sysname |
The name of the DTS package. For example, for a package named DTSPub_Package, specify @dts_package_name = N'DTSPub_Package'. |
dts_package_password |
nvarchar(524) |
The password on the package. |
dts_package_location |
int |
The package location. The location of the package can be distributor or subscriber. |
sid |
varbinary(85) |
The security identification number (SID) for the Distribution Agent or Merge Agent during its first execution. |
queue_server |
sysname |
Identified for informational purposes only. Not supported. Future compatibility is not guaranteed. |
subscriber_security_mode |
smallint |
The security mode used by the agent when connecting to the Subscriber, which can be one of the following: 0 = Microsoft SQL Server Authentication 1 = Microsoft Windows Authentication. |
subscriber_login |
sysname |
The login used when connecting to the Subscriber. |
subscriber_password |
nvarchar(524) |
Is the encrypted value of the password that is used when connecting to the Subscriber. |
reset_partial_snapshot_progress |
bit |
Is if a partially downloaded snapshot will be discarded so that the entire snapshot process can start again. |
job_step_uid |
uniqueidentifier |
The unique ID of the SQL Server Agent job step in which the agent is started. |
subscriptionstreams |
tinyint |
Sets the number of connections allowed per Distribution Agent to apply batches of changes in parallel to a Subscriber. A range of values from 1 to 64 is supported. |