DROP SUBSCRIPTION statement [SQL Remote]

Use this statement to drop a subscription for a user from a publication.

Syntax
DROP SUBSCRIPTION TO publication-name [ ( subscription-value ) ]
 FOR subscriber-id, ...
subscription-value: string
subscriber-id: string
Parameters
  • publication-name   The name of the publication to which the user is being subscribed. This can include the owner of the publication.

  • subscription-value   A string that is compared to the subscription expression of the publication. This value is required because a user can have more than one subscription to a publication.

  • subscriber-id   The user ID of the subscriber to the publication.

Remarks

Drops a SQL Remote subscription for a user ID to a publication in the current database. The user ID will no longer receive updates when data in the publication is changed.

In SQL Remote, publications and subscriptions are two-way relationships. If you drop a subscription for a remote user to a publication on a consolidated database, you should also drop the subscription for the consolidated database on the remote database to prevent updates on the remote database being sent to the consolidated database.

Permissions

Must have DBA authority.

Side effects

Automatic commit.

See also
Standards and compatibility
  • SQL/2003   Vendor extension.

Example

The following statement drops a subscription for the SamS user ID to the pub_contact publication.

DROP SUBSCRIPTION TO pub_contact
FOR SamS;