PUBLIC

Filing Staging Tables with Data Using SAP

HANA Studio
SAP S/4HANA Migration Cockpit
Typographic Conventions

Type Style Description

Example Words or characters quoted from the screen. These include field names, screen
titles, pushbuttons labels, menu names, menu paths, and menu options.

Textual cross-references to other documents.

EXAMPLE Technical names of system objects. These include report names, program names,
transaction codes, table names and key concepts of a programming language when
they are surrounded by body text, for example, SELECT and INCLUDE.

Example Output on the screen. This includes file and directory names and their paths,
messages, names of variables and parameters, source text, and names of
installation, upgrade and database tools.

Example Exact user entry. These are words or characters that you enter in the system exactly
as they appear in the documentation.

<Example> Variable user entry. Angle brackets indicate that you replace these words and
characters with appropriate entries to make entries in the system.

EXAMPLE Keys on the keyboard, for example, F 2 or E N T E R .

© 2024 SAP SE or an SAP affiliate company. All rights reserved. See Legal Notice on www.sap.com/legal-notice for use terms, disclaimers, disclosures, or restrictions related to this material. 2 / 20
Document History

Version Date Change

1.0 2019-09-12 Initial Version

© 2024 SAP SE or an SAP affiliate company. All rights reserved. See Legal Notice on www.sap.com/legal-notice for use terms, disclaimers, disclosures, or restrictions related to this material. 3 / 20
Table of contents
1 Introduction ............................................................................................................................................................. 5
2 How to Fill the Staging Tables Using the SAP HANA Studio .............................................................. 6
2.1 Overview ......................................................................................................................................................................................................... 6
2.2 Creating your Flat File............................................................................................................................................................................ 6
2.3 Prerequisites ................................................................................................................................................................................................ 8
2.4 Procedure ...................................................................................................................................................................................................... 8
3 Relevant Information, Documentation and Links .................................................................................. 17
3.1 Relevant SAP Notes and Knowledge Base Articles (KBA) ....................................................................................... 17
3.2 Other relevant Information, links, and documentation ............................................................................................... 18

© 2024 SAP SE or an SAP affiliate company. All rights reserved. See Legal Notice on www.sap.com/legal-notice for use terms, disclaimers, disclosures, or restrictions related to this material. 4 / 20
1 Introduction
The SAP S/4HANA migration cockpit is designed for customers who have just installed SAP S/4HANA and
want to move their legacy data from SAP or non-SAP software systems. It allows you to migrate your master
data and transactional data to SAP S/4HANA, and it facilitates this process by providing predefined migration
content and mapping. The migration cockpit is part of both SAP S/4HANA and SAP S/4HANA Cloud.

The migration approach Migrate Data Using Staging Tables is recommended if you want to transfer a lot of
data to SAP S/4HANA in an automated way. It is a most efficient way of transferring large volumes of data.
Staging tables are database tables and therefore provide greater flexibility than files regarding managing
data (for example sorting data, searching for data, checking for duplicate records and so on).

If you use the migration approach Migrate Data Using Staging Tables, the SAP S/4HANA migration cockpit
automatically creates staging tables for each migration object that is relevant for your project. You can fill the
staging tables with data either manually, using the SAP HANA Studio or by using third party or SAP´s ETL
tools (for example SAP Agile Data Preparation).

This guide contains information about how to load data from flat files (supported extensions are .csv, .xls, and
.xlsx) to the Migration Cockpit´s staging tables by using the SAP HANA Studio using the option Data from Local
File.

© 2024 SAP SE or an SAP affiliate company. All rights reserved. See Legal Notice on www.sap.com/legal-notice for use terms, disclaimers, disclosures, or restrictions related to this material. 5 / 20
2 How to Fill the Staging Tables Using the SAP HANA Studio

2.1 Overview
This document details how to populate the SAP S/4HANA Migration Cockpit staging tables with data by using
the SAP HANA Studio. It is a step by step guide that shows how to load data from flat files (.csv, .xls, or .xlsx)
to the staging tables by using the Data from Local File option in the SAP HANA Studio.

2.2 Creating your Flat File

The flat file must have one of the extensions .csv, .xls, or .xlsx, and must correspond to the table definition.

Note
You can view the table definition in the SAP HANA studio. In the Systems view, expand the
folders Catalog <schema> Tables, select the table and choose Open Definition or Open Content from the
context menu.

The flat file must include, preferably as the header row, the technical name of the fields of the table. The
fields must appear in the same order as the staging table definition (see the screenshot below). This ensures
that the fields can be mapped more easily, or even automatically by using options for mapping (for more
information, see step 7 in section 2.4).

© 2024 SAP SE or an SAP affiliate company. All rights reserved. See Legal Notice on www.sap.com/legal-notice for use terms, disclaimers, disclosures, or restrictions related to this material. 6 / 20
 Figure 1: The technical field names in the file and in the SAP HANA database

Depending on the definition of the field in the source structure, some fields of the staging tables are defined
as NOT NULL and expect a value. The database management system will not add a row to the staging table
unless the row has a value for that field.

Fields that are marked as NOT NULL in the data definition need to contain values for the corresponding
columns in the file. Otherwise, the system displays an error message stating that the system cannot insert
NULL or update to NULL.

In addition, if leading zeros are required, you need to add them to the relevant values in the flat file as the
ABAP database layer will not add these.

© 2024 SAP SE or an SAP affiliate company. All rights reserved. See Legal Notice on www.sap.com/legal-notice for use terms, disclaimers, disclosures, or restrictions related to this material. 7 / 20
For more information about transferring data from staging tables, leading zeros, default values and
correctness of the values of some data types (for example, DATE, DECIMAL, TIME and so on), see SAP KBA
2733253 and the SAP Help Portal: SAP HANA SQL and System Views Reference for SAP HANA Platform →
SQL Reference → Data Types.

2.3 Prerequisites
• In the SAP S/4HANA migration cockpit You have created a migration project that uses the migration
approach Migrate Data Using Staging Tables.
• You have selected the relevant migration objects for your migration project.
• You have created an SAP HANA database connection between the SAP S/4HANA system and the staging
system (a remote system that uses the SAP HANA database).
• You have a flat file (.csv, .xls, or .xlsx) with data to upload.

2.4 Procedure
1. In the SAP HANA studio, choose File and then Import.

2. Under the folder SAP HANA Content, select the option Data from Local File and then choose Next.

© 2024 SAP SE or an SAP affiliate company. All rights reserved. See Legal Notice on www.sap.com/legal-notice for use terms, disclaimers, disclosures, or restrictions related to this material. 8 / 20
 3. Select the target system where you want to load the data and then choose Next.

Note

The target system that you select in this step is the SAP HANA database connection between the SAP
S/4HANA system and the staging system.

For more information about how to specify a database connection to the source system database,
see SAP Help Portal: SAP S/4HANA Migration Cockpit → Transferring Data to SAP S/4HANA Using
Staging Tables.

4. Select the source file that you want to upload by choosing Browse and then Open.

© 2024 SAP SE or an SAP affiliate company. All rights reserved. See Legal Notice on www.sap.com/legal-notice for use terms, disclaimers, disclosures, or restrictions related to this material. 9 / 20
 Note:

SAP HANA studio (SPS04, Revision 28 and above) only supports the uploading of data from files with
the extensions .csv, .xls, or .xlsx.

5. Specify the required information under File Details.

© 2024 SAP SE or an SAP affiliate company. All rights reserved. See Legal Notice on www.sap.com/legal-notice for use terms, disclaimers, disclosures, or restrictions related to this material. 10 / 20
Under File Details, you specify the following information:

• Field Delimiter
Choose the field delimiter (comma, semi colon, or colon) used by your file.

• Select Worksheet
Choose the Worksheet where the information is located (if the CSV or Excel file has several sheets).

• Header row exists

If your flat file has a header row, select this option. Otherwise, specify the header row number.

• Import all data

You can import all rows by selecting the Import all data checkbox. Alternatively, you can to import specific
number of rows (by specifying a start line and an end line).

• Ignore leading and trailing white-space(s) in file

You can use this option to remove the spaces before and after data records.

• Target Table
Select the Existing radio button and then choose the Select Table button. Select the staging table created
by the SAP S/4HANA migration cockpit (for example, /1LT/DSCC2001521), and choose OK.

© 2024 SAP SE or an SAP affiliate company. All rights reserved. See Legal Notice on www.sap.com/legal-notice for use terms, disclaimers, disclosures, or restrictions related to this material. 11 / 20
 Note

You can find the staging table names of your migration project on the Migration Object Details screen
→ Staging Tables. Note that you need to repeat this process for each staging table. For more
information, see the screenshot below, and also the SAP Help Portal documentation at:
https://help.sap.com/viewer/81152a97f8394fb6bffd19a5632be2e3/1902.500/en-
US/a9dceda5804042b0a49ea9f61c49233a.html

Figure 3. Using the SAP S/4HANA Migration Cockpit to determine the staging table names.

6. Choose Next.

© 2024 SAP SE or an SAP affiliate company. All rights reserved. See Legal Notice on www.sap.com/legal-notice for use terms, disclaimers, disclosures, or restrictions related to this material. 12 / 20
 7. Under Manage Table Definition and Data Mappings, you map the source fields to the target fields. To
do this, there are the following options:

○ You can drag and drop a field from the left (section Source File) to the right (section Target
Table).

© 2024 SAP SE or an SAP affiliate company. All rights reserved. See Legal Notice on www.sap.com/legal-notice for use terms, disclaimers, disclosures, or restrictions related to this material. 13 / 20
The system can map the fields automatically. To do this, choose the Mapping Menu icon, and choose one of
the following options:
• One to One

You can use this option to automatically map the source fields (on the left) to the target fields (on the right)
based on the column position. This means that source field in position 1 will be mapped to target field in
position 1, source field in position 2 will be mapped to target field in position 2, and so on.
• Map by Name

Source fields are mapped to target fields with the same name. Note that the names must be an exact
match, and that the check is case-sensitive.

Note
Under File Data, you can view the definition of the data from the source file based on the settings
specified in the previous screen.

8. Choose Next.

The final Summary screen will show a summary and details of the data from the file you selected for
upload (under Data from File), and the data from the staging table in SAP HANA (under Data from Existing
Table).

© 2024 SAP SE or an SAP affiliate company. All rights reserved. See Legal Notice on www.sap.com/legal-notice for use terms, disclaimers, disclosures, or restrictions related to this material. 14 / 20
 9. Choose Finish to confirm your mapping and upload the data from the file to the staging tables.

Note

In the SAP HANA Studio, on the Job Log tab, you can see if the import was successful or if errors
occurred.

If the import was successful, you can check the data that was loaded by right-clicking on your staging
table and then choosing Open Data Preview.

© 2024 SAP SE or an SAP affiliate company. All rights reserved. See Legal Notice on www.sap.com/legal-notice for use terms, disclaimers, disclosures, or restrictions related to this material. 15 / 20
© 2024 SAP SE or an SAP affiliate company. All rights reserved. See Legal Notice on www.sap.com/legal-notice for use terms, disclaimers, disclosures, or restrictions related to this material. 16 / 20
3 Relevant Information, Documentation and Links

Note
Make sure that you have the up-to-date version of each SAP Note, which you can find on SAP
Support Portal at http://support.sap.com/notes.

3.1 Relevant SAP Notes and Knowledge Base Articles (KBA)

SAP Note / KBA Number Title Description

KBA 2733253 2733253 - FAQ for SAP S/4HANA You are using SAP S/4HANA
migration cockpit - Transfer migration cockpit and want to use
option: Transfer data from staging the Transfer option: "Transfer
tables Data from Staging Tables"

Collective SAP Note 2537549 2537549 - Collective SAP Note This collective SAP Note provides
and FAQ for SAP S/4HANA you an overview on the existing
Migration cockpit (on premise) SAP Notes/Knowledge base
articles (KBA) related to the SAP
S/4HANA migration cockpit
content.

Collective SAP Note 2538700 2538700 - Collective SAP Note This collective SAP Note provides
and FAQ for SAP S/4HANA you an overview on the existing
Migration Cockpit (Cloud) SAP Notes/Knowledge base
articles (KBA) related to the SAP
S/4HANA Migration Cockpit
content.

© 2024 SAP SE or an SAP affiliate company. All rights reserved. See Legal Notice on www.sap.com/legal-notice for use terms, disclaimers, disclosures, or restrictions related to this material. 17 / 20
3.2 Other relevant Information, links, and documentation
Official Pages and Links about SAP S/4HANA and SAP S/4HANA Migration Cockpit

Topic Link

SAP S/4HANA On-Premise https://help.sap.com/viewer/p/SAP_S4HANA_ON-

PREMISE

SAP S/4HANA Cloud https://help.sap.com/viewer/p/SAP_S4HANA_CLOUD

Transferring Data to SAP S/4HANA Using https://help.sap.com/viewer/81152a97f8394fb6bffd19a5

Staging Tables 632be2e3/1902.500/en-
US/1df405e3332d4de999af648845c6013c.html

Loading data from flat file into SAP HANA https://archive.sap.com/documents/docs/DOC-27960

DB – The ever simplest way with SPS04

Transferring Data to SAP S/4HANA https://help.sap.com/viewer/29193bf0ebdd4583930b217

6cb993268/1709 001/en-
US/db03398a71b54993bb78a080dfafaa9e.html

SAP Best Practices Explorer, Data https://rapid.sap.com/bp/#/scopeitems/2Q2

Migration to SAP S/4HANA from Staging
(2Q2)

SAP HANA Modeling Guide, Upload Data https://help.sap.com/viewer/fc5ace7a367c434190a80478

from Flat Files 81f92ed8/2.0.02/en-
US/d7a79a58bb5710149ed293cc617231b9.html

SAP HANA Developer Guide for SAP https://help.sap.com/doc/PRODUCTION/fbb802faa34440

HANA Studio b39a5b6e3814c6d3b5/2.0.00/en-
US/SAP_HANA_Developer_Guide_for_SAP_HANA_Studi
o_en.pdf

SAP HANA Academy - Importing Data from https://www.youtube.com/watch?v=4B55DrzFyIM

CSV file

SAP HANA Academy - HANA https://www.youtube.com/watch?v=vLJh5Zk3EA8

Recommends: Step 5: Loading a Data File
Using SAP HANA Studio

© 2024 SAP SE or an SAP affiliate company. All rights reserved. See Legal Notice on www.sap.com/legal-notice for use terms, disclaimers, disclosures, or restrictions related to this material. 18 / 20
Blogs about SAP S/4HANA Migration Cockpit

Topic Link

SAP S/4HANA Migration Cockpit – https://blogs.sap.com/2017/12/04/sap-s4hana-migration-

tips&tricks cockpit-tipstricks/

Starter Blog for SAP S/4HANA Migration https://blogs.sap.com/2017/07/05/starter-blog-for-sap-

Cockpit s4hana-migration-cockpit/

© 2024 SAP SE or an SAP affiliate company. All rights reserved. See Legal Notice on www.sap.com/legal-notice for use terms, disclaimers, disclosures, or restrictions related to this material. 19 / 20
<2024 SAP. All rights reserved.

No part of this publication may be reproduced or transmitted in any form or for any purpose without the
express permission of SAP AG. The information contained herein may be changed without prior notice.

Some software products marketed by SAP AG and its distributors contain proprietary software components
of other software vendors.

National product specifications may vary.

These materials are provided by SAP AG and its affiliated companies (“SAP Group”) for informational
purposes only, without representation or warranty of any kind, and SAP Group shall not be liable for errors or
omissions with respect to the materials. The only warranties for SAP Group products and services are those
that are set forth in the express warranty statements accompanying such products and services, if any.
Nothing herein should be construed as constituting an additional warranty.

SAP and other SAP products and services mentioned herein as well as their respective logos are trademarks
or registered trademarks of SAP AG in Germany and other countries. Please see www.sap.com/corporate-
en/legal/copyright/index.epx#trademark for additional trademark information and notices..> www.sap.com.

© 2024 SAP SE or an SAP affiliate company. All rights reserved. See Legal Notice on www.sap.com/legal-notice for use terms, disclaimers, disclosures, or restrictions related to this material. 20 / 20