Avro File Read Service

Avro Schema

Path to the Avro Schema file. If absent, the schema stored with the data will be used.

Conversion Format

Format of the incoming Avro data after conversion. The choices are XML or JSON.

Input Source

Whether the Avro data is in the Input Document or in a File.

Avro Data File

Path to the Avro data file. This is ignored if the Input Source is the Input Document.

Hadoop Configuration

Path to the Hadoop configuration file, normally core-site.xml

Default File System

In some Hadoop environments, this should be specified as the URI of the namenode, for example hdfs://[your namenode].

success

The Avro data was successfully converted to XML.

fail_parse

An iFL expression could not be evaluated.

fail_notfound

A file path was specified but the file does not exist.

fail_operation

The operation could not be completed successfully.

null

The element has an xsi:nil attribute set to true and no contents. For example:

<av:item xsi:nil="true"/>

boolean

The string true or false. For example:

<av:item>true</av:item>

int

A numeric string. For example:

<av:item>123</av:item>

long

A numeric string. For example:

<av:item>123</av:item>

float

A numeric string in a fixed point or scientific notation. For example:

<av:item>12.34</av:item>

double

A numeric string in fixed point or scientific notation. For example:

<av:item>1.23E-12</av:item>

string

The string. For example:

<av:item>abc</av:item>

enum

The symbol string. For example:

<av:item>SPADES</av:item>

bytes

A string of hexadecimal digits, each byte taking exactly two digits. For example:

<av:item>040AFCFF</av:item>

fixed

A fixed-length string of hexadecimal digits, each byte taking exactly two digits. For example:

<av:item>040AFCFF</av:item>

record

Each field becomes an unqualified sub-element with the same name as the field and no XML namespace. For example:

<av:item>
    <name>John Smith</name>
    <address>123 Main Street</address>
    <city>New York</city>
    <state>NY</state>
</av:item>

array

Each item in the array becomes an av:item sub-element. For example:

<av:item>
    <av:item>10</av:item>
    <av:item>42</av:item>
    <av:item>99</av:item>
</av:item>

The actual document is not indented.

map

Each entry in the map becomes an av:entry sub-element with the key attribute set to the key, and the contents set to the entry value. For example:

<av:item>
    <av:entry key="k1">val1</av:entry>
    <av:entry key="k2">val2</av:entry>
    <av:entry key="k3">val3</av:entry>
</av:item>

The actual document is not indented.

union

The element has an xsi:type attribute set to the selected type and its contents is the union value directly as if the union did not exist. For example:

<av:item xsi:type="int">123</av:item>

The xsi:type attribute is omitted If the union has only two possible types, one of which is null. For example:

<av:item>123</av:item>

or else:

<av:item xsi:nil="true"/>

null

null

boolean

The value true or false.

int

The integer value.

For example:

123

long

The long value.

For example:

123

float

The float value in a fixed point or scientific notation.

For example:

12.34

double

The double value in a fixed point or scientific notation.

For example:

1.23E-12

string

The string. For example:

"abc"

enum

The symbol string. For example:

"SPADES"

bytes

A string where every byte is converted to an ISO8859-1 character.

For example:

 "éö"

fixed

A string where every byte is converted to an ISO8859-1 character.

For example:

"éö"

record

A JSON Object.

For example:

{"name":"John Smith",
 "address":"123 Main Street",
 "city":"New York",
 "state":"NY"}

The actual document is not indented.

array

A JSON Array. The item values are converted recursively. For example:

[10,42,99]

The actual document is not indented.

map

A JSON Object. The key becomes the field name. For example:

{"k1":"val1",
 "k2":"val2",
 "k3":"val3"}

The actual document is not indented.

union

A JSON Object with a single field. The field name is the full name of the selected type. The field value is the value of the union. As a special case, a null value in a union is converted directly to null as if the union did not exist. For example:

{"int":123}