iracheng / elasticsearch-csv

CSV format for Elasticsearch REST search responses

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Elasticsearch CSV plugin

This plugin offers CSV format for REST search responses.

It uses a REST endpoint _search_csv which is equivalent to REST endpoint _search except the result set format.

With the parameter keys you can optionally pass a string array with the field names to include in the rows. Note, because of the JSON structure of documents, you might not always obtain regular tabular data. It is recommended to use keys with field names that appear throughout the result set.

CSV values are escaped with quotes if they contain quotes or commas.

There are also boolean parameters with_index, with_type and with_id to add metadata into the CSV rows.

By using the fields attribute in the search, you can add internal ES fields to the CSV output, like _timestamp or _parent.

Example

curl 0:9200/ezbxml/_search_csv?keys=ezb:zdbid,ezb:license_period.ezb:available,ezb:isil,ezb:sigel,ezb:license_entry_id,ezb:ill_relevance.ezb:ill_code
ezb:isil,ezb:zdbid,ezb:ill_relevance.ezb:ill_code,ezb:sigel,ezb:license_entry_id,ezb:license_period.ezb:available
DE-929,14808092,copy,929,EZB6279175,Nationallizenz
DE-290,14808092,,290,EZB6279178,
DE-464,14808092,copy,464,EZB3137771,Nationallizenz
DE-386,14808092,,386,EZB352248,
DE-467,14808092,copy,467,EZB3137774,Nationallizenz
DE-38M,20284512,copy,38 M,EZB932535,Nationallizenz
DE-467,14808092,,467,EZB6279182,
DE-465,14808092,copy,465,EZB3137777,Nationallizenz
DE-5,14808092,,5,EZB352272,
DE-61,14808092,,61,EZB6279185,

Compatibility matrix

Elasticsearch Plugin Release date
1.7.2 1.7.2.0 Sep 18, 2015
1.7.0 1.7.0.0 Aug 1, 2015
1.6.0 1.6.0.0 Jul 15, 2015
1.5.0 1.5.0.0 Aug 13, 2015
1.4.0 1.4.0.1 Feb 18, 2015
1.3.0 1.3.2.0 Aug 22, 2014
1.2.1 1.2.1.1 Jul 16, 2014

Installation

Example command

./bin/plugin -install csv -url http://xbib.org/repository/org/xbib/elasticsearch/plugin/elasticsearch-csv/1.7.2.0/elasticsearch-csv-1.7.2.0-plugin.zip

Do not forget to restart the node after installing.

Project docs

The Maven project site is available at Github

Issues

All feedback is welcome! If you find issues, please post them at Github

License

Elasticsearch CSV Plugin

Copyright (C) 2014 Jörg Prante

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

About

CSV format for Elasticsearch REST search responses

License:Apache License 2.0


Languages

Language:Java 100.0%