Change Data Capture Developer Guide

Change Data Capture
Keep Your External Data Current with Change Data Capture
Change Event Message Structure
Merged Change Events
Other Types of Change Events: Gap and Overflow Events
Subscribe to Change Events
Change Event Storage and Delivery
Subscription Channels
Compose Streams of Change Data Capture Notifications with Custom Channels
Example Diagrams for Channels and Channel Members
Transaction-Based Replication Steps
Subscribe with Pub/Sub API
Get Compound Fields in Change Events
Enrich Change Events with Extra Fields
Filter Your Event Streams
Subscribe with Apex Triggers
Change Event Triggers
Apex Trigger Quick Start
Apex Trigger Example
Test Change Event Triggers
Change Event Trigger Considerations
Obtain Apex Trigger Subscribers
Monitor Change Event Publishing and Delivery Usage
Security Considerations
Change Event Considerations
Standard Object Notes
Change Events for Fields
PDF

Note: This release is in preview. Features described here don’t become generally available until the latest general availability date that Salesforce announces for this release. Before then, and where features are noted as beta, pilot, or developer preview, we can’t guarantee general availability within any particular time frame or at all. Make your purchase decisions only on the basis of generally available products and features.

Obtain Apex Trigger Subscribers

To get information about the triggers that are subscribed to change events, query the EventBusSubscriber standard object using SOQL. EventBusSubscriber contains information about Apex triggers but not CometD or Pub/Sub API subscribers.

Example

This example SOQL query selects several fields from EventBusSubscriber. For more information about EventBusSubscriber fields, see EventBusSubscriber in the Object Reference for Salesforce and Lightning Platform.

1SELECT ExternalId, Name, Topic, Position, Status, Tip, Type FROM EventBusSubscriber

The returned result shows that there are two Apex triggers subscribed to change events. One trigger is subscribed to AccountChangeEvent and one to ContactChangeEvent.

ExternalId Name Topic Position Status Tip Type
01q2J000000g0kb MyAccountChangeTrigger AccountChangeEvent 226751 Running -1 ApexTrigger
01q2J000000g0kg MyContactChangeTrigger ContactChangeEvent 226752 Running -1 ApexTrigger

You can filter the query results by using a WHERE clause. For example, this query filters by the topic ContactChangeEvent.

1SELECT ExternalId, Name, Topic, Position, Status, Tip, Type FROM EventBusSubscriber 
2WHERE Topic='ContactChangeEvent'

The query returns only the trigger subscribers to ContactChangeEvent, in this case, one trigger.

ExternalId Name Topic Position Status Tip Type
01q2J000000g0kg MyContactChangeTrigger ContactChangeEvent 226752 Running -1 ApexTrigger