Skip to content

Commit eac54ba

Browse files
committed
Doc changes
Add additional troubleshooting section for jdbc driver loading, and remove confusing language about mixins.
1 parent c7c91c4 commit eac54ba

File tree

1 file changed

+9
-7
lines changed

1 file changed

+9
-7
lines changed

docs/index.asciidoc

Lines changed: 9 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -317,23 +317,25 @@ database timezone is UTC then you do not need to set either of these settings.
317317
* There is no default value for this setting.
318318

319319
JDBC driver class to load, for example, "org.apache.derby.jdbc.ClientDriver"
320-
NB per https://github.com/logstash-plugins/logstash-input-jdbc/issues/43 if you are using
321-
the Oracle JDBC driver (ojdbc6.jar) the correct `jdbc_driver_class` is `"Java::oracle.jdbc.driver.OracleDriver"`
320+
321+
NOTE: Per https://github.com/logstash-plugins/logstash-input-jdbc/issues/43, prepending `Java::` to the driver class
322+
may be required if it appears that the driver is not being loaded correctly despite relevant jar(s) being provided by
323+
either via the `jdbc_driver_library` setting or being placed in the Logstash Java classpath. This is known to be the
324+
case for the Oracle JDBC driver (ojdbc6.jar), where the correct `jdbc_driver_class` is
325+
`"Java::oracle.jdbc.driver.OracleDriver"`, and may also be the case for other JDBC drivers.
322326

323327
[id="plugins-{type}s-{plugin}-jdbc_driver_library"]
324328
===== `jdbc_driver_library`
325329

326330
* Value type is <<string,string>>
327331
* There is no default value for this setting.
328332

329-
Tentative of abstracting JDBC logic to a mixin
330-
for potential reuse in other plugins (input/output)
331-
This method is called when someone includes this module
332-
Add these methods to the 'base' given.
333333
JDBC driver library path to third party driver library. In case of multiple libraries being
334334
required you can pass them separated by a comma.
335335

336-
If not provided, Plugin will look for the driver class in the Logstash Java classpath.
336+
NOTE: If not provided, Plugin will look for the driver class in the Logstash Java classpath. Additionally, if the library
337+
does not appear to be being loaded correctly via this setting, placing the relevant jar(s) in the Logstash Java
338+
classpath rather than via this setting may help.
337339

338340
[id="plugins-{type}s-{plugin}-jdbc_fetch_size"]
339341
===== `jdbc_fetch_size`

0 commit comments

Comments
 (0)