Simba ODBC Driver with SQL Connector for Google BigQuery

Transcription

1 Simba ODBC Driver with SQL Connector for Google BigQuery for Windows Simba Technologies Inc. Revised: February 12, 2015

2 Contents Purpose... 3 Accessing BigQuery... 3 Using sample data in BigQuery... 3 Install the Simba ODBC Driver with SQL Connector for Google BigQuery... 3 Configuring the Simba ODBC Driver with SQL Connector for Google BigQuery... 3 Connect to the Data Source... 4 Using Excel... 4 Using Tableau... 5 Contact Us... 6 Appendix: Troubleshooting... 7 Architecture Mismatch Problems... 7 For assistance at any point in this installation process, please contact Simba for free Engineering Level Support at: techsupport@simba.com. Page 2

3 Purpose The Simba ODBC Driver with SQL Connector for Google BigQuery for Windows is targeted towards users of the Simba ODBC Driver with SQL Connector for Google BigQuery, showing you how to set up your environment quickly so that you can evaluate and use the driver. Accessing BigQuery Google BigQuery is a cloud service, so you do not need to install it. You only need to sign up for the service. Follow the instructions at to sign up for Google BigQuery. Note: BigQuery offers a free tier for queries, but you must set up billing and create a project to bill before you can run queries and test the driver in an application. Using sample data in BigQuery BigQuery provides a sample data set called publicdata, which you can use for trial purposes. If you would like to input your own data, follow the instructions at Install the Simba ODBC Driver with SQL Connector for Google BigQuery The Simba ODBC Driver with SQL Connector for Google BigQuery is available for download from For details on installing the driver, refer to the Simba ODBC Driver with SQL Connector for Google BigQuery Installation and Configuration Guide, which is available for download on the Documentation tab at Configuring the Simba ODBC Driver with SQL Connector for Google BigQuery To use the Simba ODBC Driver with SQL Connector for Google BigQuery, you need to configure a Data Source Name (DSN) to connect to your data source using a client application, such as Microsoft Excel or Tableau. Page 3

4 To create a Data Source Name: 1. Click the Start button, then click All Programs, then click the Simba BigQuery ODBC Driver 1.1 program group corresponding to the bitness of the client application accessing BigQuery, and then click ODBC Administrator 2. Click the System DSN tab. 3. Select the Sample Simba BigQuery DSN in the list of DSNs, and then click Configure 4. To provide the DSN with the necessary credentials for accessing your BigQuery data, click the Sign In button and then do the following: a. In the browser that opens, type your credentials for accessing your BigQuery data, and then click Sign in b. When prompted to allow BigQuery Client Tools to access your data in Google BigQuery, click Accept c. Copy the code that Google provides, and then paste the code in the Confirmation Code field in the Simba BigQuery ODBC Driver DSN Setup dialog box. When you paste the confirmation code, the Refresh Token field populates automatically. The refresh token is used whenever the driver needs to access your BigQuery data. 5. In the Catalog (Project) list, select publicdata 6. In the Billed Project list, select the project to bill for queries that are run using the DSN. 7. To test your connection to BigQuery, click the Test button. The Test Results dialog box appears, displaying a message informing you if the connection succeeded or failed. Click OK to close the Test Results dialog box. 8. Click OK to close the Simba BigQuery ODBC Driver DSN Setup dialog box, and then click OK to close the ODBC Data Source Administrator. Connect to the Data Source After creating a Data Source Name for connecting to your BigQuery data source, you can connect to the data source using a client application, such as Microsoft Excel or Tableau. Using Excel Note: The following procedure is written for Microsoft Excel Page 4

5 To connect to your BigQuery data source using Excel: 1. In Excel, select the Data tab in the ribbon, then click From Other Sources in the Get External Data group, and then click From Data Connection Wizard 2. In the Data Connection Wizard, select ODBC DSN in the list of data source types, and then click Next 3. In the list of ODBC data sources, select Sample Simba BigQuery DSN (or another DSN that you have created and tested) and click Next Important: If the connection fails, confirm that the bitness of the driver that you are using matches the bitness of Excel. If you are using the 32-bit version of Excel, then you need to use the 32-bit version of the driver. If you are using the 64-bit version of Excel, then you need to use the 64-bit version of the driver. For details about diagnosing the issue, see Architecture Mismatch Problems on page Select the table that you wish to query and then click Finish 5. In the Import Data dialog box, you can specify the cell where you want the top-left corner of the table to appear. Leave the location set to the default value (=$A$1) and click OK Data from the retrieved table appears in the current Excel worksheet. Using Tableau Note: The following procedures are written for Tableau 8. The Simba ODBC Driver with SQL Connector for Google BigQuery also supports Tableau 7. To connect to your BigQuery data source using Tableau: 1. In Tableau, click Connect to Data in the left navigation pane, and then select Google BigQuery 2. Type your credentials for accessing your BigQuery data, and then click Sign In 3. When prompted to allow Tableau to access your BigQuery account, click Accept Important: If the connection fails, confirm that the bitness of the driver that you are using matches the bitness of Tableau. If you are using the 32-bit version of Tableau, then you need to use the 32-bit version of the driver. If you are using the 64-bit version of Tableau, then you need to use the 64-bit version of the driver. For more information about diagnosing the issue, see Architecture Mismatch Problems on page In the Google BigQuery Connection dialog box, in the Project list, select publicdata 5. In the Dataset list, select samples 6. Select the Single Table option and click the magnifying glass to open a list of tables. 7. Select the shakespeare table and then click Select Page 5

6 8. To load the selected table, click OK If the following warning appears, click OK: This warning appears because Tableau sees only a generic driver and attempts to determine the capabilities of the driver. The warning does not affect how the driver will operate in Tableau. 9. In the Data Connection dialog box, click Connect live so that Tableau does not import all of the data and you work on the data in BigQuery. Data retrieved from the selected table appears in Tableau, with the columns listed as dimensions or measures depending on the data type. You can now create reports on the table you selected. Contact Us If you have difficulty using the driver, please contact our Technical Support staff. We welcome your questions, comments, and feature requests. Technical Support is available Monday to Friday from 8 a.m. to 5 p.m. Pacific Time. Important: To help us assist you, prior to contacting Technical Support please prepare a detailed summary of the client and server environment including operating system version, patch level, and configuration. You can contact Technical Support via: support@simba.com Web site: Telephone: (604) Extension 3 Fax: (604) You can also follow us on Page 6

7 Appendix: Troubleshooting Architecture Mismatch Problems If you encounter an error message similar to The specified DSN contains an architecture mismatch between the Driver and Application, then the bitness of the application that you are using to connect to the BigQuery data source does not match the bitness of the Simba ODBC Driver with SQL Connector for Google BigQuery. You may be attempting to connect a 32-bit application to a 64-bit driver, or vice versa. Ensure that the bitness of your application matches the bitness of driver that you are trying to use. Note: All versions of Excel 2007 and earlier are 32-bit applications. To determine the bitness of Excel 2010: In Excel 2010, click the File tab in the ribbon, and then click Help in the left navigation pane. In the right pane, the first line of text in the About Microsoft Excel area displays the bitness of your Excel application next to the version number. Figure 1 highlights the location of the version number and bitness. Figure 1 Determining the bitness of Excel 2010 Page 7

8 To determine the bitness of Excel 2013: In Excel 2013, click the File tab in the ribbon, then click Account in the left navigation pane, and then click the About Excel button. In the About Microsoft Excel dialog box, the first line of text displays the bitness of your Excel application next to the version number. Figure 2 highlights the location of the version number and bitness. To determine the bitness of Tableau: Figure 2 Determining the bitness of Excel 2013 In Tableau, click the Help menu, and then click About Tableau The About Tableau dialog box displays the bitness of your Tableau application in the top right corner, next to the version number. Page 8