org.apache.hadoop.hive.serde2.json

Enum HiveJsonReader.Feature

java.lang.Object

java.lang.Enum<HiveJsonReader.Feature>

org.apache.hadoop.hive.serde2.json.HiveJsonReader.Feature

All Implemented Interfaces:

Serializable, Comparable<HiveJsonReader.Feature>

Enclosing class:

HiveJsonReader

public static enum HiveJsonReader.Feature
extends Enum<HiveJsonReader.Feature>

Enumeration that defines all on/off features for this reader.

• COL_INDEX_PARSING
• PRIMITIVE_TO_WRITABLE
• IGNORE_UNKNOWN_FIELDS

Enum Constant Summary

Enum Constants

Enum Constant and Description
COL_INDEX_PARSING Enables an optimization to look up each JSON field based on its index in the Hive schema.
IGNORE_UNKNOWN_FIELDS If the JSON object being parsed includes a field that is not included in the Hive schema, enabling this feature will cause the JSON reader to produce a log warnings.
PRIMITIVE_TO_WRITABLE If this feature is enabled, when a JSON node is parsed, its value will be returned as a Hadoop Writable object.
STRINGIFY_COMPLEX_FIELDS If the JSON object being parsed includes a complex field with non defined Hive schema, enabling this feature will cause the JSON reader to treat the field as a String.

Method Summary

Modifier and Type	Method and Description
static HiveJsonReader.Feature	valueOf(String name) Returns the enum constant of this type with the specified name.
static HiveJsonReader.Feature[]	values() Returns an array containing the constants of this enum type, in the order they are declared.

Methods inherited from class java.lang.Enum

clone, compareTo, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Enum Constant Detail

COL_INDEX_PARSING

public static final HiveJsonReader.Feature COL_INDEX_PARSING

Enables an optimization to look up each JSON field based on its index in the Hive schema.

PRIMITIVE_TO_WRITABLE

public static final HiveJsonReader.Feature PRIMITIVE_TO_WRITABLE

If this feature is enabled, when a JSON node is parsed, its value will be returned as a Hadoop Writable object. Otherwise, the Java native value is returned.

IGNORE_UNKNOWN_FIELDS

public static final HiveJsonReader.Feature IGNORE_UNKNOWN_FIELDS

If the JSON object being parsed includes a field that is not included in the Hive schema, enabling this feature will cause the JSON reader to produce a log warnings. If this feature is disabled, an Exception will be thrown and parsing will stop.

STRINGIFY_COMPLEX_FIELDS

public static final HiveJsonReader.Feature STRINGIFY_COMPLEX_FIELDS

If the JSON object being parsed includes a complex field with non defined Hive schema, enabling this feature will cause the JSON reader to treat the field as a String. If the feature is disabled, an Exception will be thrown and parsing will stop.

Method Detail

values

public static HiveJsonReader.Feature[] values()

Returns an array containing the constants of this enum type, in the order they are declared. This method may be used to iterate over the constants as follows:

for (HiveJsonReader.Feature c : HiveJsonReader.Feature.values())
    System.out.println(c);

Returns:

an array containing the constants of this enum type, in the order they are declared

valueOf

public static HiveJsonReader.Feature valueOf(String name)

Returns the enum constant of this type with the specified name. The string must match exactly an identifier used to declare an enum constant in this type. (Extraneous whitespace characters are not permitted.)

Parameters:

name - the name of the enum constant to be returned.

Returns:

the enum constant with the specified name

Throws:

IllegalArgumentException - if this enum type has no constant with the specified name

NullPointerException - if the argument is null