Skip to main content
Use this guide to configure the Salesforce Data360 connector. Configure and run Salesforce Data360 metadata workflows externally with YAML:

How to Run the Connector Externally

To run the Ingestion via the UI you’ll need to use the OpenMetadata Ingestion Container, which comes shipped with custom Airflow plugins to handle the workflow deployment. If, instead, you want to manage your workflows externally on your preferred orchestrator, you can check the following docs to run the Ingestion Framework anywhere.

External Schedulers

Get more information about running the Ingestion Framework Externally

Requirements

OpenMetadata connects to Salesforce Data360 through the Salesforce REST API using a connected app that authenticates with the OAuth 2.0 client credentials flow. You’ll need:
  • A Salesforce connected app configured for the OAuth 2.0 client credentials flow. The app provides the Consumer Key and Consumer Secret.
  • The Data360 (Data Cloud) API scopes — cdp_query_api and cdp_profile_api — granted to that connected app.
  • An integration user with permission to view the data spaces and objects you want to ingest: Data Lake Objects, Data Model Objects, and Calculated Insights.

Python Requirements

Use a Python version supported by the openmetadata-ingestion package that matches your OpenMetadata server. To find the supported range for your release, check the Requires-Python metadata of that release’s ingestion package. To run the Salesforce Data360 ingestion, install:

Metadata Ingestion

All connectors are defined as JSON Schemas. See the Salesforce Data360 connection JSON Schema for the structure used to create a connection to Salesforce Data360. To create and run a metadata ingestion workflow, create a YAML configuration. The configuration connects to the source, processes entities if needed, and reaches the OpenMetadata server. The workflow is modeled around the following JSON Schema.

1. Define the YAML Config

This is a sample config for Salesforce Data360:

2. Run with the CLI

First, we will need to save the YAML file. Afterward, and with all requirements installed, we can run:
Note that from connector to connector, this recipe will always be the same. By updating the YAML configuration, you will be able to extract metadata from different sources.