Set Up Cloud Data Connect for Integration Pipeline
Adaptive Planning
- A standard or cube sheet in Adaptive Planning that doesn't contain splits.
- Security:
- Model Management Accesspermission.
- Integration Operatorpermission.
- (Optional)Drill Into Cloud Imported Numberspermission when you use drill through on pipelines. For details, see Set Up Cloud Data Connect Drill Through on an Existing Pipeline.
Cloud Data Platform
- Ensure that your organization has access to a resource with expertise in configuring and administering your selected cloud data platform. If this expertise is not available internally, Workday service partners can provide assistance.
- The designated expert must be able to:
- Configure the required authentication method, such as an Azure service principal or a Snowflake programmatic access token.
- Create and manage tables or views in the cloud data platform.
- Grant the credentials used for the connection access to the required schemas and tables.
- If your organization restricts outbound access by domain or IP address, allow list the required domains and IP addresses for Adaptive Planning. For details, see Reference: Adaptive Planning Authentication URLs and IP Addresses.
- S3 on AWS as the Cloud Object Storage if you're using Databricks for Cloud Data Connect (CDC) and Design Integrations.The Databricks data source feature is released as Limited Availability. Contact your Named Support Contact to enable this feature. See Reference: Contact Us.
This topic explains how to create a new Cloud Data Connect (CDC) pipeline and how to edit an existing pipeline.
You can create a pipeline that loads data into Adaptive Planning standard sheets or cube sheets from either:
- Incorta.
- Microsoft Fabric.
- Snowflake.
- Databricks.
Behind the scenes, creating a pipeline automatically generates and bundles these components in Adaptive Planning Design Integrations:
- A data source.
- A loader.
- An integration task.
- SelectIntegrationfrom the main menu.
- SelectSetup Pipeline.
- Select where you want to load data from.
- Complete theSelect a Destinationpage:
Option Description Pipeline NameEnter a name for your pipeline.When you clear theOpt-in Manage Pipelinecheck box, you prepend this name to each separated component in Design Integrations.VersionSelect an Adaptive Planning version.SheetSelect an Adaptive Planning sheet.You can only select:- Cube sheets.
- Standard sheets.
Pipelines don't support loading to sheets that contain splits.All managed pipelines must have unique destinations (version and sheet), when creating, editing a draft, or duplicating a pipeline. - ClickDownload Table Template.
- Provide the template to your cloud data warehouse administrator so that they can:
- Create a view that exactly matches the template format and description.
- (Optional) Create a drill through table. This table should include the required columns, the template structure and custom columns for additional contextual information.
- Verify that your administrator:
- Creates the view from the template.
- Grants access to the new view to the credentials used for the pipeline.
- Complete theConfigure Connectionpage:
Option Description CredentialSelect either an existing credential or create a new one. You can use an existing credential to reuse it across pipeline connections.Ask your administrator for a credential that can access the view based on the downloaded table template.- For Microsoft Fabric, we support
- Username and password.
- Application ID and client secret.
- For Incorta, we support username and password.
- For Snowflake, we support:
- OAuth 2. See Set up Cloud Data Connect Snowflake OAuth2 Credentials.
- Personal access tokens as passwords.
- Key pair.
ServerEnter the Incorta or Microsoft Fabric environment link.PortEnter the port number for the Incorta environment.AccountEnter the Snowflake environment link.Unity Catalog Iceberg URLEnter the Databricks workspace URL.CatalogEnter the Databricks warehouse name.S3 RegionEnter the S3 buckets region.DatabaseEnter the warehouse name containing the relevant table or tables from your cloud data warehouse environment.Data Source TableSelect the table created in the environment that matches the downloaded table template format.Drill Through Table(Optional) Select the table in the environment that adheres to the structure advised in the template along with any custom columns. - Review your setup.
- (Optional) Clear theOpt-in Manage Pipelinescheck box if you don't want to manage this connection as a pipeline.When you clear this check box, you must manage the automatically created data source, loader, and task within Design Integrations.Adaptive Planning only supports Drill Through to Data for CDC managed pipelines, not CDC connections managed through Design Integrations.
- ClickComplete.
- On thePipelinespage, clickPipelinesto refresh the page and verifyConnectedstatus.It might take a few minutes to connect the new pipeline.
- SelectAll Tasks.
- Select the task named after your pipeline.This task is the integration task that we automatically generated when you created the pipeline. You can enter a search term at the top to filter tasks.
- ClickLaunch New Task Instance.
- Verify the period range and plan version.
- SelectRun.TheStatuscolumn might take a few moments to update. This column either:
- Confirms success.
- Logs errors.
- Verify the data in the Adaptive Planning sheet.
- SelectIntegrationfrom the main menu.
- Select
- Select the pipeline nameorselectEditfrom the related actions menu.
- Update settings onSelect A DestinationandConfigure Connection.
- Save your changes.
Edit a pipeline
You can update destination and connection settings without recreating the pipeline.
Pipelines in Connecting status are view-only until they reach
Connected
or Disconnected
status.Workday creates or updates the pipeline connection and loads data from Incorta, Microsoft Fabric, Snowflake, or Databricks to the intended sheet.