本文版权归mephisto和博客园共有,欢迎转载,但须保留此段声明,并给出原文链接,谢谢合作。
文章是哥(mephisto)写的,SourceLink
上一篇,我们从发展历程,架构,MapReduce等方面对比了Hadoop1.x与Hadoop2.x,特别是这这几年,2.x的发展已经可以适合很多的应用场景了。前面我们通过Eclipse插件来进行文件的上传,删除等,下面我们熟悉下Hadoop命令,从而更能直接,强力的对Hadoop进行操作。
下面,我们就开始对Hadoop命令进行粗略的解析。本文有些地方是自己翻译的,翻译的不好望见谅。本章节内容较多,还是分为上下两部分。
所有的hadoop命令均由bin/hadoop脚本引发。不指定参数运行hadoop脚本会打印所有命令的描述。
用法:hadoop [--config confdir] [COMMAND] [GENERIC_OPTIONS] [COMMAND_OPTIONS]
Hadoop有一个选项解析框架用于解析一般的选项和运行类。
命令选项 | 描述 |
---|---|
--config confdir | 覆盖缺省配置目录。缺省是${HADOOP_HOME}/conf。 |
--loglevel loglevel | 覆盖日志级别. 有效的日志级别是 FATAL, ERROR, WARN, INFO, DEBUG, and TRACE. 默认是 INFO. |
GENERIC_OPTIONS | 多个命令都支持的通用选项。 |
COMMAND_OPTIONS | 各种各样的命令和它们的选项会在下面提到。 HDFS and YARN 在其他文档有讲解。 |
很多子命令 通过配置选项来改变他们的行为。
GENERIC_OPTION | 描述 |
---|---|
-archives <comma separated list of archives> | 指定要在计算机一个逗号分隔的档案。仅适用于job。 |
-conf <configuration file> | 指定应用程序的配置文件。 |
-D <property>=<value> | 为指定property指定值value。 |
-files <comma separated list of files> | 指定要拷贝到map reduce集群的文件的逗号分隔的列表。 只适用于job。 |
-jt <local> or <resourcemanager:port> | 指定job tracker。只适用于job 。 |
-libjars <comma seperated list of jars> | 指定要包含到classpath中的jar文件的逗号分隔的列表。 只适用于job. |
所有这些命令都是从Hadoop的shell命令执行。他们被分成用户命令和管理命令。
用于Hadoop集群用户命令。
创建一个hadoop档案文件。参考 Hadoop Archives Guide .
用法: hadoop archive -archiveName name -p <parent> [-r <replication factor>] <src>* <dest>
-archiveName 你想创造档案的名字.
-p 制定父路径,制定了后,后面的src dest都是相对路径
src 文件系统的路径名,和通常含正则表达的一样。
dest 保存档案文件的目标目录。
这个命令检查Hadoop本地代码的可用性。 See #NativeLibraries.html for more information. 默认情况下,此命令只检查libhadoop的可用性。
用法: hadoop checknative [-a] [-h]
COMMAND_OPTION | Description |
---|---|
-a | Check all libraries are available. |
-h | print help |
打印Hadoop jar和所需的libs的class路径。
用法: hadoop classpath [--glob |--jar <path> |-h |--help]
COMMAND_OPTION | Description |
---|---|
--glob | expand wildcards |
--jar path | write classpath as manifest in jar named path |
-h , --help | print help |
用于管理 credentials, passwords and secrets
用法: hadoop credential <subcommand> [options]
COMMAND_OPTION | Description |
---|---|
create alias [-provider provider-path ] | Prompts the user for a credential to be stored as the given alias. The hadoop.security.credential.provider.path within the core-site.xml file will be used unless a -provider is indicated. |
delete alias [-provider provider-path ] [-f] | Deletes the credential with the provided alias. The hadoop.security.credential.provider.path within the core-site.xml file will be used unless a -provider is indicated. The command asks for confirmation unless -f is specified |
list [-provider provider-path ] | Lists all of the credential aliases The hadoop.security.credential.provider.path within the core-site.xml file will be used unless a -provider is indicated. |
递归复制文件或目录. More information can be found at Hadoop DistCp Guide.
这个命令在 File System Shell Guide 描述. 在HDFS使用中,hdfs,dfs是相同的。
执行一个jar文件。使用 yarn jar 来运行Yarn app来代替。
使用: hadoop jar <jar> [mainClass] args...
通过KeyProvider来管理keys。
查看和修改Hadoop tracing 设置。 See the Tracing Guide .
打印版本
用法: hadoop version
脚本可用于调调用任何类
用法: hadoop CLASSNAME
用于管理Hadoop cluster
获取/设置在后台Log的级别
用法:hadoop daemonlog -getlevel <host:httpport> <classname>hadoop daemonlog -setlevel <host:httpport> <classname> <level>
例如: $ bin/hadoop daemonlog -setlevel 127.0.0.1:50070 org.apache.hadoop.hdfs.server.namenode.NameNode DEBUG
调用文件系统(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 。
附加单个或多个src从本地文件系统到目标文件系统,另外从stdin读取输入并追加到目标文件系统。
用法: hadoop fs -appendToFile <localsrc> ... <dst>
将路径指定文件的内容输出到 stdout 。
用法: hadoop fs -cat URI [URI ...]
返回文件的校验信息。
用法: hadoop fs -checksum URI
改变文件所属的组。使用 -R将使改变在目录结构下递归进行。命令的使用者必须是文件的所有者或者超级用户
用法: hadoop fs -chgrp [-R] GROUP URI [URI ...]
改变文件的权限。使用 -R将使改变在目录结构下递归进行。命令的使用者必须是文件的所有者或者超级用户
用法: hadoop fs -chmod [-R] <MODE[,MODE]... | OCTALMODE> URI [URI ...]
改变文件的拥有者。使用 -R将使改变在目录结构下递归进行。命令的使用者必须是超级用户
用法: hadoop fs -chown [-R] [OWNER][:[GROUP]] URI [URI ]
除了限定源路径是一个本地文件外,和put命令相似。
用法: hadoop fs -copyFromLocal <localsrc> URI
除了限定目标路径是一个本地文件外,和get命令类似。
用法: hadoop fs -copyToLocal [-ignorecrc] [-crc] URI <localdst>
计算在匹配指定文件模式的路径下的目录、文件和字节数
用法: hadoop fs -count [-q] [-h] [-v] <paths>
将文件从源路径复制到目标路径。这个命令允许有多个源路径,此时目标路径必须是一个目录。
用法: hadoop fs -cp [-f] [-p | -p[topax]] URI [URI ...] <dest>
See HDFS Snapshots Guide .
See HDFS Snapshots Guide .
显示free空间。
用法: hadoop fs -df [-h] URI [URI ...]
显示目录中所有文件的大小,或者当只指定一个文件时,显示此文件的大小
用法: hadoop fs -dus <args>
清空回收站。请参考 HDFS Architecture Guide 以获取更多关于回收站特性的信息。
用法: hadoop fs -expunge
查找与指定表达式匹配的所有文件,并将选定的操作应用于它们。如果没有指定路径,则默认为当前工作目录。如果没有指定表达式,则默认为打印。
用法: hadoop fs -find <path> ... <expression> ...
复制文件到本地文件系统。可用 -ignorecrc选项复制CRC校验失败的文件。使用 -crc选项复制文件以及CRC信息。
用法: hadoop fs -getfacl [-R] <path>
显示访问控制列表(ACL)的文件和目录。如果一个目录中有一个默认的ACL,然后getfacl也显示默认的ACL。
用法: hadoop fs -getfacl [-R] <path>
显示文件或目录的扩展属性名和值(如果有的话)
用法: hadoop fs -getfattr [-R] -n name | -d [-e en] <path>
接受一个源目录和一个目标文件作为输入,并且将源目录中所有的文件连接成本地目标文件。 addnl是可选的,用于指定在每个文件结尾添加一个换行符。
用法: hadoop fs -getmerge <src> <localdst> [addnl]
返回使用输出
用法: hadoop fs -help
如果是文件,则按照如下格式返回文件信息:
文件名 <副本数> 文件大小 修改日期 修改时间 权限 用户ID 组ID
如果是目录,则返回它直接子文件的一个列表,就像在Unix中一样。目录返回列表的信息如下:
目录名 <dir> 修改日期 修改时间 权限 用户ID 组ID
用法: hadoop fs -ls [-d] [-h] [-R] [-t] [-S] [-r] [-u] <args>
ls命令的递归版本。类似于Unix中的 ls -R。
用法: hadoop fs -lsr <args>
接受路径指定的uri作为参数,创建这些目录。其行为类似于Unix的mkdir -p,它会创建路径中的各级父目录。
用法: hadoop fs -mkdir [-p] <paths>
类似put的用法,在copy后除了source localsrc都删除。
用法: hadoop fs -moveFromLocal <localsrc> <dst>
输出一个”not implemented“信息。
用法: hadoop fs -moveToLocal [-crc] <src> <dst>
将文件从源路径移动到目标路径。这个命令允许有多个源路径,此时目标路径必须是一个目录。不允许在不同的文件系统间移动文件。
用法: hadoop fs -mv URI [URI ...] <dest>
从本地文件系统中复制单个或多个源路径到目标文件系统。也支持从标准输入中读取输入写入目标文件系统。
用法: hadoop fs -put <localsrc> ... <dst>
See HDFS Snapshots Guide .
删除指定的文件。只删除非空目录和文件。请参考rmr命令了解递归删除。
用法: hadoop fs -rm [-f] [-r |-R] [-skipTrash] URI [URI ...]
删除一个文件夹
用法: hadoop fs -rmdir [--ignore-fail-on-non-empty] URI [URI ...]
delete的递归版本。
用法: hadoop fs -rmr [-skipTrash] URI [URI ...]
设置访问控制列表(ACL)的文件和目录
用法: hadoop fs -setfacl [-R] [-b |-k -m |-x <acl_spec> <path>] |[--set <acl_spec> <path>]
设置一个文件或目录的扩展属性名和值
用法: hadoop fs -setfattr -n name [-v value] | -x name <path>
改变一个文件的副本系数。-R选项用于递归改变目录下所有文件的副本系数。
用法: hadoop fs -setrep [-R] [-w] <numReplicas> <path>
返回指定路径的统计信息。
用法: hadoop fs -stat [format] <path> ...
将文件尾部1K字节的内容输出到stdout。支持-f选项,行为和Unix中一致。
用法: hadoop fs -tail [-f] URI
选项:
-e 检查文件是否存在。如果存在则返回0。
-z 检查文件是否是0字节。如果是则返回0。
-d 如果路径是个目录,则返回1,否则返回0。
用法: hadoop fs -test -[defsz] URI
将源文件输出为文本格式。允许的格式是zip和TextRecordInputStream。
用法: hadoop fs -text <src>
创建一个0字节的空文件。
用法: hadoop fs -touchz URI [URI ...]
截断指定文件模式指定的长度匹配的所有文件。
用法: hadoop fs -truncate [-w] <length> <paths>
返回单个命令的帮助。
用法: hadoop fs -usage command
--------------------------------------------------------------------
到此,本章节的内容讲述完毕。
Apache hadoop commands: http://hadoop.apache.org/docs/current/hadoop-project-dist/hadoop-common/CommandsManual.html
Apache File System Shell: http://hadoop.apache.org/docs/current/hadoop-project-dist/hadoop-common/FileSystemShell.html
Apache 1.04 中文: http://hadoop.apache.org/docs/r1.0.4/cn/commands_manual.html
【源】从零自学Hadoop系列索引
本文版权归mephisto和博客园共有,欢迎转载,但须保留此段声明,并给出原文链接,谢谢合作。
文章是哥(mephisto)写的,SourceLink