com.aliyun.odps.io

Interface WritableRecord

public interface WritableRecord

WritableRecord 表示 ODPS 表或分区的一条记录，一条记录由多列组成，列包括列名、类型和值.

• 不包括分区列（Partition columns）
• Writable 用于表示列的取值

Record支持通过列的序号（0起始）或列名操作记录的数据。

Writable 子类和列类型的对应关系如下：

• LongWritable - bigint
• DoubleWritable - double
• Text - string
• BooleanWritable - boolean
• DatetimeWritable - datetime
• NullWritable 或 null - NULL 值

Field Summary

Fields

Modifier and Type	Field and Description
static char	DELIM #toDelimitedString()和#fromDelimitedString(String) 使用的默认列分隔符：CTRL + A
static String	NULLINDICATOR #toDelimitedString()和#fromDelimitedString(String) 使用的默认NULL指示符: \N

Method Summary

Modifier and Type	Method and Description
WritableRecord	clone() 生成当前WritableRecord的拷贝。
Writable	get(int index) 获取某列取值，如果index>=列数，抛ArrayIndexOutOfBoundsException异常
Writable	get(String fieldName) 获取某列取值，如果列名不存在，抛IOException异常
Writable[]	getAll() 获取所有列值，不包括分区列（Partition columns）
Column	getField(int index) 获取列属性.
Column[]	getFields() 获取所有列属性，不包括分区列（Partition columns）
boolean	isNull(int idx) 判断某列是否为NULL值，如果该列为null或NullWritable，则返回true
boolean	isNull(String fieldName) 判断某列是否为NULL值，如果该列为null或NullWritable，则返回true
void	set(int index, Writable value) 设置列取值，如果index>=列数，抛ArrayIndexOutOfBoundsException异常
void	set(String fieldName, Writable value) 设置列取值
void	set(Writable[] values) 设置所有列的取值.
int	size() 返回记录的列数，不包含分区列（Partition columns）

Field Detail

DELIM

static final char DELIM

#toDelimitedString()和#fromDelimitedString(String) 使用的默认列分隔符：CTRL + A

See Also:

Constant Field Values

NULLINDICATOR

static final String NULLINDICATOR

#toDelimitedString()和#fromDelimitedString(String) 使用的默认NULL指示符: \N

See Also:

Constant Field Values

Method Detail

size

int size()

返回记录的列数，不包含分区列（Partition columns）

Returns:

列数

isNull

boolean isNull(int idx)

判断某列是否为NULL值，如果该列为null或NullWritable，则返回true

Parameters:

idx - 列序号，0起始

Returns:

如果该列为null或NullWritable，则返回true，否则false

isNull

boolean isNull(String fieldName)
        throws IOException

判断某列是否为NULL值，如果该列为null或NullWritable，则返回true

Parameters:

fieldName - 列名

Returns:

如果该列为null或NullWritable，则返回true，否则false

Throws:

IOException

get

Writable get(int index)

获取某列取值，如果index>=列数，抛ArrayIndexOutOfBoundsException异常

Parameters:

index - 列序号，0起始

Returns:

列值

get

Writable get(String fieldName)
      throws IOException

获取某列取值，如果列名不存在，抛IOException异常

Parameters:

fieldName - 列名

Returns:

列值

Throws:

IOException - 如果列名不存在，抛异常

set

void set(int index,
         Writable value)

设置列取值，如果index>=列数，抛ArrayIndexOutOfBoundsException异常

Parameters:

index - 列序号，0起始

value - 列值

set

void set(String fieldName,
         Writable value)
  throws IOException

设置列取值

Parameters:

fieldName - 列名

value - 列值

Throws:

IOException - 列名不存在，抛异常

set

void set(Writable[] values)
  throws IOException

设置所有列的取值.

如果values数组大小和列数不一致，抛IOException异常.

Parameters:

values - 所有列的取值

Throws:

IOException - 如果values数组大小和列数不一致，抛异常

getField

Column getField(int index)

获取列属性.

Column包含列名和类型，如果index>=列数，抛 ArrayIndexOutOfBoundsException异常

Parameters:

index - 列序号

Returns:

Column，包含列名和类型

getFields

Column[] getFields()

获取所有列属性，不包括分区列（Partition columns）

Returns:

Column数组

getAll

Writable[] getAll()

获取所有列值，不包括分区列（Partition columns）

Returns:

Writable数组

clone

WritableRecord clone()

生成当前WritableRecord的拷贝。

Returns:

当前writableRecord的拷贝