Table (ODPS SDK Core 0.17.3 API)

java.lang.Object
- com.aliyun.odps.LazyLoad
- - com.aliyun.odps.Table

```
public class Table
extends LazyLoad
```
Table表示ODPS中的表

方法概要

方法
限定符和类型	方法和说明
`void`	`createPartition(PartitionSpec spec)` 增加分区
`void`	`createPartition(PartitionSpec spec, boolean ifNotExists)` 增加分区
`void`	`createShards(long shardCount)` 在Table上创建Shards
`void`	`createShards(long shardCount, boolean enableHubTable, long hubLifeCycle)` 在HubTable上创建Shards,只能在HubTable上创建Shard,并且当前一个HubTable只能创建一次Shard,否则抛出OdpsException
`void`	`deletePartition(PartitionSpec spec)` 删除指定分区
`void`	`deletePartition(PartitionSpec spec, boolean ifExists)` 删除指定分区
`String`	`getComment()` 获取注释
`Date`	`getCreatedTime()` 获取创建时间
`long`	`getFileNum()` 返回表数据所占的盘古文件数
`String`	`getJsonSchema()`
`Date`	`getLastDataModifiedTime()` 获取数据最后修改时间
`Date`	`getLastMetaModifiedTime()` 获取最后修改时间
`long`	`getLife()` 获取表的生命周期值，单位：天
`String`	`getName()` 获取表名
`String`	`getOwner()` 获取表所属用户
`Partition`	`getPartition(PartitionSpec spec)` 获取指定分区信息
`Iterator<Partition>`	`getPartitionIterator()` 获取分区迭代器
`Iterator<Partition>`	`getPartitionIterator(PartitionSpec spec)` 获取分区迭代器
`List<Partition>`	`getPartitions()` 获取所有分区信息
`long`	`getPhysicalSize()` 查看表所占磁盘的物理大小
`String`	`getProject()` 获取表所属`Project`名称
`TableSchema`	`getSchema()` 获取表结构定义
`Shard`	`getShard()` 返回Shard
`long`	`getSize()` 获取内部存储大小，单位：Byte
`String`	`getViewText()` 获取视图的文本内容
`boolean`	`hasPartition(PartitionSpec spec)` 判断指定分区是否存在
`boolean`	`isArchived()` 查看表是否进行过归档操作
`boolean`	`isVirtualView()` 判断表是否为虚拟视图
`RecordReader`	`read(int limit)` 读取表内的数据
`RecordReader`	`read(PartitionSpec partition, List<String> columns, int limit)` 读取表内的数据读取数据时，最多返回 1W 条记录，若超过，数据将被截断。
`void`	`reload()` 重新加载属性值
`void`	`truncate()` 删除表数据

从类继承的方法 java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 方法详细资料
  - reload
```
public void reload()
            throws OdpsException
```
    从类复制的说明: LazyLoad
    
    重新加载属性值
    
    指定者:
    
    reload 在类中 LazyLoad
    
    抛出:
    
    OdpsException
  - getName
```
public String getName()
```
    获取表名
    
    返回:
    表名称
  - getComment
```
public String getComment()
```
    获取注释
    
    返回:
    表的相关注释信息
  - getOwner
```
public String getOwner()
```
    获取表所属用户
    
    返回:
    所属用户
  - getCreatedTime
```
public Date getCreatedTime()
```
    获取创建时间
    
    返回:
    创建时间
  - getLastMetaModifiedTime
```
public Date getLastMetaModifiedTime()
```
    获取最后修改时间
    
    返回:
    最后修改时间
  - getProject
```
public String getProject()
```
    获取表所属Project名称
    
    返回:
    Project名称
  - isVirtualView
```
public boolean isVirtualView()
```
    判断表是否为虚拟视图
    
    返回:
    如果是虚拟视图返回true, 否则返回false
  - getViewText
```
public String getViewText()
```
    获取视图的文本内容
    
    返回:
    文本内容
  - getLastDataModifiedTime
```
public Date getLastDataModifiedTime()
```
    获取数据最后修改时间
    
    返回:
    最后修改时间
  - getSize
```
public long getSize()
```
    获取内部存储大小，单位：Byte
    
    返回:
    存储大小
  - getLife
```
public long getLife()
```
    获取表的生命周期值，单位：天
    
    返回:
    生命周期值
  - getSchema
```
public TableSchema getSchema()
```
    获取表结构定义
    
    返回:
    表示表结构的TableSchema对象
  - getJsonSchema
```
public String getJsonSchema()
```
  - isArchived
```
public boolean isArchived()
```
    查看表是否进行过归档操作
    
    返回:
    返回true表示进行过archive操作，false表示未进行过
  - getPhysicalSize
```
public long getPhysicalSize()
```
    查看表所占磁盘的物理大小
    
    返回:
    物理大小
  - getFileNum
```
public long getFileNum()
```
    返回表数据所占的盘古文件数
    
    返回:
    文件数
  - getShard
```
public Shard getShard()
```
    返回Shard
    
    返回:
    shard 如果没有shard返回null
  - read
```
public RecordReader read(int limit)
                  throws OdpsException
```
    读取表内的数据
    
    参数:
    limit - 最多读取的记录行数
    
    返回:
    RecordReader对象
    
    抛出:
    
    OdpsException
  - read
```
public RecordReader read(PartitionSpec partition,
                List<String> columns,
                int limit)
                  throws OdpsException
```
    读取表内的数据
    读取数据时，最多返回 1W 条记录，若超过，数据将被截断。
    另外，读取的数据大小不能超过 10MB，否则将抛出异常。
    
    参数:
    partition - 表的分区PartitionSpec。如不指定分区可传入null。
    columns - 所要读取的列名的列表。如果读取全表可传入null
    limit - 最多读取的记录行数。
    
    返回:
    RecordReader对象
    
    抛出:
    
    OdpsException
  - createPartition
```
public void createPartition(PartitionSpec spec)
                     throws OdpsException
```
    增加分区
    
    参数:
    spec - 分区定义 PartitionSpec
    
    抛出:
    
    OdpsException
  - createPartition
```
public void createPartition(PartitionSpec spec,
                   boolean ifNotExists)
                     throws OdpsException
```
    增加分区
    
    参数:
    spec - 分区定义 PartitionSpec
    ifNotExists - 在创建分区时，如果为 false 而存在同名分区，则返回出错；若为 true，则无论是否存在同名分区，即使分区结构与要创建的目标分区结构不一致，均返回成功。已存在的同名分区的元信息不会被改动。
    
    抛出:
    
    OdpsException
  - deletePartition
```
public void deletePartition(PartitionSpec spec)
                     throws OdpsException
```
    删除指定分区
    
    参数:
    spec - 分区定义 PartitionSpec
    
    抛出:
    
    OdpsException
  - deletePartition
```
public void deletePartition(PartitionSpec spec,
                   boolean ifExists)
                     throws OdpsException
```
    删除指定分区
    
    参数:
    spec - 分区定义 PartitionSpec
    ifExists - 如果 false 而分区不存在，则返回异常；若为 true，无论分区是否存在，皆返回成功。
    
    抛出:
    
    OdpsException
  - createShards
```
public void createShards(long shardCount)
                  throws OdpsException
```
    在Table上创建Shards
    
    参数:
    shardCount - 创建Shard的个数
    
    抛出:
    
    OdpsException
  - createShards
```
public void createShards(long shardCount,
                boolean enableHubTable,
                long hubLifeCycle)
                  throws OdpsException
```
    在HubTable上创建Shards,只能在HubTable上创建Shard,并且当前一个HubTable只能创建一次Shard,否则抛出OdpsException
    
    参数:
    shardCount - 创建Shard的个数
    enableHubTable - 是否是HubTable
    hubLifeCycle - Hub表的LifeCycle
    
    抛出:
    
    OdpsException
  - getPartitionIterator
```
public Iterator<Partition> getPartitionIterator()
```
    获取分区迭代器
    
    返回:
    Partiion 分区迭代器
  - getPartitionIterator
```
public Iterator<Partition> getPartitionIterator(PartitionSpec spec)
```
    获取分区迭代器
    
    参数:
    spec - 指定的上级分区 PartitionSpec
    
    返回:
    Partition迭代器
  - getPartitions
```
public List<Partition> getPartitions()
```
    获取所有分区信息
    
    返回:
    Partition列表
  - getPartition
```
public Partition getPartition(PartitionSpec spec)
```
    获取指定分区信息
    
    参数:
    spec - 分区定义 PartitionSpec
    
    返回:
    分区信息 Partition
  - hasPartition
```
public boolean hasPartition(PartitionSpec spec)
                     throws OdpsException
```
    判断指定分区是否存在
    
    参数:
    spec - 分区定义 PartitionSpec
    
    返回:
    如果指定分区存在，则返回true，否则返回false
    
    抛出:
    
    OdpsException
  - truncate
```
public void truncate()
              throws OdpsException
```
    删除表数据
    
    抛出:
    
    OdpsException

类 Table

方法概要

从类继承的方法 java.lang.Object

方法详细资料

reload

getName

getComment

getOwner

getCreatedTime

getLastMetaModifiedTime

getProject

isVirtualView

getViewText

getLastDataModifiedTime

getSize

getLife

getSchema

getJsonSchema

isArchived

getPhysicalSize

getFileNum

getShard

read

read

createPartition

createPartition

deletePartition

deletePartition

createShards

createShards

getPartitionIterator

getPartitionIterator

getPartitions

getPartition

hasPartition

truncate