logstash-filter-jdbc_static 1.0.5 → 1.0.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7977c75c7b90410771251f9b63d48b3c68c0dbddff3ae6c44537bac5cd77a282
-  data.tar.gz: b7f4e3debad655869b27b58636fa8c3ab44a1a5a6391474ba1d5dae7bbec3f0b
+  metadata.gz: d3b81e0c9308bdc5e2ed77ff83285478e1acb576014a87066b9515463556054a
+  data.tar.gz: 9b7712e0be06ba5bf6aba7faea67eb241b70597378b0348dcc75ae114fe6e9ba
 SHA512:
-  metadata.gz: 7896dda38d86cd012a12f8feab8ce7f81d250e443b756c8109c494f7504deb1ff43fa269080b82de7d0293d54954b4380f9fdbe77c08dc4ef94dd86f0aef37bf
-  data.tar.gz: 17f428b6b143674b2dfabdd5fa0490f61713e8527c293a41e205c0f76db6532f14fcc49b0e6fc5d90528a0f1d2f758b74a7895d0d04f03d891780bb7864451a6
+  metadata.gz: 27e86d778e71192f76c2e205907fd2f846aced383f35cd3df85e4ff6b191d66d68c7395c6195668ae003813f5bf020110f5528f9c8274c476984a476655a691c
+  data.tar.gz: '0091f4a6ffa0082ed1b95e287b502fcbf765c14e6f8400c5dc4a9782825d9603a465058f9ac86cb59c75bba0bf601beb1d0f300d397d4825f17fcd9a4761a4cb'

data/CHANGELOG.md

@@ -1,3 +1,6 @@
+## 1.0.6
+ - Added info to documentation to emphasize significance of table order [36](https://github.com/logstash-plugins/logstash-filter-jdbc_static/pull/36)
+
 ## 1.0.5
  - Fixed issue where overly restrictive dependency on rufus scheduler was stopping Logstash from upgrading this plugin. [35](https://github.com/logstash-plugins/logstash-filter-jdbc_static/pull/35)
 

data/docs/index.asciidoc

@@ -54,11 +54,11 @@ database connection.
 *lookups*::
 
 Perform lookup queries on the local database to enrich the events.
-Define as many lookups as needed to enhance the event from all
+Define as many lookups as needed to enrich the event from all
 lookup tables in one pass. Ideally the SQL statement should only
 return one row. Any rows are converted to Hash objects and are
 stored in a target field that is an Array.
-
++
 The following example config fetches data from a remote database, caches it in a
 local database, and uses lookups to enrich events with data cached in the local
 database.
@@ -131,6 +131,8 @@ filter {
 locally.
 <2> Defines the columns, types, and indexes used to build the local database
 structure. The column names and types should match the external database.
+The order of table definitions is significant and should match that of the loader queries.
+See <<plugins-{type}s-{plugin}-object_order>>.
 <3> Performs lookup queries on the local database to enrich the events.
 <4> Specifies the event field that will store the looked-up data. If the lookup
 returns multiple columns, the data is stored as a JSON object within the field.
@@ -246,6 +248,19 @@ However, after setting up the filter, you should watch the lookup results and
 view the logs to verify correct operation.
 ===============================
 
+[id="plugins-{type}s-{plugin}-object_order"]
+==== Loader column and local_db_object order dependency
+
+[IMPORTANT]
+===============================
+For loader performance reasons, the loading mechanism uses a CSV style file with an inbuilt
+Derby file import procedure to add the remote data to the local db. The retrieved columns
+are written to the CSV file as is and the file import procedure expects a 1 to 1 correspondence
+to the order of the columns specified in the local_db_object settings. Please ensure that this
+order is in place.
+===============================
+
+
 [id="plugins-{type}s-{plugin}-options"]
 ==== Jdbc_static Filter Configuration Options
 
@@ -507,7 +522,7 @@ must read the important multiple pipeline notice at the top of the page.
   * Default value is `[]`
 
 The array should contain one or more Hashes. Each Hash represents a lookup
-enhancement. Each Hash is validated according to the table below.
+enrichment. Each Hash is validated according to the table below.
 
 [cols="<,<,<",options="header",]
 |=======================================================================

data/logstash-filter-jdbc_static.gemspec

@@ -1,6 +1,6 @@
 Gem::Specification.new do |s|
   s.name            = 'logstash-filter-jdbc_static'
-  s.version         = '1.0.5'
+  s.version         = '1.0.6'
   s.licenses        = ['Apache-2.0']
   s.summary         = "This filter executes a SQL query to fetch a SQL query result, store it locally then use a second SQL query to update an event."
   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-filter-jdbc_static
 version: !ruby/object:Gem::Version
-  version: 1.0.5
+  version: 1.0.6
 platform: ruby
 authors:
 - Elastic
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2018-06-27 00:00:00.000000000 Z
+date: 2018-10-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   requirement: !ruby/object:Gem::Requirement