Symptom
- When attempting to import data from Snowflake into a public dimension model in SAP Analytics Cloud, rows are rejected if a literal
<root>value is used in the hierarchy parent column. - Users experience import errors, even if
<root>appears only once. The intended purpose of the hierarchy is to support selective locking/unlocking of specific dimension members via multi actions.
Environment
SAP Analytics Cloud 2025.8.13
Reproducing the Issue
-
In SQL server, create a view or table containing a dimension with a
Parentcolumn.-
Add one or more rows where the
Parentvalue is set as the string literal<root>.
-
-
In SAP Analytics Cloud, create or open a public dimension model.
-
Go to Data Management and define a new Import Job from the Snowflake connection.
-
Map the
IDandParentcolumns to build a parent-child hierarchy. -
Run the import job.
-
Observe:
-
Import fails with error messages.
-
Rows referencing
<root>are rejected. -
The hierarchy is not created or incomplete.
-
Cause
The issue occurs because <root> is treated as a reserved concept in SAC to indicate the top-level node in a hierarchy. Using <root> as a literal value in the dataset can lead to:
-
Ambiguities in hierarchy construction.
-
SAC interpreting multiple rows with the same parent
<root>as an invalid structure. -
Validation failures during import due to conflicting or cyclical references.
This behavior persists even if <root> is used only once in the dataset.
Resolution
To avoid this issue and ensure successful data import, follow the recommended guidelines below:
-
Avoid using
<root>as a literal value in theParentcolumn of the hierarchy structure. -
For top-level nodes, leave the
Parentfield empty/null, or use a custom identifier such asTOP_NODEor a use any other unique code. -
Preprocess the data in SQL Server to replace or remove
<root>before running the import job. -
Validate the hierarchy structure to ensure:
-
There is only one top-level node.
-
No circular references exist.
-
Each child has a unique and valid parent.
-
-
Test the import with a small subset of data before applying changes in production.
See Also
- 2569847 - Where can you find SAC user assistance (help) to use, configure, and operate it more effectively?
- Have a question? Ask it here and let our amazing SAP community help! Or reply and share your knowledge!
- 2487011 - What information do I need to provide when opening a case for SAP Analytics Cloud?
- 2511489 - Troubleshooting performance issues in SAP Analytics Cloud
- Search for SAP Analytics Cloud content using SAP for Me, Google or Bing:
- https://me.sap.com/servicessupport/search#?q=SAP%20Analytics%20Cloud%20OR%20SAC&tab=All
- https://www.google.com/search?q=site%3Ahttps%3A%2F%2Fuserapps.support.sap.com+SAP+Analytics+Cloud
- https://www.bing.com/search?q=site%3Ahttps%3A%2F%2Fuserapps.support.sap.com+SAP+Analytics+Cloud
- Note: Add relevant text or warning/error messages to the text search field to filter results.
- SAP Analytics Cloud Connection Guide
- Getting Started with SAP Analytics Cloud Expert Community page
- SAP Analytics Cloud Get More Help and SAP Support
- Need More Help? Contact Support or visit the solution finder today!
Your feedback is important to help us improve our knowledge base.
Keywords
SAC, hierarchy, parent-child, root node, import error, data rejected, multi actions, Snowflake, locking, top node , KBA , LOD-ANA-AQU , Import Data Connections (Acquiring Data) , Problem
SAP Knowledge Base Article - Public