Set up a linked service and source dataset for the SAP CDC connector

APPLIES TO: Azure Data Factory Azure Synapse Analytics

Learn how to set up the linked service and source dataset for the SAP CDC connector in Azure Data Factory.

Set up a linked service

To set up an SAP CDC linked service:

  1. In Azure Data Factory Studio, go to the Manage hub of your data factory. In the menu under Connections, select Linked services. Select New to create a new linked service.

    Screenshot of the Manage hub in Azure Data Factory Studio, with the New linked service button highlighted.

  2. In New linked service, search for SAP. Select SAP CDC, and then select Continue.

    Screenshot of the linked service source selection, with SAP CDC selected.

  3. Set the linked service properties. Many of the properties are similar to SAP Table linked service properties. For more information, see Linked service properties.

    1. In Name, enter a unique name for the linked service.
    2. In Connect via integration runtime, select your self-hosted integration runtime.
    3. In Server name, enter the mapped server name for your SAP system.
    4. In Subscriber name, enter a unique name to register and identify this Data Factory connection as a subscriber that consumes data packages that are produced in the Operational Delta Queue (ODQ) by your SAP system. For example, you might name it <your data factory -name>_<your linked service name>. Make sure to only use upper case letters.

    Make sure you assign a unique subscriber name to every linked service connecting to the same SAP system. This will make monitoring and trouble shooting on SAP side much easier.

    Screenshot of the SAP CDC linked service configuration.

  4. Select Test connection, and then select Create.

Set up the source dataset

  1. In Azure Data Factory Studio, go to the Author hub of your data factory. In Factory Resources, under Datasets > Dataset Actions, select New dataset.

    Screenshot that shows creating a new pipeline in the Data Factory Studio Author hub.

  2. In New dataset, search for SAP. Select SAP CDC, and then select Continue.

    Screenshot of the SAP CDC dataset type in the New dataset dialog.

  3. In Set properties, enter a name for the SAP CDC linked service data source. In Linked service, select the dropdown and select New.

  4. Select your SAP CDC linked service for the new source dataset and set the rest of the properties for the linked service:

    1. In Connect via integration runtime, select your self-hosted integration runtime.

    2. In ODP context, select the context of the ODP data extraction. Here are some examples:

      • To extract ABAP CDS views from S/4HANA, select ABAP_CDS.
      • To extract InfoProviders or InfoObjects from SAP BW or BW/4HANA, select BW.
      • To extract SAP extractors from SAP ECC, select SAPI.
      • To extract SAP application tables from SAP source systems via SAP LT replication server as a proxy, select SLT_<your queue alias>.

      If you want to extract SAP application tables, but you don’t want to use SAP Landscape Transformation Replication Server (SLT) as a proxy, you can create SAP extractors by using the RSO2 transaction code or Core Data Services (CDS) views with the tables. Then, extract the tables directly from your SAP source systems by using either an SAPI or an ABAP_CDS context.

    3. For ODP name, under the selected data extraction context, select the name of the data source object to extract. If you connect to your SAP source system by using SLT as a proxy, the Preview data feature currently isn't supported.

      To enter the selections directly, select the Edit checkbox.

    Screenshot of the SAP CDC dataset configuration page.

  5. Select OK to create your new SAP CDC source dataset.

Set up a mapping data flow using the SAP CDC dataset as a source

To set up a mapping data flow using the SAP CDC dataset as a source, follow Transform data with the SAP CDC connector

Next steps

Debug the SAP CDC connector by sending self-hosted integration runtime logs