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.

See Also

Concepts

Replication Tables (Transact-SQL)