How to Query Salesforce Data 360 Data in MySQL Workbench

Jerod Johnson
Jerod Johnson
Director, Technology Evangelism
Execute MySQL queries against live Salesforce Data 360 data from MySQL Workbench.

You can use the SQL Gateway from the ODBC Driver for Salesforce Data 360 to query Salesforce Data 360 data through a MySQL interface. Follow the procedure below to start the MySQL remoting service of the SQL Gateway and work with live Salesforce Data 360 data in MySQL Workbench.

Connect to Salesforce Data 360 Data

If you have not already done so, provide values for the required connection properties in the data source name (DSN). You can use the built-in Microsoft ODBC Data Source Administrator to configure the DSN. This is also the last step of the driver installation. See the "Getting Started" chapter in the help documentation for a guide to using the Microsoft ODBC Data Source Administrator to create and configure a DSN.

Salesforce Data 360 supports authentication via the OAuth standard.

OAuth

Set AuthScheme to OAuth.

Desktop Applications

CData provides an embedded OAuth application that simplifies authentication at the desktop.

You can also authenticate from the desktop via a custom OAuth application, which you configure and register at the Salesforce Data 360 console. For further information, see Creating a Custom OAuth App in the Help documentation.

Before you connect, set these properties:

  • InitiateOAuth: GETANDREFRESH. You can use InitiateOAuth to avoid repeating the OAuth exchange and manually setting the OAuthAccessToken.
  • OAuthClientId (custom applications only): The Client ID assigned when you registered your custom OAuth application.
  • OAuthClientSecret (custom applications only): The Client Secret assigned when you registered your custom OAuth application.

When you connect, the driver opens Salesforce Data 360's OAuth endpoint in your default browser. Log in and grant permissions to the application.

The driver then completes the OAuth process as follows:

  • Extracts the access token from the callback URL.
  • Obtains a new access token when the old one expires.
  • Saves OAuth values in OAuthSettingsLocation so that they persist across connections.
  • For other OAuth methods, including Web Applications and Headless Machines, refer to the Help documentation.

    Configure the SQL Gateway

    See the SQL Gateway Overview to set up connectivity to Salesforce Data 360 data as a virtual MySQL database. You will configure a MySQL remoting service that listens for MySQL requests from clients. The service can be configured in the SQL Gateway UI.

    Creating a MySQL Remoting Service in SQL Gateway (Salesforce is shown)

    Query Salesforce Data 360 from MySQL Workbench

    The steps below outline connecting to the virtual Salesforce Data 360 database created in the SQL Gateway from MySQL Workbench and issuing basic queries to work with live Salesforce Data 360 data.

    Connect to Salesforce Data 360 through the SQL Gateway

    1. In MySQL Workbench, click to add a new MySQL connection.
    2. Name the connection (CData SQL Gateway for Salesforce Data 360).
    3. Set the Hostname, Port, and Username parameters to connect to the SQL Gateway.
    4. Click Store in Vault to set and store the password.
    5. Click Test Connection to ensure the connection is configured properly and click OK.

    NOTE: When we refer to Username and Password, we mean the credentials for the user(s) created for the SQL Gateway.

    Query Salesforce Data 360 Data

    1. Open the connection you just created (CData SQL Gateway for Salesforce Data 360).
    2. Click File -> New Query Tab.
    3. Write a SQL query to retrieve Salesforce Data 360 data, like SELECT * FROM `CData SalesforceDataCloud Sys`.Account;

    With access to live Salesforce Data 360 data from MySQL Workbench, you can easily work with Salesforce Data 360, just like you would a MySQL database. Get started now with a free, 30-day trial of the CData ODBC Driver for Salesforce Data 360 and the CData SQL Gateway.

Ready to get started?

Download a free trial of the Salesforce Data Cloud ODBC Driver to get started:

 Download Now

Learn more:

Salesforce Data Cloud Icon Salesforce Data 360 ODBC Driver

The Salesforce Data 360 ODBC Driver is a powerful tool that allows you to connect with live data from Salesforce Data 360, directly from any applications that support ODBC connectivity.

Access Salesforce Data 360 data like you would a database - read Salesforce Data 360 DataGraph, DataLakeObject, DataModelObjects, CalculatedInsights, etc. through a standard ODBC Driver interface.