Skip to content
This repository was archived by the owner on Sep 20, 2023. It is now read-only.

Commit 08fa4de

Browse files
laughingman7743laughingman7743
authored
Merge pull request #79 from laughingman7743/update_jdbc_driver_to_2.0.7
Update JDBC driver to 2.0.7
2 parents 4657f88 + 90f92e7 commit 08fa4de

5 files changed

Lines changed: 461 additions & 67 deletions

File tree

‎README.rst‎

Lines changed: 10 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -39,7 +39,7 @@ JDBC driver compatibility
3939
+---------------+---------------------+-------------------------------------------------------------------------------+
4040
| Version | JDBC driver version | Vendor |
4141
+===============+=====================+===============================================================================+
42-
| < 2.0.0 | == 1.1.0 | AWS (Early released jdbc driver. It is incompatible with Simba's JDBC driver) |
42+
| < 2.0.0 | == 1.1.0 | AWS (Early released JDBC driver. It is incompatible with Simba's JDBC driver) |
4343
+---------------+---------------------+-------------------------------------------------------------------------------+
4444
| >= 2.0.0 | >= 2.0.5 | Simba |
4545
+---------------+---------------------+-------------------------------------------------------------------------------+
@@ -163,17 +163,17 @@ JDBC 4.1
163163
If you want to use JDBC 4.1, download the corresponding JDBC driver
164164
and specify the path of the downloaded JDBC driver as the argument ``driver_path`` of the connect method or connection object.
165165

166-
* The `AthenaJDBC41-2.0.6.jar`_ is compatible with JDBC 4.1 and requires JDK 7.0 or later.
166+
* The `AthenaJDBC41-2.0.7.jar`_ is compatible with JDBC 4.1 and requires JDK 7.0 or later.
167167

168-
.. _`AthenaJDBC41-2.0.6.jar`: https://s3.amazonaws.com/athena-downloads/drivers/JDBC/SimbaAthenaJDBC_2.0.6/AthenaJDBC41_2.0.6.jar
168+
.. _`AthenaJDBC41-2.0.7.jar`: https://s3.amazonaws.com/athena-downloads/drivers/JDBC/SimbaAthenaJDBC_2.0.7/AthenaJDBC41_2.0.7.jar
169169

170170
.. code:: python
171171
172172
from pyathenajdbc import connect
173173
174174
conn = connect(s3_staging_dir='s3://YOUR_S3_BUCKET/path/to/',
175175
region_name='us-west-2',
176-
driver_path='/path/to/AthenaJDBC41_2.0.6.jar')
176+
driver_path='/path/to/AthenaJDBC41_2.0.7.jar')
177177
178178
JDBC driver configuration options
179179
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -195,7 +195,7 @@ For details of the JDBC driver options refer to the official documentation.
195195

196196
* `JDBC Driver Installation and Configuration Guide`_.
197197

198-
.. _`JDBC Driver Installation and Configuration Guide`: https://s3.amazonaws.com/athena-downloads/drivers/JDBC/SimbaAthenaJDBC_2.0.6/docs/Simba+Athena+JDBC+Driver+Install+and+Configuration+Guide.pdf
198+
.. _`JDBC Driver Installation and Configuration Guide`: https://s3.amazonaws.com/athena-downloads/drivers/JDBC/SimbaAthenaJDBC_2.0.7/docs/Simba+Athena+JDBC+Driver+Install+and+Configuration+Guide.pdf
199199

200200
NOTE: Option names and values are case-sensitive. The option value is specified as a character string.
201201

@@ -437,7 +437,9 @@ For the license of JDBC driver, please check the following link.
437437
* `JDBC driver release notes`_
438438
* `JDBC driver license`_
439439
* `JDBC driver notices`_
440+
* `JDBC driver third-party licenses`_
440441

441-
.. _`JDBC driver release notes`: https://s3.amazonaws.com/athena-downloads/drivers/JDBC/SimbaAthenaJDBC_2.0.6/docs/release-notes.txt
442-
.. _`JDBC driver License`: https://s3.amazonaws.com/athena-downloads/drivers/JDBC/SimbaAthenaJDBC_2.0.6/docs/LICENSE.txt
443-
.. _`JDBC driver notices`: https://s3.amazonaws.com/athena-downloads/drivers/JDBC/SimbaAthenaJDBC_2.0.6/docs/NOTICES.txt
442+
.. _`JDBC driver release notes`: https://s3.amazonaws.com/athena-downloads/drivers/JDBC/SimbaAthenaJDBC_2.0.7/docs/release-notes.txt
443+
.. _`JDBC driver License`: https://s3.amazonaws.com/athena-downloads/drivers/JDBC/SimbaAthenaJDBC_2.0.7/docs/LICENSE.txt
444+
.. _`JDBC driver notices`: https://s3.amazonaws.com/athena-downloads/drivers/JDBC/SimbaAthenaJDBC_2.0.7/docs/NOTICES.txt
445+
.. _`JDBC driver third-party licenses`: https://s3.amazonaws.com/athena-downloads/drivers/JDBC/SimbaAthenaJDBC_2.0.7/docs/third-party-licenses.txt

‎jdbc/release-notes.txt‎

Lines changed: 185 additions & 57 deletions
Original file line numberDiff line numberDiff line change
@@ -1,81 +1,206 @@
1-
=============================================================================
2-
Simba Athena JDBC Driver with SQL Connector Release Notes
3-
=============================================================================
1+
==============================================================================
2+
Simba Athena JDBC Driver with SQL Connector Release Notes
3+
==============================================================================
44

5-
The release notes provide details of enhancements, features, and known issues
6-
in Simba Athena JDBC Driver 2.0.2, as well as the version history.
5+
The release notes provide details of enhancements, features, known issues, and
6+
workflow changes in Simba Athena JDBC Driver 2.0.7, as well as the version
7+
history.
78

89

9-
2.0.2 =======================================================================
10+
2.0.7 ========================================================================
1011

11-
Released 2018-04-06
12+
Released 2019-01-31
1213

13-
Enhancements & New Features
14+
Enhancements & New Features
1415

15-
* Improved AWS Glue workflow
16-
17-
AWS Glue availability detection logic now calls an API in Glue to speed
18-
up detection logic. If the API fails, the driver falls back to the
19-
original method.
16+
* [AJ-152] Support for CTAS statements
2017

21-
* Jackson library updated
18+
The driver now provides support for CTAS statements, consistent with the
19+
Athena API. As part of this update, the driver now reports the correct
20+
update count when a CTAS query is executed.
21+
22+
* [AJ-177] Updated Jackson library
23+
24+
The driver has been updated to use Jackson 2.9.8. Previously the driver
25+
used 2.9.5.
26+
27+
* [AJ-167] Support for workgroups
28+
29+
A new configuration option has been added that allows you to specify
30+
a workgroup when authenticating into the data source. To do this, specify
31+
the Workgroup configuration option. For details, see the Installation and
32+
Configuration Guide.
2233

23-
The driver now uses Jackson library version 2.9.5 because of the security
24-
vulnerabilities reported against the earlier versions of the library.
25-
Because Jackson libraries 2.9.5 support Java 1.7 and higher, the JDBC
26-
driver is offered for JDBC API 4.1 and 4.2, but not for JDBC API 4.0,
27-
which requires JDK 6. JDK 6 and Java 1.6 are not supported by Jackson
28-
2.9.5.
2934

30-
* Array type support
31-
32-
The driver now supports returning ResultSet data as an Array. This is
33-
configured using the UseArraySupport configuration option. For more
34-
information, see the Installation and Configuration Guide.
35-
36-
3735
Resolved Issues
38-
The following issue has been resolved in Simba Athena JDBC Driver 2.0.2.
36+
The following issue has been resolved in Simba Athena JDBC Driver 2.0.7.
3937

40-
* When the driver executes a query containing comments, it incorrectly
41-
returns a row-count result set.
38+
* [AJ-165] In some cases, the driver may display the following message
39+
when retrieving large result sets using the streaming API:
40+
"[Simba][AthenaJDBC](100121) An error has occurred."
41+
42+
This issue has been resolved. The driver now supports retries for
43+
retrieving failed blocks when using the streaming API. To configure
44+
the number of retries, use the new MaxStreamErrorRetry configuration
45+
option. For more information, see the Installation and Configuration Guide.
4246

4347

44-
Workflow Changes ============================================================
48+
Workflow Changes =============================================================
4549

4650
The following changes may disrupt workflows from earlier versions.
4751

4852

49-
2.0.2 -----------------------------------------------------------------------
53+
2.0.2 ------------------------------------------------------------------------
5054

5155
* Removed support for JDBC 4.0
5256

5357
As of this release, the driver no longer supports JDBC 4.0. Please refer
5458
to the release notes item "Jackson library updated" in the "Enhancements &
5559
New Features" section of this release for more details.
5660

57-
58-
2.0.0 -----------------------------------------------------------------------
61+
62+
2.0.0 ------------------------------------------------------------------------
5963

6064
* SDK interfaces
6165

6266
The following AWS SDK interfaces are no longer shaded in the driver jar,
6367
they are included with the original AWS SDK package names. Any custom
6468
credential providers that use the old shaded package names for these
65-
interfaces must be updated.
69+
interfaces must be updated.
6670
- com.amazonaws.auth.AWSCredentials
6771
- com.amazonaws.auth.AWSCredentialsProvider
6872
- com.amazonaws.auth.AWSSessionCredentials
69-
- com.amazonaws.auth.AWSSessionCredentialsProvider
73+
- com.amazonaws.auth.AWSSessionCredentialsProvider
74+
75+
76+
Version History ==============================================================
77+
78+
2.0.6 ------------------------------------------------------------------------
79+
80+
Released 2018-11-07
81+
82+
Enhancements & New Features
83+
84+
* [AJ-124] SAML authentication using AD FS
85+
86+
The driver now supports SAML authentication, and can retrieve and use
87+
credentials from an AD FS (Active Directory Federation Services) credential
88+
provider. Additionally, to support authentication workflows where the
89+
retrieved credentials must be exchanged for more specialized AWS
90+
credentials, the driver provides a post-SAML workflow hook. For more
91+
information, see the Installation and Configuration Guide.
92+
93+
* [AJ-162] Optimized and configurable polling intervals for query results
94+
95+
When a query is being executed, the driver now polls the Athena server for
96+
the query results at an exponentially changing rate. The driver begins
97+
polling 5ms after query execution begins, and exponentially increases the
98+
polling interval to the amount of time indicated by the
99+
MaxQueryExecutionPollingInterval property setting. This change in polling
100+
behavior reduces the load on the server.
101+
102+
Additionally, you can now specify the maximum polling interval. To do this,
103+
set the MaxQueryExecutionPollingInterval property to the maximum number of
104+
milliseconds that you want the driver to wait between polling attempts. For
105+
more information, see the Installation and Configuration Guide.
106+
107+
* [AJ-164] Improved logging for query timeout errors
108+
109+
If a query times out, the driver now logs and reports the query ID in the
110+
error message that is returned.
111+
112+
113+
Resolved Issues
114+
The following issues were resolved in Simba Athena JDBC Driver 2.0.6.
115+
116+
* [AJ-156][AJ-157] In some cases, when attempting to execute a long query
117+
statement, the driver fails to execute the query and returns a
118+
StackOverflowError message.
119+
120+
This issue has been resolved. Before, this issue occurred due to a
121+
limitation in the regex library.
122+
123+
124+
2.0.5 ------------------------------------------------------------------------
125+
126+
Released 2018-08-15
127+
128+
Resolved Issues
129+
The following issue was resolved in Simba Athena JDBC Driver 2.0.5.
130+
131+
* [AJ-145] The cursor for result set streaming can become blocked, causing
132+
the application to stop responding, when the application attempts to move
133+
the cursor two or more rows beyond the actual table size.
134+
70135

136+
2.0.4 ------------------------------------------------------------------------
71137

72-
Version History =============================================================
138+
Released 2018-07-10
73139

74-
2.0.1 -----------------------------------------------------------------------
140+
Enhancements & New Features
75141

76-
2018-03-14
142+
* [AJ-121] Support for resultset streaming API
77143

78-
Enhancements & New Features
144+
The driver now supports the AWS resultset streaming API. This can be
145+
toggled on or off with the UseResultsetStreaming configuration option.
146+
See the Installation and Configuration Guide for details.
147+
148+
149+
2.0.3 ------------------------------------------------------------------------
150+
151+
Released 2018-06-15
152+
153+
Resolved Issues
154+
The following issues were resolved in Simba Athena JDBC Driver 2.0.3.
155+
156+
* [AJ-129] When returning the results of a DatabaseMetadata.getColumns() API
157+
call, the driver does not return partition column names.
158+
159+
* [AJ-136] The driver does not return the VIRTUAL_VIEW table type when
160+
getTableTypes() is called, and as a result some applications cannot query
161+
tables of this type.
162+
163+
164+
2.0.2 ------------------------------------------------------------------------
165+
166+
Released 2018-04-06
167+
168+
Enhancements & New Features
169+
170+
* Improved AWS Glue workflow
171+
172+
AWS Glue availability detection logic now calls an API in Glue to speed
173+
up detection logic. If the API fails, the driver falls back to the
174+
original method.
175+
176+
* Jackson library updated
177+
178+
The driver now uses Jackson library version 2.9.5 because of the security
179+
vulnerabilities reported against the earlier versions of the library.
180+
Because Jackson libraries 2.9.5 support Java 1.7 and higher, the JDBC
181+
driver is offered for JDBC API 4.1 and 4.2, but not for JDBC API 4.0,
182+
which requires JDK 6. JDK 6 and Java 1.6 are not supported by Jackson
183+
2.9.5.
184+
185+
* Array type support
186+
187+
The driver now supports returning ResultSet data as an Array. This is
188+
configured using the UseArraySupport configuration option. For more
189+
information, see the Installation and Configuration Guide.
190+
191+
192+
Resolved Issues
193+
The following issue has been resolved in Simba Athena JDBC Driver 2.0.2.
194+
195+
* When the driver executes a query containing comments, it incorrectly
196+
returns a row-count result set.
197+
198+
199+
2.0.1 ------------------------------------------------------------------------
200+
201+
Released 2018-03-14
202+
203+
Enhancements & New Features
79204

80205
* Support for CHAR and FLOAT data types
81206

@@ -85,18 +210,18 @@ Enhancements & New Features
85210
Resolved Issues
86211
The following issues were resolved in Simba Athena JDBC Driver 2.0.1.
87212

88-
* When the driver executes a query containing Common Table Expression (CTE)
213+
* When the driver executes a query containing Common Table Expression (CTE)
89214
syntax, it incorrectly returns a row-count result set.
90215

91-
* In the connection URL, if the Host or Catalog properties end with a
216+
* In the connection URL, if the Host or Catalog properties end with a
92217
backslash ( / ), the driver returns an error.
93-
94218

95-
2.0.0 -----------------------------------------------------------------------
96219

97-
2018-02-02
220+
2.0.0 ------------------------------------------------------------------------
221+
222+
Released 2018-02-02
98223

99-
Enhancements & New Features
224+
Enhancements & New Features
100225

101226
* AWS STS library
102227

@@ -105,16 +230,18 @@ Enhancements & New Features
105230
* Configuration option aliases
106231

107232
Aliases have been added for some configuration options. Recognized options
108-
include:
233+
include:
109234

110235
- s3_staging_dir: alias for S3OutputLocation
111236
- query_results_encryption_option: alias for S3OutputEncOption
112237
- query_results_aws_kms_key: alias for S3OutputEncKMSKey
113238
- aws_credentials_provider_class: alias for AwsCredentialsProviderClass
114239
- aws_credentials_provider_arguments: alias for AwsCredentialsProviderArguments
115240
- max_error_retries: alias for MaxErrorRetry
116-
- connection_timeout (time in milliseconds): alias for ConnectTimeout (time in seconds)
117-
- socket_timeout (time in milliseconds): alias for SocketTimeout (time in seconds)
241+
- connection_timeout (time in milliseconds): alias for ConnectTimeout (time
242+
in seconds)
243+
- socket_timeout (time in milliseconds): alias for SocketTimeout (time in
244+
seconds)
118245

119246
If a conflict occurs, the driver setting takes precedence over the alias.
120247
See the Installation and Configuration Guide for full details.
@@ -127,15 +254,15 @@ Enhancements & New Features
127254

128255
* Updated driver identification details
129256

130-
The DatabaseMetadata.getDatabaseProductName() call now returns
257+
The DatabaseMetadata.getDatabaseProductName() call now returns
131258
"AWS.Athena".
132259
The DatabaseMetadata.getDriverName() now returns "Simba Athena JDBC
133-
Driver".
260+
Driver".
134261
The driver now populates UserAgentPrefix within the Athena SDK. The prefix
135262
is "sbAthenaJDBCDriver/DRIVER_VERSION", where DRIVER_VERSION is the
136263
major.minor version of the driver. For example, this release of the driver
137264
would use the UserAgentPrefix "sbAthenaJDBCDriver/2.0".
138-
265+
139266
* Endpoint handling
140267

141268
You can now pass an endpoint in the form "athena.[REGION].amazonaws.com:
@@ -153,23 +280,24 @@ Enhancements & New Features
153280
Glue.
154281

155282
* AWS SDK support
156-
283+
157284
The driver now uses AWS SDK version 1.11.271.
158285

159286
* Jackson support
160-
287+
161288
The driver now uses Jackson version 2.9.4. The JDBC 4 version of the driver
162289
still uses jackson-databind-2.7.9.1 as newer versions are not compatible
163290
with JDK 1.6.
164-
291+
292+
165293
Resolved Issues
166294
The following issue was resolved in Simba Athena JDBC Driver 2.0.0.
167295

168296
* The precision and scale for integer type columns in the ResultSetMetaData
169297
of the getColumns JDBC API call are both 1.
170298

171-
This has been resolved. The correct values, 10 and 0 respectively, have
299+
This has been resolved. The correct values, 10 and 0 respectively, have
172300
been implemented.
173301

174302

175-
==============================================================================
303+
==============================================================================

0 commit comments

Comments
 (0)