skip to main content
Using the Driver : Configuring and Connecting to Data Sources : Configuring the Product Using the GUI
  

Try DataDirect Drivers Now

Configuring the Product Using the GUI

On Windows, data sources are stored in the Windows Registry. You can configure and modify data sources through the ODBC Administrator using a driver Setup dialog box, as described in this section.
On UNIX and Linux, the GUI is not supported.
When the driver is first installed, the values of its connection options are set by default. These values appear on the driver Setup dialog box tabs when you create a new data source. You can change these default values by modifying the data source. In the following procedure, the description of each tab is followed by a table that lists the connection options for that tab and their initial default values. This table links you to a complete description of the options and their connection string attribute equivalents. The connection string attributes are used to override the default values of the data source if you want to change these values at connection time.
To configure a Google BigQuery data source:
1. Start the ODBC Administrator by selecting its icon from the Progress DataDirect for ODBC program group.
2. Select a tab:
*User DSN: If you are configuring an existing user data source, select the data source name and click Configure to display the driver Setup dialog box.
If you are configuring a new user data source, click Add to display a list of installed drivers. Select the driver and click Finish to display the driver Setup dialog box.
*System DSN: If you are configuring an existing system data source, select the data source name and click Configure to display the driver Setup dialog box.
If you are configuring a new system data source, click Add to display a list of installed drivers. Select the driver and click Finish to display the driver Setup dialog box.
*File DSN: If you are configuring an existing file data source, select the data source file and click Configure to display the driver Setup dialog box.
If you are configuring a new file data source, click Add to display a list of installed drivers; then, select a driver. Click Advanced if you want to specify attributes; otherwise, click Next to proceed. Specify a name for the data source and click Next. Verify the data source information; then, click Finish to display the driver Setup dialog box.
3. The General tab of the Setup dialog box appears by default.
Figure 1. General tab
The General tab of the ODBC Google BigQuery Driver Setup dialog box
On this tab, provide values for the options in the following table; then, click Apply. The table provides links to descriptions of the connection options. The General tab displays fields that are required for creating a data source. The fields on all other tabs are optional, unless noted otherwise.
Connection Options: General
Description
Specifies the name of a data source in your Windows Registry or odbc.ini file.
Default: None
Specifies an optional long description of a data source. This description is not used as a runtime connection attribute, but does appear in the ODBC.INI section of the Registry and in the odbc.ini file.
Default: None
Specifies the name of the project that you want the driver to connect to. The projects in Google BigQuery are equivalent to catalogs in ODBC.
Default: None
Specifies the name of the dataset that you want the driver to connect to. The datasets in Google BigQuery are equivalent to schemas in ODBC.
Default: None
Specifies the name and location of the configuration file where the relational map of native data is written. The driver looks for this file when connecting to a Google BigQuery instance. If the file does not exist, the driver creates one.
Default:
application_data_folder\Local\Progress\DataDirect\Google BigQuery Schema\ClientID.config
Determines which authentication method the driver uses when establishing a connection.
If set to OAuth2.0, the driver uses OAuth 2.0 authentication when establishing a connection.
If set to ServiceAccount, the driver uses service account authentication when establishing a connection.
Default: OAuth2.0
Specifies the consumer key for your application.
Default: None
Specifies the consumer secret for your application.
Default: None
Specifies the refresh token used to either request a new access token or renew an expired access token.
Default: None
Specifies the access token required to authenticate to a Google BigQuery instance.
Default: None
4. At any point during the configuration process, you can click Test Connect to attempt to connect to the data source using the connection options specified in the driver Setup dialog box. The driver returns a message indicating success or failure.
5. To further configure your driver, click on the following tabs. The corresponding sections provide details on the fields specific to each configuration tab:
*SQL Engine tab allows you to configure the SQL Engine's behavior.
*Advanced tab allows you to configure advanced behavior.
*Web Service tab allows you to configure the behavior of communications between the driver and the web service.
*Pooling tab allows you to configure connection pooling behavior.
*Bulk tab allows you to configure the driver to use the Google BigQuery Storage API.
6. Click OK. When you click OK, the values you have specified become the defaults when you connect to the data source. You can change these defaults by using this procedure to reconfigure your data source. You can override these defaults by connecting to the data source using a connection string with alternate values.
* SQL Engine Tab
* Advanced Tab
* Web Service Tab
* Pooling Tab
* Bulk Tab