The To UTF-8 Action is used to convert files created in other character sets into UTF-8 format so that they can be processed using standard Hadoop Text Input Formats. Due to MAPREDUCE-232, files created in other charsets must be converted to UTF-8 before being processed. This plugin supports any character set listed under java.nio in the Java Supported Encodings Documentation.

This plugin can be very useful for converting sets of files to UTF-8 prior to processing them in MapReduce or Spark. Because this action runs as a single process prior to the MapReduce or Spark job, it can take a considerable amount of time to convert large files. If that is the case, you may be better off writing a custom Input format for handling that data.

The files are created in the destination folder with .utf8 appended to them. Most likely, you will want to use the HDFSDelete action at the end of the pipeline to clean up these files.

When using the Wrangler tool, you will want to wrangle with the UTF-8 converted file to get the best results.

CDAP version 4.1.x or higher.

You get started with To UTF-8 action plugin by building directly from the latest source code::

git clone [email protected]:hydrator/to-utf8-action.git cd to-utf8-action mvn clean package

After the build completes, you will have a JAR for each plugin under each <plugin-name>/target/ directory.

You can deploy a plugin using the CDAP CLI::

load artifact <target/plugin-jar> config-file <resources/plugin-config>

load artifact target/to-utf8-action-.jar
config-file target/to-utf8-action-.json

You can build without running tests: mvn clean install -DskipTests

CDAP User Group and Development Discussions:

• [email protected] <https://groups.google.com/d/forum/cdap-user>__

The cdap-user mailing list is primarily for users using the product to develop applications or building plugins for appplications. You can expect questions from users, release announcements, and any other discussions that we think will be helpful to the users.

CDAP IRC Channel: #cdap on irc.freenode.net

Copyright © 2017 Cask Data, Inc.

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.

Cask is a trademark of Cask Data, Inc. All rights reserved.

Apache, Apache HBase, and HBase are trademarks of The Apache Software Foundation. Used with permission. No endorsement by The Apache Software Foundation is implied by the use of these marks.