Xtract DeltaQ
This page shows how to use the Xtract DeltaQ component.
The Xtract DeltaQ component can be used to extract delta data from SAP DataSources. This means that only recently added or changed data is extracted, instead of a full load. For more information on the delta process, see Initialize a Delta Process.
Prerequisites
- A connection to an SAP system is available, see SAP Connection.
- The SAP user has sufficient user rights, see SAP Authority Objects.
- Configure your SAP system to make DataSources accessible, see SAP Customization for DeltaQ.
- To use DataSources in Xtract IS, make sure that the DataSources are activated in SAP.
Warning
Missing Authorization.
To use the Xtract DeltaQ component, access to the designated authority objects (RFC) in SAP must be available. Adjust SAP Authority Objects: DeltaQ accordingly.
SAP Transactions for Working with DeltaQ
The following SAP transaction can support you when working with DataSources:
- SBIW - SAP DataSources start page
- RSA3 - Extractor Checker
- RSA5 - Install DataSources and Hierarchies from Business Content
- RSA6 - Postprocess DataSources and Hierarchies
- SM59 - Configuration of RFC Connections
- SMQS - qRFC Monitor (QOUT Scheduler): Number of Max.Conn. should be at least 10
- SM37 - Background jobs
- SM58 - Transactional RFC
- SM50 - Process overview
- SMGW - Gateway Monitor
- RSA7 - Delta Queue Maintenance
- SMQ1 - qRFC Monitor (outbound queue)
- WE02 - IDoc list
- WE20 - Partner profiles
Add an Xtract DeltaQ Component
Follow the steps below to add an Xtract Table component to your SSIS package:
- Drag&drop the Xtract DeltaQ component from the SSIS toolbox into your data flow task.
-
Double-click the component. A connection manager is automatically assigned to the component and the main window of the component opens.
Note
If there are multiple connection managers, the window "Select Connection Manager" opens, see SAP Connection. Once a connection manager is selected, the main window of the component opens.
The majority of the functions of the component can be accessed in the main window.
Look Up Extractors or Hierarchies
- In the main window of the component, click [ ]. The window “Look Up OLTP Source” opens.
- In the field Name, enter the name of a DataSource . Use wildcards ( * ), if needed.
- Click [ ]. Search results are displayed.
- Select an extractor and click [OK] to confirm.
- In the main window of the component, click [ ]. The window “Look Up OLTP Source” opens
- In the field Name, enter the name of a Hierarchy . Use wildcards ( * ), if needed. Alternatively, enter the description of a Hierarchy in the field Description.
- Click [ ]. Search results are displayed.
- Select an extractor of type HIER and click [OK] to confirm. All available Hierarchies are fetched and the window "Look Up DeltaQ Hierarchies" opens.
- Select a Hierarchy and click [OK] to confirm.
The application now returns to the main window of the component.
Define the Xtract DeltaQ Component
The Xtract DeltaQ component offers the following options for DataSource extractions:
- Navigate to Gateway and click [ ] to look up an RFC destination. For more information, see DeltaQ Customizing: Gateway.
- Navigate to Logical Destination and click [ ] to look up a logical RFC target system. For more information, see DeltaQ Customizing: Logical Destination.
- Click Customizing Check to validate the DeltaQ Customizing on the SAP system. Make sure that all check marks are green. For more information, see DeltaQ Customizing: Customizing Check.
- Select an Update Mode, e.g., to initialize delta extractions.
- Select the items you want to extract.
-
Optional: click the Edit option next to an item to filter the data.
-
Click [Activate] to activate the extraction in SAP. After a successful activation, a corresponding status message opens:
Note
The activation is only required for the update modes Delta, Full or Init. Do not activate the extraction for the Delta Update mode.
-
Check the Settings before running the SSIS package.
- Click [OK] to save the component.
- Navigate to Gateway and click [ ] to look up an RFC destination. For more information, see DeltaQ Customizing: Gateway.
- Navigate to Logical Destination and click [ ] to look up a logical RFC target system. For more information, see DeltaQ Customizing: Logical Destination.
- Click Customizing Check to validate the DeltaQ Customizing on the SAP system. Make sure that all check marks are green. For more information, see DeltaQ Customizing: Customizing Check.
- Select an Update Mode, e.g., to initialize delta extractions.
- Select the items you want to extract.
- Optional: click the Edit option next to an item to filter the data.
-
Optional: click Settings to set the language and output format of the Hierarchy, see settings.
-
Click [OK] to save the component.
Tip
Unlike attributes and transactions, Hierarchies do not have to be activated.
You can now run the SSIS package.
Execute DeltaQ in Parallel
When extracting multiple DataSources in parallel, it is recommended to use separate RFC destinations, e.g., XTRACT01, XTRACT02, etc.
Parallel execution of DataSources with an identical RFC destination is possible, but not recommended.
Related Links
- DeltaQ Troubleshooting Guide.
- SAP Help: Activate the BI Content DataSource
- Knowledge Base Article: Create Generic DataSource using Function Module and Timestamps