Create a SAP Analytics Cloud crawler workflow in Atlan to extract folders, stories, models, columns, and lineage from your tenant.
Crawl SAP Analytics Cloud Private Preview
Create a SAP Analytics Cloud crawler workflow in Atlan to extract metadata from your tenant. The workflow configures the extraction method, the connection, and which folders to crawl.
Prerequisites
Before you begin:
- Complete Set up SAP Analytics Cloud so the OAuth client is configured in your tenant.
- To see lineage from SAP Datasphere to SAP Analytics Cloud Live models, crawl SAP Datasphere first. Atlan links a Live model to its upstream SAP Datasphere object only if that object already exists in Atlan when the SAP Analytics Cloud crawler runs.
- Review the order of operations for connection workflows.
Create crawler workflow
-
In your Atlan workspace, click Connectors in the left sidebar.
- If you are using the Old UI (Classic), click New Workflow in the top navigation.
-
Click Marketplace.
-
Search for SAP Analytics Cloud and select it.
-
Click Install.
-
Once installation completes, click Setup Workflow on the same tile.
Configure extraction
Select your extraction method and provide the OAuth client details.
- Direct
- Agent
In Direct extraction, Atlan connects to the SAP Analytics Cloud REST APIs and crawls metadata directly.
-
Enter your SAP Analytics Cloud OAuth details:
- SAC Tenant URL: Enter your tenant base URL, for example
https://<tenant>.<data-center>.analytics.cloud.sap. - OAuth Token URL: Enter the Token URL of the OAuth client you created. This is a different host from the tenant URL.
- OAuth Client ID and OAuth Client Secret: Enter the credentials of the same OAuth client.
- SAC Tenant URL: Enter your tenant base URL, for example
-
Click Test Authentication to confirm that Atlan can get an access token from SAP Analytics Cloud.
-
When successful, at the bottom of the screen click Next.
In Agent extraction, Self-Deployed Runtime executes metadata extraction within your organization's environment. Agent extraction must be enabled for your Atlan tenant. Contact Atlan support if you don't see the Agent option.
-
Install Self-Deployed Runtime if you haven't already:
-
Select the Agent tab.
-
Store the tenant URL, token URL, client ID, and client secret in the secret store configured with the Self-Deployed Runtime. In each field, enter the path of the corresponding secret. For more information, see Secret management.
-
Click Next after completing the configuration.
Configure connection
Complete the SAP Analytics Cloud connection configuration:
-
Enter a Connection Name that represents your source environment (for example,
production,development, oranalytics). -
Under Connection Admins, add the users or groups that can manage this connection. If you leave this empty, no one can manage the connection, including admins.
-
At the bottom of the screen, click Next.
Configure crawler
SAP Analytics Cloud content is organized in folders. Filters apply to top-level folders: selecting a folder also selects everything nested inside it.
- Direct
- Agent
- Click Include Folders to choose which top-level folders to crawl. If you don't select any, Atlan crawls all folders.
- Click Exclude Folders to choose which top-level folders to skip. If a folder matches both filters, the exclude filter takes precedence.
In Agent extraction, Atlan can't browse your tenant, so enter the filters as JSON. Each key is a regular expression matched against top-level folder names, and each value is an empty list.
- Include Folders: For example,
{"^PUBLIC$": []}crawls only thePUBLICfolder. Leave empty to crawl all folders. - Exclude Folders: For example,
{"^SYSTEM$": []}skips theSYSTEMfolder. If a folder matches both filters, the exclude filter takes precedence.
Run crawler
-
In Direct extraction only, click Preflight checks to validate connectivity and access before running.
-
At the bottom of the screen, click Run to run once, or Schedule Run to run hourly, daily, weekly, or monthly.
After the crawler completes, SAP Analytics Cloud folders, stories, models, and columns appear on the assets page, with lineage between them.
See also
- What does Atlan crawl from SAP Analytics Cloud?: Assets, metadata, and lineage that Atlan extracts