Hadoop Commands

 Hadoop Commands

一：介绍

　　调用文件系统(FS)Shell命令应使用 bin/hadoop fs <args>的形式。 所有的的FS shell命令使用URI路径作为参数。URI格式是scheme://authority/path。对HDFS文件系统，scheme是hdfs，对本地文件系统，scheme是file。其中scheme和authority参数都是可选的，如果未加指定，就会使用配置中指定的默认scheme。一个HDFS文件或目录比如/parent/child可以表示成hdfs://namenode:namenodeport/parent/child，或者更简单的/parent/child（假设你配置文件中的默认值是namenode:namenodeport）。大多数FS Shell命令的行为和对应的Unix Shell命令类似，不同之处会在下面介绍各命令使用详情时指出。出错信息会输出到stderr，其他信息输出到stdout。

二：appendToFile

　　附加单个或多个src从本地文件系统到目标文件系统，另外从stdin读取输入并追加到目标文件系统。

　　用法: hadoop fs -appendToFile <localsrc> ... <dst>

三：cat

　　将路径指定文件的内容输出到stdout。

　　用法: hadoop fs -cat URI [URI ...]

四：checksum

　　返回文件的校验信息。

　　用法: hadoop fs -checksum URI

五：chgrp

　　改变文件所属的组。使用-R将使改变在目录结构下递归进行。命令的使用者必须是文件的所有者或者超级用户

　　用法: hadoop fs -chgrp [-R] GROUP URI [URI ...]

六：chmod

　　改变文件的权限。使用-R将使改变在目录结构下递归进行。命令的使用者必须是文件的所有者或者超级用户

　　用法: hadoop fs -chmod [-R] <MODE[,MODE]... | OCTALMODE> URI [URI ...]

七：chown

　　改变文件的拥有者。使用-R将使改变在目录结构下递归进行。命令的使用者必须是超级用户

　　用法：hadoop fs -chown [-R] [OWNER][:[GROUP]] URI [URI ]

八：copyFromLocal

　　除了限定源路径是一个本地文件外，和put命令相似。

　　用法：hadoop fs -copyFromLocal <localsrc> URI

九：copyToLocal

　　除了限定目标路径是一个本地文件外，和get命令类似。

　　用法: hadoop fs -copyToLocal [-ignorecrc] [-crc] URI <localdst>

十：count

　　计算在匹配指定文件模式的路径下的目录、文件和字节数

　　用法: hadoop fs -count [-q] [-h] [-v] <paths>

十一：cp

　　将文件从源路径复制到目标路径。这个命令允许有多个源路径，此时目标路径必须是一个目录。     

　　用法: hadoop fs -cp [-f] [-p | -p[topax]] URI [URI ...] <dest> 

十二：createSnapshot

　　See HDFS Snapshots Guide.

十三：deleteSnapshot

　　See HDFS Snapshots Guide.

十四：df

　　显示free空间。

　　用法: hadoop fs -df [-h] URI [URI ...]

十五：du

　　显示目录中所有文件的大小，或者当只指定一个文件时，显示此文件的大小

　　用法: hadoop fs -dus <args>

十六：expunge

　　清空回收站。请参考HDFS Architecture Guide以获取更多关于回收站特性的信息。

　　用法: hadoop fs -expunge

十七：find

　　查找与指定表达式匹配的所有文件，并将选定的操作应用于它们。如果没有指定路径，则默认为当前工作目录。如果没有指定表达式，则默认为打印。

　　用法: hadoop fs -find <path> ... <expression> ...

十八：get

　　复制文件到本地文件系统。可用-ignorecrc选项复制CRC校验失败的文件。使用-crc选项复制文件以及CRC信息。

　　用法: hadoop fs -getfacl [-R] <path>

十九：getfacl

　　显示访问控制列表（ACL）的文件和目录。如果一个目录中有一个默认的ACL，然后getfacl也显示默认的ACL。

　　用法: hadoop fs -getfacl [-R] <path>

二十：getfattr

　　显示文件或目录的扩展属性名和值（如果有的话）

　　用法: hadoop fs -getfattr [-R] -n name | -d [-e en] <path>

二十一：getmerge

　　接受一个源目录和一个目标文件作为输入，并且将源目录中所有的文件连接成本地目标文件。addnl是可选的，用于指定在每个文件结尾添加一个换行符。

　　用法: hadoop fs -getmerge <src> <localdst> [addnl]

二十二：help

　　返回使用输出

　　用法: hadoop fs -help

二十三：ls

　　如果是文件，则按照如下格式返回文件信息：
　　文件名 <副本数> 文件大小 修改日期 修改时间 权限 用户ID 组ID 
　　如果是目录，则返回它直接子文件的一个列表，就像在Unix中一样。目录返回列表的信息如下：
　　目录名 <dir> 修改日期 修改时间 权限 用户ID 组ID

　　用法: hadoop fs -ls [-d] [-h] [-R] [-t] [-S] [-r] [-u] <args>

二十四：lsr

　　ls命令的递归版本。类似于Unix中的ls -R。

　　用法: hadoop fs -lsr <args>

二十五：mkdir

　　接受路径指定的uri作为参数，创建这些目录。其行为类似于Unix的mkdir -p，它会创建路径中的各级父目录。

　　用法: hadoop fs -mkdir [-p] <paths>

二十六：moveFromLocal

　　类似put的用法，在copy后除了source localsrc都删除。

　　用法: hadoop fs -moveFromLocal <localsrc> <dst>

二十七：moveToLocal

　　输出一个”not implemented“信息。

　　用法: hadoop fs -moveToLocal [-crc] <src> <dst>

二十八：mv

　　将文件从源路径移动到目标路径。这个命令允许有多个源路径，此时目标路径必须是一个目录。不允许在不同的文件系统间移动文件。     

　　用法: hadoop fs -mv URI [URI ...] <dest>

二十九：put

　　从本地文件系统中复制单个或多个源路径到目标文件系统。也支持从标准输入中读取输入写入目标文件系统。

　　用法: hadoop fs -put <localsrc> ... <dst>

三十：renameSnapshot

　　See HDFS Snapshots Guide.

三十一：rm

　　删除指定的文件。只删除非空目录和文件。请参考rmr命令了解递归删除。

　　用法: hadoop fs -rm [-f] [-r |-R] [-skipTrash] URI [URI ...]

三十二：rmdir

　　删除一个文件夹

　　用法: hadoop fs -rmdir [--ignore-fail-on-non-empty] URI [URI ...]

三十三：rmr

　　delete的递归版本。

　　用法: hadoop fs -rmr [-skipTrash] URI [URI ...]

三十四：setfacl

　　设置访问控制列表（ACL）的文件和目录

　　用法: hadoop fs -setfacl [-R] [-b |-k -m |-x <acl_spec> <path>] |[--set <acl_spec> <path>]

三十五：setfattr

　　设置一个文件或目录的扩展属性名和值

　　用法: hadoop fs -setfattr -n name [-v value] | -x name <path>

三十六：setrep

　　改变一个文件的副本系数。-R选项用于递归改变目录下所有文件的副本系数。

　　用法: hadoop fs -setrep [-R] [-w] <numReplicas> <path>

三十七： stat

　　返回指定路径的统计信息。

　　用法: hadoop fs -stat [format] <path> ...

三十八：tail

　　将文件尾部1K字节的内容输出到stdout。支持-f选项，行为和Unix中一致。

　　用法: hadoop fs -tail [-f] URI

三十九：test

　　选项：
　　　　-e 检查文件是否存在。如果存在则返回0。
　　　　-z 检查文件是否是0字节。如果是则返回0。 
　　　　-d 如果路径是个目录，则返回1，否则返回0。

　　用法: hadoop fs -test -[defsz] URI

四十：text

　　将源文件输出为文本格式。允许的格式是zip和TextRecordInputStream。

　　用法: hadoop fs -text <src>

四十一：touchz

　　创建一个0字节的空文件。

　　用法: hadoop fs -touchz URI [URI ...]

四十二：truncate

　　截断指定文件模式指定的长度匹配的所有文件。

　　用法: hadoop fs -truncate [-w] <length> <paths>

四十三：usage

　　返回单个命令的帮助。

　　用法: hadoop fs -usage command