PUBLIC SAP Data Services Document Version: 4.2 Support Package 13 (14.2.13.0) – 2021-05-26 Workbench Guide company. All rights reserved. All rights company. affiliate THE BEST RUN 2021 SAP SE or an SAP SE or an SAP SAP 2021 © Content 1 Overview of this guide........................................................ 5 1.1 About this guide..............................................................5 1.2 Who should read this guide......................................................5 1.3 Naming conventions and variables.................................................6 2 Workbench User Interface.....................................................11 2.1 Logging into the Workbench.....................................................11 2.2 Workbench window...........................................................11 Workspace editors.........................................................12 2.3 Menu bar..................................................................13 File menu............................................................... 13 Edit menu...............................................................13 Tools menu..............................................................13 Validate menu............................................................14 Window menu............................................................14 Help menu...............................................................15 Replication job editor.......................................................15 2.4 Toolbar....................................................................16 2.5 Project explorer..............................................................17 2.6 Data Flow editor.............................................................17 Data Flow editor options.....................................................18 Additional Data Flow options..................................................19 2.7 Datastore editor.............................................................20 2.8 File Format editor............................................................21 General options...........................................................22 Data File(s) options........................................................24 Delimiters options.........................................................26 Default Format options......................................................27 Input/Output options.......................................................29 Custom Transfer options....................................................30 Locale options............................................................31 Error Handling options......................................................32 Fields work area.......................................................... 34 2.9 Target file properties..........................................................35 General options...........................................................35 Data file options...........................................................37 Delimiters options.........................................................38 Workbench Guide 2 PUBLIC Content Default Format options......................................................39 Input/Output options.......................................................40 Custom Transfer options.....................................................41 Locale options............................................................42 2.10 Monitoring editor............................................................42 2.11 Data Services preferences......................................................43 Data Flow detections.......................................................44 Data Flow editor.......................................................... 46 Data preview.............................................................46 Datastore editor...........................................................47 Expression editor..........................................................47 Expression macros........................................................ 48 File Format editor .........................................................49 Project explorer...........................................................50 2.12 General preferences.......................................................... 51 2.13 Language preferences.........................................................51 3 Database Migration......................................................... 52 3.1 Migrating data and schema information............................................52 Creating a Workbench project.................................................53 Using the quick replication wizard ..............................................53 Create datastores using the datastore editor......................................55 Using the replication job editor................................................56 Using the Data Flow editor...................................................62 Converting replication tables to data flows........................................62 Expression macros ........................................................63 Using the File Format editor..................................................64 Deploying and executing the replication job.......................................65 3.2 Delta load migration..........................................................66 Delta load jobs in the Workbench...............................................66 Delta load options for tables..................................................67 Delta load options for SAP applications..........................................68 4 Using an SAP Information Steward Data Cleansing Solution.......................... 69 4.1 Viewing data cleansing solutions.................................................69 Deleting a data cleansing solution..............................................70 4.2 Configuring a data flow........................................................70 Using the Basic Cleanse transform .............................................71 4.3 Modifying the reference data location..............................................72 4.4 Modifying the reports substitution variables......................................... 72 4.5 Validating a data flow......................................................... 73 4.6 Deploying a data flow......................................................... 73 Workbench Guide Content PUBLIC 3 4.7 Executing a data flow..........................................................73 4.8 Viewing data................................................................74 4.9 Modifying a Workbench job in Data Services Designer.................................. 74 5 Additional Information.......................................................75 5.1 Supported data migration sources and targets....................................... 75 5.2 Using the expression editor.....................................................76 Supported operators.......................................................76 Include functions in expressions...............................................77 5.3 Managing Workbench project information...........................................87 Creating a Workbench project.................................................87 Exporting resources and preferences............................................88 Importing resources and preferences........................................... 88 Workbench Guide 4 PUBLIC Content 1 Overview of this guide Welcome to the Workbench Guide. The Data Services Workbench provides a graphical user interface (GUI) development environment in which you define data application logic to migrate data and database schema information between different databases in a data warehousing environment. Key features of the Workbench include: ● Browsing table metadata and data. ● Selecting individual source tables for migration. ● Specifying the order in which the source tables should be migrated. ● Adjusting the table schema in detail. For example, adding or removing columns, defining constraints, partitions, indexes, and so on. ● Specifying filters and simple projection expressions. ● Specifying source and target table options such as array fetch size and bulk-loading options. ● Executing a replication job as an initial load or delta load. ● Modeling and consuming a data quality job. 1.1 About this guide This guide contains two kinds of information: ● Conceptual information that helps you understand the Data Services Workbench and how it works. ● Procedural information that explains in a step-by-step manner how to accomplish a task. You will find this guide most useful: ● While you are learning about the product. ● While you are performing tasks in the design and early testing phases of your data-movement projects. ● As a general source of information during any phase of your projects. 1.2 Who should read this guide This and other Data Services product documentation assumes the following: ● You are an application developer, consultant, or database administrator working on data warehousing. ● You understand your source data systems and RDMBS. ● You understand your organization's data needs. ● You are familiar with SQL (Structured Query Language). ● You are familiar with Data Services installation environments — Microsoft Windows or UNIX. Workbench Guide Overview of this guide PUBLIC 5 1.3 Naming conventions and variables Familiarize yourself with how we use SAP and SAP Data Services system names and specific environment variables