logstash-input-jdbc 4.3.16 → 4.3.17

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 05a9c38896f4f81325e5284a4cd46085105ecc31d5339526a67a42ff668d8c41
-  data.tar.gz: b8d46982d68047d258d0587f66e53cc324c419e8a97952b75db717894e453c24
+  metadata.gz: fa9af10e83d8b696b96da4524bc03bcce28f6b2286f1f18f38e674c562cb2994
+  data.tar.gz: b824a04d01e52bd569cf34f14b2a77d8fb850bb05e3ae91f02a0823cc9e2be56
 SHA512:
-  metadata.gz: b6ab529a8eac82086d7518a1cb282189c1ad96faf138637ab168889030f09c65a6159bfc0e79eaf8c2fff8806b0e71bec46dba15ba81fe08151ac3173953202b
-  data.tar.gz: e0071180f548ceac30f79b18e28b3804c29e559c873bf4a9d45bb11b61736f7a583fbc5a9e53b11d46ed58c3e3686e50de218db89535e231ba5a631cb0b3a941
+  metadata.gz: 23bb34de4f7c363bac00b01899bf3cf40560e80c4b2456115bc3d27682a5e89a573b274be44daf9664a9b9c9558bc33a4ea23125d505d24cf275f60a241a4e60
+  data.tar.gz: 905bdf60952acfcae39f639b5d1183aa25359af3ffe4869a80dcacff6510301a316764d30eca8317f4face5e02d1e96ee3638040d2583defd40d7be6b3322c0d

data/CHANGELOG.md

@@ -1,3 +1,6 @@
+## 4.3.17
+  - Added documentation to provide more info about jdbc driver loading [#352](https://github.com/logstash-plugins/logstash-input-jdbc/pull/352)
+
 ## 4.3.16
   - Add support for prepared statements [Issue 233](https://github.com/logstash-plugins/logstash-input-jdbc/issues/233)
 

data/docs/index.asciidoc

@@ -33,6 +33,9 @@ This plugin does not come packaged with JDBC driver libraries. The desired
 jdbc driver library must be explicitly passed in to the plugin using the
 `jdbc_driver_library` configuration option.
 
+See the <<plugins-{type}s-{plugin}-jdbc_driver_library>> and <<plugins-{type}s-{plugin}-jdbc_driver_class>>
+options for more info.
+
 ==== Scheduling
 
 Input from this plugin can be scheduled to run periodically according to a specific
@@ -317,8 +320,12 @@ database timezone is UTC then you do not need to set either of these settings.
   * There is no default value for this setting.
 
 JDBC driver class to load, for example, "org.apache.derby.jdbc.ClientDriver"
-NB per https://github.com/logstash-plugins/logstash-input-jdbc/issues/43 if you are using
-the Oracle JDBC driver (ojdbc6.jar) the correct `jdbc_driver_class` is `"Java::oracle.jdbc.driver.OracleDriver"`
+
+NOTE: Per https://github.com/logstash-plugins/logstash-input-jdbc/issues/43, prepending `Java::` to the driver class
+ may be required if it appears that the driver is not being loaded correctly despite relevant jar(s) being provided by
+ either via the `jdbc_driver_library` setting or being placed in the Logstash  Java classpath. This is known to be the
+ case for the Oracle JDBC driver (ojdbc6.jar), where the correct `jdbc_driver_class` is
+ `"Java::oracle.jdbc.driver.OracleDriver"`, and may also be the case for other JDBC drivers.
 
 [id="plugins-{type}s-{plugin}-jdbc_driver_library"]
 ===== `jdbc_driver_library`
@@ -326,14 +333,12 @@ the Oracle JDBC driver (ojdbc6.jar) the correct `jdbc_driver_class` is `"Java::o
   * Value type is <<string,string>>
   * There is no default value for this setting.
 
-Tentative of abstracting JDBC logic to a mixin
-for potential reuse in other plugins (input/output)
-This method is called when someone includes this module
-Add these methods to the 'base' given.
 JDBC driver library path to third party driver library. In case of multiple libraries being
 required you can pass them separated by a comma.
 
-If not provided, Plugin will look for the driver class in the Logstash Java classpath.
+NOTE: If not provided, Plugin will look for the driver class in the Logstash Java classpath. Additionally, if the library
+ does not appear to be being loaded correctly via this setting, placing the relevant jar(s) in the Logstash Java
+ classpath rather than via this setting may help.
 
 [id="plugins-{type}s-{plugin}-jdbc_fetch_size"]
 ===== `jdbc_fetch_size`

data/logstash-input-jdbc.gemspec

@@ -1,6 +1,6 @@
 Gem::Specification.new do |s|
   s.name = 'logstash-input-jdbc'
-  s.version         = '4.3.16'
+  s.version         = '4.3.17'
   s.licenses = ['Apache License (2.0)']
   s.summary = "Creates events from JDBC data"
   s.description     = "This gem is a Logstash plugin required to be installed on top of the Logstash core pipeline using $LS_HOME/bin/logstash-plugin install gemname. This gem is not a stand-alone program"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: logstash-input-jdbc
 version: !ruby/object:Gem::Version
-  version: 4.3.16
+  version: 4.3.17
 platform: ruby
 authors:
 - Elastic
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2019-09-09 00:00:00.000000000 Z
+date: 2019-10-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   requirement: !ruby/object:Gem::Requirement