Connect Soda Core to Soda Cloud
To use all the features and functionality that Soda Cloud and Soda Core have to offer, you can install and configure the Soda Core command-line tool, then connect it to your Soda Cloud account.
Soda Core uses an API to connect to Soda Cloud. To use the API, you must generate API keys in your Soda Cloud account, then add them to the configuration YAML file that Soda Core uses to connect to your data sources. Note that the API keys you create do not expire.
Prerequisites
- You have installed and configured Soda Core and run at least one scan of your data.
OR - You followed steps in the Quick start for Soda Core and Soda Cloud to set up Soda Core and run at least one scan of your data.
Connect
- If you have not already done so, create a Soda Cloud account at cloud.soda.io.
- Open your
configuration.yml
file in a text editor, then add the following to the file. Be sure to add the syntax forsoda_cloud
at the root level of the YAML file, not nested under any otherdata_source
syntax.soda_cloud: host: cloud.soda.io api_key_id: api_key_secret:
- In your Soda Cloud account, navigate to your avatar > Profile > API Keys, then click the plus icon to generate new API keys.
- Copy the API Key ID, then paste it into the
configuration.yml
as the value forapi_key_id
. - Copy the API Key Secret, then paste it into the
configuration.yml
as the value forapi_key_secret
.
- Copy the API Key ID, then paste it into the
- Save the changes to the
configuration.yml
file. Close the Create API Key dialog box in Soda Cloud. - From the command-line, use Soda Core to scan the datasets in your data source again.
soda scan -d your_datasource_name -c configuration.yml checks.yml
- Navigate to your Soda Cloud account in your browser review the results of your latest scan in Monitor Results.
Go further
- Learn more about using SodaCL to write checks for data quality.
- Learn more about viewing failed rows in Soda Cloud.
- Learn more about Soda Cloud architecture.
- Need help? Join the Soda community on Slack.
Last modified on 01-Jul-22
Was this documentation helpful?
Share feedback in the Soda community on Slack.
Help improve our docs!