README
     Progress(R) DataDirect(R)
     Progress(R) DataDirect(R) for ODBC for Google BigQuery(TM)

     Windows Platforms(32- and 64-bit) 

     8.0.0 Release
     October 10, 2019


***********************************************************************
Copyright (C) 2019 Progress Software Corporation and/or its 
subsidiaries or affiliates. All Rights Reserved. 
***********************************************************************


CONTENTS

Installation Directory 
Driver Requirements
Release 8.0.0 Features  
Notes, Known Problems, and Restrictions
Driver Workaround Options
Documentation
Installed Files for 32-bit Drivers
Installed Files for 64-bit Drivers


    Installation Directory

* The default installation directory for the 32-bit driver on a 64-bit 
  system is:

  C:\Program Files (x86)\Progress\DataDirect\ODBC

* The default installation directory for all other installations is:

  C:\Program Files\Progress\DataDirect\ODBC	


    Driver Requirements

The driver requires a Java Virtual Machine (JVM) that is Java SE 8 or higher,
including Oracle JDK, OpenJDK, and IBM SDK (Java) distributions.


    Release 8.0.0 Features  

The Progress DataDirect for ODBC for Google BigQuery driver supports both 
standard and legacy SQL dialects of Google BigQuery. It supports create, read, 
update, and delete operations in internal tables (stored inside Google
BigQuery) and read operations in external tables (stored in data sources 
outside Google BigQuery). In addition, the driver:

* Serves as a complete pass-through driver, leveraging the SQL engine 
  functionality of Google BigQuery to execute SQL queries.
  
* Returns data for complex data types, such as Array and Struct, as JSON 
  strings, which are easy to comprehend for ODBC applications.
  
* Provides proxy support using ProxyHost, ProxyPassword, ProxyPort, and 
  ProxyUser connection properties.

* Supports the handling of large result sets with configurable paging and the 
  FetchSize and WSFetchSize connection properties. 
  
 
	Notes, Known Problems, and Restrictions 

The following are notes, known problems, and restrictions for the 
8.0 release of the driver:

* For metadata calls, the driver returns catalog as null and schema 
  in catalog.schema format. For example, for the following call: 
  getTables(p1,d1,t1,null), where p1 is project, d1 is dataset, and t1 is table,
  the driver will return catalog as null and schema as p1.d1. Note that  
  catalog and schema are equivalent to project and dataset in 
  Google BigQuery.

* If the file type of the private key file used for service account 
  authentication is .p12, the authentication will fail, unless the 
  skipDDPKIProvider system property is set to true.

* The driver will potentially assemble an unusable CLASSPATH when 
  there are multiple drivers installed and the underlying framework's
  version is different in each of the jars when JVMClassPath argument is
  not pointed to the required jar.


    Documentation  

THE PROGRESS DATADIRECT FOR ODBC FOR GOOGLE BIGQUERY DRIVER 
USER'S GUIDE
------------------------------------------------------------	 
The User's Guide is provided in PDF and HTML versions. Both versions 
are installed in the GoogleBigQueryHelp subdirectory of your product 
installation directory. You can access the HTML help by opening the 
index.html file or by clicking the Help button on the driver setup 
dialog. The PDF version, which you can view using Adobe Reader, can
be viewed by opening the bigqueryodbcuser.pdf file.

NOTE: To download Adobe Reader, visit the Adobe website at 
http://www.adobe.com.
  
  
   Installed Files the 32-bit Driver

This file list assumes a full installation of the driver and 
documentation.

The installer copies the following file to the Windows system 
directory:

ivtrc28.dll                       DataDirect trace library

The installer copies the following files and subdirectories to the 
product installation directory, by default:

For 32-bit drivers on 64-bit machines:
  C:\Program Files (x86)\Progress\DataDirect\ODBC\:

For all other installations:
  C:\Program Files\Progress\DataDirect\ODBC\:

license.txt                       Progress DataDirect license agreement

\drivers:
ivicu28.dll                       Unicode conversion tables
ivgbq28.dll                       DataDirect Driver for Google BigQuery 
ivgbq28r.dll                      DataDirect Driver for Google BigQuery
                                  resource file
ivgbq28s.dll                      DataDirect Driver for Google BigQuery
                                  setup library 
ivcurl28.dll                      Library used for HTTP connection
IVODBC.LIC                        DataDirect License File
ivtrc28.dll                       DataDirect trace library
qesqlext.h                        Header file for DataDirect-specific ODBC 
                                  Definitions

\help\GoogleBigQueryHelp 					
INDEX.HTML                        HTML help system entry file
bigqueryodbcuser.pdf              PDF copy of the User's Guide
\*.*                              Support folders for the HTML help system
					
\java\lib:
googlebigquery.jar                Java components for the driver

\jre
*.*                               Files associated with the installer program

\NOTICES:
ODBC for Google BigQuery 
v8.0 notices.txt                  Third-party vendor license agreements

\READMES:
ODBC for Google BigQuery 
v8.0 readme.txt                   This file

\samples:
\example\ddlogging.properties     Log configuration file for the 
                                  Google BigQuery driver
\example\example.c                Example source
\example\Example.exe              Example application
\example\example.h                Example header
\example\Example.mak              Example make file
\example\Example.sln              Example solution file
\example\example.txt              Example description
\example\Example.vcproj           Example project file

\translat\LIBMAIN.C				  
\translat\README.TRN              Translation Library example description
\translat\TRANSLAT.C              Translation Library example source file
\translat\WINNT.MAK               Translation Library example make file

\Tableau:
DataDirect GoogleBigQuery.tdc     Tableau data source file 

\tools:
ddextwin.exe                      License Extender utility
ddprocinfo.exe                    Processor Information utility
DSNConverterSil.exe               Data Source Converter utility
googlebigqueryserver32.exe        The Google BigQuery SQL Server Engine 
XMLP.exe                          A GUI demo tool that persists a result set                                    
                                  to an XML data file							
								
\uninstall\*.*                    Files used to uninstall the product								


   Installed Files the 64-bit Driver

This file list assumes a full installation of the driver and 
documentation.

The installer copies the following file to the Windows system 
directory:

ddtrc28.dll                       DataDirect trace library

The installer copies the following files and subdirectories to the 
product installation directory, by default:

  C:\Program Files\Progress\DataDirect\ODBC\:

license.txt                       Progress DataDirect license agreement

\drivers:
ddgbq28.dll                       DataDirect Driver for Google BigQuery 
ddgbq28r.dll                      DataDirect Driver for Google BigQuery
                                  resource file
ddgbq28s.dll                      DataDirect Driver for Google BigQuery
                                  setup library 
ddcurl28.dll                      Library used for HTTP connection
ddicu28.dll                       Unicode conversion tables
DDODBC.LIC                        DataDirect License File
ddtrc28.dll                       DataDirect trace library
qesqlext.h                        Header file for DataDirect-specific ODBC 
                                  Definitions

\help\GoogleBigQueryHelp 					
INDEX.HTML                        HTML help system entry file
\*.*                              Support folders for the HTML help system
					
\java\lib:
googlebigquery.jar                Java components for the driver

\jre
*.*                               Files associated with the installer program

\NOTICES:
ODBC for Google BigQuery 
v8.0 notices.txt                  Third-party vendor license agreements

\READMES:
ODBC for Google BigQuery 
v8.0 readme.txt                   This file

\samples:
\example\ddlogging.properties     Log configuration file for the 
                                  Google BigQuery driver
\example\example.c                Example source
\example\Example.exe              Example application
\example\example.h                Example header
\example\Example.mak              Example make file
\example\Example.sln              Example solution file
\example\example.txt              Example description
\example\Example.vcproj           Example project file

\translat\LIBMAIN.C				  
\translat\README.TRN              Translation Library example description
\translat\TRANSLAT.C              Translation Library example source file
\translat\WINNT.MAK               Translation Library example make file

\tools:
ddextwin.exe                      License Extender utility
ddprocinfo.exe                    Processor Information utility
DSNConverterSil.exe               Data Source Converter utility
googlebigqueryserver64.exe        The Google BigQuery SQL Server Engine 
XMLP.exe                          A GUI demo tool that persists a result set to 
                                  an XML data file					
\tools\Tableau:
DataDirect GoogleBigQuery.tdc     Tableau data source file		
								
\uninstall\*.*                    Files used to uninstall the product		



~~~~~~~~~~~~~~
October 10, 2019
End of README.TXT