Update credentials and re-enable a disabled Data Pipeline

Learn how to update failed credentials and re-enable a disabled data pipeline.

Reltio Data Pipelines require valid storage or authentication credentials to connect to their destinations. When a credential becomes invalid, the destination rejects authentication or data-write requests. After three failed credential attempts, Reltio notifies the configured recipients, then disables the affected Data Pipeline.

To resume data export, update the failed credential, validate the updated configuration, and re-enable the Data Pipeline. Then synchronize the tenant data that was not delivered while the pipeline was disabled.

Review Credential expiry alerts for Reltio Data Pipelines for information about credential-failure notifications.

To update credentials and re-enable a disabled Data Pipeline

Update the failed credential.
Update the credential identified in the credential-failure notification.
- Databricks: Renew the cloud storage credential in the cloud account named in the email, and store the updated credential securely. For more information, see Configure the Reltio Data Pipeline for Databricks.
- Google BigQuery: Generate or renew the GCP service-account key and update the pipeline credential. For more information, see Configure the Reltio Data Pipeline for GBQ.
- Snowflake (Staging Pipeline): Renew the cloud storage credential in the cloud account named in the email, and store the updated credential securely. For more information, see Configure the Reltio Data Pipeline for Snowflake (Staging Pipeline).
- Snowflake (Direct Connect): Set the current RSA public key on the Snowflake user with ALTER USER <user> SET RSA_PUBLIC_KEY='<public_key>';. For more information on the key-pair configuration steps, see Authenticate your Snowflake account with RSA public key.
Validate the updated configuration.
Send the validation request with a valid access token for the affected Data Pipeline:
```
POST https://{{environment}}-data-pipeline-hub.reltio.com/api/tenants/{{tenantId}}/adapters/{{adapterName}}/validate
```
The {{adapterName}} value is the name of your Data Pipeline.
A 200 OK response confirms that the Data Pipeline can connect to the destination using the updated credential. Re-enable the Data Pipeline after validation succeeds.
Re-enable the Data Pipeline.

In Console > Tenant Management > Data Sharing > Data Pipelines, locate the affected pipeline and turn on Status. The Data Pipeline resumes exporting new tenant events to the destination.
Synchronize missed tenant data to the destination.
Re-enabling the Data Pipeline resumes delivery of new events but does not automatically send events that were missed while the pipeline was disabled.
Run the Sync to Data Pipeline API and set updatedSince to the timestamp when the Data Pipeline stopped exporting data. The API synchronizes objects updated after that timestamp. If you omit updatedSince, its default value is 0, and the API synchronizes all tenant data.

Result

The failed credential is updated and validated, and the affected Data Pipeline is re-enabled. Reltio resumes delivery of new tenant events to the destination.

The synchronization task synchronizes objects updated after the timestamp specified in updatedSince.

Verification steps

To confirm the pipeline is restored, perform the following steps:

In Console > Tenant Management > Data Sharing > Data Pipelines, confirm Status is on for the affected Data Pipeline.
In Console > Tenant Management > Jobs, confirm that the Sync to Data Pipeline API task has completed successfully.

Unify and manage your data

Update credentials and re-enable a disabled Data Pipeline

Footer