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 for soda_cloud at the root level of the YAML file, not nested under any other data_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 for api_key_id.
- Copy the API Key Secret, then paste it into the configuration.yml as the value for api_key_secret.
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!

Request a docs change.
Edit this page in our GitHub repo.