README
     Progress(R) DataDirect(R) 
     Progress(R) DataDirect(R) for JDBC(TM) for Google BigQuery(TM) Driver
     Release 6.0.0 
     August 2019


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


CONTENTS

Requirements
Installation Directory
Release 6.0.0 Features
Notes, Known Problems, and Restrictions
Documentation
Installed Files


     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.


     Installation Directory

The default installation directory for the driver is:

* Windows:
  C:\Program Files\Progress\DataDirect\JDBC_60

* UNIX/Linux:
  /opt/Progress/DataDirect/JDBC_60
  Note: For UNIX/Linux, if you do not have access to "/opt", your user's home
  directory will take the place of this directory.


    Release 6.0.0 Features 

The Progress DataDirect for JDBC for Google BigQuery driver supports both 
standard and legacy SQL dialects of Google BigQuery. It allows 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, it:

* Serves as a complete pass-through driver. It leverages 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 JDBC 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 with release 6.0.0 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.

  
    Documentation	 	 

PROGRESS DATADIRECT FOR JDBC FOR GOOGLE BIGQUERY DRIVER USER'S GUIDE 
---------------------------------------------------------------------
The user's guide is available as an HTML help system and as a PDF.

* The HTML help system and PDF are installed in the GoogleBigQueryHelp 
  subdirectory of your product installation directory.

* The HTML help system and the PDF are also available on this Progress
  DataDirect documentation web page:
  https://www.progress.com/documentation/datadirect-connectors


    Installed Files

When you extract the contents of the installation download package to your
installer directory, you will notice the following files that are required to
install the driver:

*  Windows:
   - PROGRESS_DATADIRECT_JDBC_INSTALL.exe
   - PROGRESS_DATADIRECT_JDBC_GOOGLEBIGQUERY_6.0.0_INSTALL.iam.zip
   - PROGRESS_DATADIRECT_JDBC_COMMON_6.0.0_INSTALL.iam.zip
   - PROGRESS_DATADIRECT_JDBC_DOCUMENTATION_6.0.0_INSTALL.iam.zip

*  Non-Windows:
   - PROGRESS_DATADIRECT_JDBC_INSTALL.jar
   - PROGRESS_DATADIRECT_JDBC_GOOGLEBIGQUERY_6.0.0_INSTALL.iam.zip
   - PROGRESS_DATADIRECT_JDBC_COMMON_6.0.0_INSTALL.iam.zip
   - PROGRESS_DATADIRECT_JDBC_DOCUMENTATION_6.0.0_INSTALL.iam.zip

When you install the driver, the installer creates the following directories and
files in the product installation directory in the default installation
directory or in an installation directory you specify, represented by
INSTALL_DIR.


INSTALL_DIR/:
-------------
LicenseTool.jar            Product license file manager

ddprocinfo.exe             Windows executable to start the Processor Information
                           Utility

ddprocinfo                 UNIX/Linux script to start the Processor Information
                           Utility


INSTALL_DIR/Examples/JNDI/:
---------------------------
JNDI_FILESYSTEM_Example.java
                           Example Java(TM) source file

JNDI_LDAP_Example.java     Example Java source file


INSTALL_DIR/Help/: 
------------------
GoogleBigQueryHelp/index.html    
                           Driver HTML help system entry file   

GoogleBigQueryHelp/bigqueryjdbcug.pdf     
                           User's guide PDF file

GoogleBigQueryHelp/*       Support files and folders for the driver 
                           help system


INSTALL_DIR/install/: 
---------------------
.psc_dd_inst_reg.xml       Support file for the installation logs

logs/*.*                   Log file generated upon installation


INSTALL_DIR/jre/:
-----------------
*.*                        Files associated with JRE installation


INSTALL_DIR/lib/:
-----------------
googlebigquery.jar         Google BigQuery Driver and DataSource classes

JDBCDriverLogin.conf       The JAAS login configuration file installed with the
                           driver                   


INSTALL_DIR/NOTICES/:
---------------------
JDBC for Google BigQuery v6.0 notices.txt
                           Third party agreement information


INSTALL_DIR/pool manager/:
--------------------------
pool.jar                   All DataDirect Connection Pool Manager classes


INSTALL_DIR/READMES/:
---------------------
JDBC for Google BigQuery v6.0 readme.txt
                           This file


INSTALL_DIR/Tableau/:
----------------------
DataDirect GoogleBigQuery.tdc
                           Tableau data source file


INSTALL_DIR/testforjdbc/:
-------------------------
Config.txt                 Configuration file for DataDirect Test

ddlogging.properties       Logging properties file

testforjdbc.bat            Batch file to start DataDirect Test

testforjdbc.sh             Shell script to start DataDirect Test

lib/testforjdbc.jar        DataDirect Test classes


INSTALL_DIR/uninstall/:
-----------------------
.com.zerog.registry.xml    Support file for the uninstaller

.psc_dd_uninst_reg.xml     Support file for the uninstaller

InstallScript.iap_xml      Support file for the uninstaller

installvariables.properties
                           Support file for the Windows uninstaller

Uninstall_JDBC_60.exe      Windows uninstaller

Uninstall_JDBC_60.lax      Support file for the Windows uninstaller

uninstaller.jar            Java uninstaller

googlebigquery/*.*         Support files for the uninstaller

resource/*.*               Resource files for the Windows uninstaller


August 2019
============
End of README