Catalog Source Configuration > SAP Datasphere - Preview catalog source > Before you begin
  

Before you begin

Before you create a catalog source, ensure that you have the information required to connect to the source system.
Perform the following tasks:

Verify permissions

To extract metadata and to configure other capabilities that a catalog source might include, you need account access and permissions on the source system. The permissions required might vary depending on the capability.

Permissions for metadata extraction

To extract SAP Datasphere metadata, you need the permission to generate the access token.

Create a connection

Create an SAP Datasphere connection object in Administrator with the connection details of the SAP Datasphere source system.
    1In Administrator, select Connections.
    2Click New Connection.
    3Enter the following connection details:
    Property
    Description
    Connection Name
    Name of the connection.
    Each connection name must be unique within the organization. Connection names can contain alphanumeric characters, spaces, and the following special characters: _ . + -,
    Maximum length is 255 characters.
    Description
    Description of the connection. Maximum length is 4000 characters.
    Type
    SAP OData V4
    Runtime Environment
    The name of the runtime environment where you want to run tasks.
    Select a Secure Agent.
    Service Type
    The service type of the OData V4 application endpoint to which you want to connect.
    When you create a connection, the agent connects to the SAP Datasphere service type of the OData V4 application endpoint.
    Default is SAP Datasphere.
    Service URL
    The service URL for the SAP Datasphere service type.
    Enter the service URL in the following format:
    https://<Host name of the SAP server>/api/v1/dwc/consumption/relational/<Space name of SAP Datasphere>/<Asset name of SAP Datasphere>/
    For example, if you want to connect to the ZALLDATATYPES asset in the INFA_DEV space of SAP Datasphere, enter the following service URL:
    https://example.us01.hcs.cloud.sap/api/v1/dwc/consumption/relational/INFA_DEV/ZALLDATATYPES/
    Authentication Type
    The authentication type to connect to the SAP OData V4 service.
    You can use the OAuth authentication method to connect to SAP Datasphere.
    Authorization Token URL
    The SAP authorization token endpoint of the OAuth 2.0 authorization server that is used to authorize the user request.
    Enter the authorization token URL in the following format:
    https://<Host name of the server>/oauth/authorize
    For example, If the host name is example.authentication.us01.hana.ondemand.com, enter the following authorization token URL:
    https://example.authentication.us01.hana.ondemand.com/oauth/authorize
    Access Token URL
    The SAP access token endpoint of the OAuth 2.0 authorization server that is used to exchange the authorization code to get an access token.
    Enter the access token URL in the following format:
    https://<Host name of the server>/oauth/token
    For example, If the host name is example.authentication.us01.hana.ondemand.com, enter the following access token URL:
    https://example.authentication.us01.hana.ondemand.com/oauth/token
    Client ID
    The client identifier of your application generated when you configure the application for OAuth.
    Client Secret
    The client secret generated for the client ID.
    Access Token
    The access token granted by the authorization server to access the SAP data.
    Enter the populated access token value that you get from the OAuth endpoint, or click Generate Access Token to populate the access token value.
    5Click Test Connection.

Create endpoint catalog sources for connection assignment

An endpoint catalog source represents a source system that the catalog source references. Before you perform connection assignment, create endpoint catalog sources and run the catalog source jobs.
You can then perform connection assignment to reference source systems to view complete lineage with source system objects.