Hadoop3.2.0 Hadoop 文件系统 shell命令指南

小鱼儿 2022-02-19 08:59 395阅读 0赞

*  [appendToFile][]
 *  [cat][]
 *  [checksum][]
 *  [chgrp][]
 *  [chmod][]
 *  [chown][]
 *  [copyFromLocal][]
 *  [copyToLocal][]
 *  [count][]
 *  [cp][]
 *  [createSnapshot][]
 *  [deleteSnapshot][]
 *  [df][]
 *  [du][]
 *  [dus][]
 *  [expunge][]
 *  [find][]
 *  [get][]
 *  [getfacl][]
 *  [getfattr][]
 *  [getmerge][]
 *  [head][]
 *  [help][]
 *  [ls][]
 *  [lsr][]
 *  [mkdir][]
 *  [moveFromLocal][]
 *  [moveToLocal][]
 *  [mv][]
 *  [put][]
 *  [renameSnapshot][]
 *  [rm][]
 *  [rmdir][]
 *  [rmr][]
 *  [setfacl][]
 *  [setfattr][]
 *  [setrep][]
 *  [stat][]
 *  [tail][]
 *  [test][]
 *  [text][]
 *  [touch][]
 *  [touchz][]
 *  [truncate][]
 *  [usage][]
 *  [Deleting objects][]
 *  [Overwriting Objects][]
 *  [Timestamps][]
 *  [Security model and operations][]
 *  [Commands of limited value][]

# 概观 #

文件系统（FS）shell包括各种类似shell的命令，它们直接与Hadoop分布式文件系统（HDFS）以及Hadoop支持的其他文件系统交互，例如Local FS，WebHDFS，S3 FS等。FS shell由以下方式调用：

bin/hadoop fs <args>

所有FS shell命令都将路径URI作为参数。URI格式是 scheme://authority/path 。对于HDFS，scheme 是hdfs，对于本地FS，scheme是file。该scheme和authority是可选的。如果未指定，则使用配置中指定的默认方案。可以将HDFS文件或目录（例如/parent/child）指定为hdfs://namenodehost/parent/child 或简单地指定为/parent/child （假设您的配置设置为指向hdfs//namenodehost）。

FS shell中的大多数命令都表现得像对应的Unix命令。使用每个命令描述差异。错误信息发送到stderr，输出发送到stdout。

如果正在使用HDFS，则hdfs dfs是同义词。

可以使用相对路径。对于HDFS，当前工作目录是HDFS主目录/user/<username>  ，通常必须手动创建。也可以隐式访问HDFS主目录，例如，当使用HDFS垃圾文件夹时，主目录中的.Trash目录。

有关通用shell选项，请参阅[命令手册][Link 1]。

## appendToFile ##

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

将单个src或多个srcs从本地文件系统附加到目标文件系统。还从stdin读取输入并附加到目标文件系统。

*  hadoop fs -appendToFile localfile /user/hadoop/hadoopfile
 *  hadoop fs -appendToFile localfile1 localfile2 /user/hadoop/hadoopfile
 *  hadoop fs -appendToFile localfile hdfs://nn.example.com/hadoop/hadoopfile
 *  hadoop fs -appendToFile - hdfs://nn.example.com/hadoop/hadoopfile Reads the input from stdin.
 *

Exit Code:

Returns 0 on success and 1 on error.

## cat ##

用法：hadoop fs -cat \[-ignoreCrc\] URI \[URI ...\]

将源路径 复制到mstdout。

选项

*  该-ignoreCrc选项禁用checkshum验证。

Example:

*  hadoop fs -cat hdfs://nn1.example.com/file1 hdfs://nn2.example.com/file2
 *  hadoop fs -cat file:///file3 /user/hadoop/file4

Exit Code:

Returns 0 on success and -1 on error.

## checksum ##

用法：hadoop fs -checksum URI

返回文件的校验和信息。

例：

*  hadoop fs -checksum hdfs://nn1.example.com/file1
 *  hadoop fs -checksum file:///etc/hosts

## chgrp ##

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

更改文件的组关联。用户必须是文件的所有者，否则必须是超级用户。其他信息在“ [权限指南”中][Link 2]。

选项

*  \-R   选项将通过目录结构递归地进行更改。

## chmod ##

用法：hadoop fs -chmod \[-R\] <MODE \[，MODE\] ... | OCTALMODE> URI \[URI ...\]

更改文件的权限。使用 -R，通过目录结构递归更改。用户必须是文件的所有者，否则必须是超级用户。其他信息在“ [权限指南”中][Link 2]。

选项

*  \-R 选项将通过目录结构递归地进行更改。

## chown ##

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

更改文件的所有者。用户必须是超级用户。其他信息在“ [权限指南”中][Link 2]。

选项

*  \-R选项将通过目录结构递归地进行更改。

## copyFromLocal ##

用法：hadoop fs -copyFromLocal <localsrc> URI

与fs -put命令类似，但源仅限于本地文件引用。

选项：

*  \-p：保留访问和修改时间，所有权和权限。（假设权限可以跨文件系统传播）
 *  \-f：覆盖目标（如果已存在）。
 *  \-l：允许DataNode延迟将文件持久保存到磁盘，强制复制因子为1.此标志将导致持久性降低。小心使用。
 *  \-d：使用后缀.\_COPYING\_跳过临时文件的创建。

## copyToLocal ##

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

与get命令类似，但目标仅限于本地文件引用。

## count ##

用法： hadoop fs -count \[-q\] \[-h\] \[-v\] \[-x\] \[-t \[<storage type>\]\] \[-u\] \[-e\] <paths>

计算与指定文件模式匹配的路径下的目录，文件和字节数。获取配额和使用情况。-count的输出列为：DIR\_COUNT，FILE\_COUNT，CONTENT\_SIZE，PATHNAME

\-u和-q选项控制输出包含的列。-q表示显示配额，-u限制输出以仅显示配额和使用情况。

\-count -q的输出列为：QUOTA，REMAINING\_QUOTA，SPACE\_QUOTA，REMAINING\_SPACE\_QUOTA，DIR\_COUNT，FILE\_COUNT，CONTENT\_SIZE，PATHNAME

\-count -u的输出列为：QUOTA，REMAINING\_QUOTA，SPACE\_QUOTA，REMAINING\_SPACE\_QUOTA，PATHNAME

\-t选项显示每种存储类型的配额和使用情况。如果未给出-u或-q选项，则忽略-t选项。可以在-t选项中使用的可能参数列表（除参数“”之外不区分大小写）：“”，“all”，“ram\_disk”，“ssd”，“disk”或“archive”。

\-h选项以人类可读格式显示大小。

\-v选项显示标题行。

\-x选项从结果计算中排除快照。如果没有-x选项（默认），则始终从所有INode计算结果，包括给定路径下的所有快照。如果给出-u或-q选项，则忽略-x选项。

\-e选项显示每个文件的擦除编码策略。

\-count -e的输出列为：DIR\_COUNT，FILE\_COUNT，CONTENT\_SIZE，ERASURECODING\_POLICY，PATHNAME

ERASURECODING\_POLICY是文件策略的名称。如果在该文件上设置了擦除编码策略，则它将返回策略的名称。如果未设置擦除编码策略，则将返回“已复制”，这意味着它使用复制存储策略。

Example:

*  hadoop fs -count hdfs://nn1.example.com/file1 hdfs://nn2.example.com/file2
 *  hadoop fs -count -q hdfs://nn1.example.com/file1
 *  hadoop fs -count -q -h hdfs://nn1.example.com/file1
 *  hadoop fs -count -q -h -v hdfs://nn1.example.com/file1
 *  hadoop fs -count -u hdfs://nn1.example.com/file1
 *  hadoop fs -count -u -h hdfs://nn1.example.com/file1
 *  hadoop fs -count -u -h -v hdfs://nn1.example.com/file1
 *  hadoop fs -count -e hdfs://nn1.example.com/file1

Exit Code:

Returns 0 on success and -1 on error.

**cp**

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

将文件从源复制到目标。此命令也允许多个源，在这种情况下，目标必须是目录。

如果（1）源文件系统和目标文件系统支持它们（仅限HDFS），并且（2）所有源和目标路径名都在/.reserved/raw层次结构中，则保留'raw。\*'命名空间扩展属性。是否保留raw。\* namespace xattrs的确定与-p（保留）标志无关。

Options:

*  The -f option will overwrite the destination if it already exists.
 *  The -p option will preserve file attributes \[topx\] (timestamps, ownership, permission, ACL, XAttr). If -p is specified with no *arg*, then preserves timestamps, ownership, permission. If -pa is specified, then preserves permission also because ACL is a super-set of permission. Determination of whether raw namespace extended attributes are preserved is independent of the -p flag.

Example:

*  hadoop fs -cp /user/hadoop/file1 /user/hadoop/file2
 *  hadoop fs -cp /user/hadoop/file1 /user/hadoop/file2 /user/hadoop/dir

Exit Code:

Returns 0 on success and -1 on error.

## createSnapshot ##

请参阅“ [HDFS快照指南”][HDFS]。

## deleteSnapshot ##

请参阅“ [HDFS快照指南”][HDFS]。

## df ##

用法：hadoop fs -df \[-h\] URI \[URI ...\]

显示可用空间。

选项：

*  \-h 选项将以“人类可读” 的方式格式化文件大小（例如64.0m而不是67108864）

例：

*  hadoop dfs -df /user/hadoop/dir1

## du ##

用法：hadoop fs -du \[-s\] \[-h\] \[-v\] \[-x\] URI \[URI ...\]

显示给定目录中包含的文件和目录的大小或文件的长度，以防它只是一个文件。

选项：

*  \-s选项将导致显示文件长度的汇总摘要，而不是单个文件。如果没有-s选项，则通过从给定路径向上移动1级来完成计算。
 *  \-h选项将以“人类可读”的方式格式化文件大小（例如64.0m而不是67108864）
 *  \-v选项将列的名称显示为标题行。
 *  \-x选项将从结果计算中排除快照。如果没有-x选项（默认），则始终从所有INode计算结果，包括给定路径下的所有快照。

du返回三列，格式如下：

size disk_space_consumed_with_all_replicas full_path_name

Example:

*  hadoop fs -du /user/hadoop/dir1 /user/hadoop/file1 hdfs://nn.example.com/user/hadoop/dir1

Exit Code: Returns 0 on success and -1 on error.

## dus ##

用法：hadoop fs -dus <args>

显示文件长度的摘要。

**注意：**不推荐使用此命令。而是使用hadoop fs -du -s。

## expunge ##

用法：hadoop fs -expunge

从trash目录中永久删除早于保留阈值的检查点中的文件，并创建新的检查点。

创建检查点时，垃圾箱中最近删除的文件将移动到检查点下。早于fs.trash.interval的检查点中的文件将在下次调用-expunge命令时被永久删除。

如果文件系统支持该功能，则用户可以配置为通过存储为fs.trash.checkpoint.interval（在core-site.xml中）的参数定期创建和删除检查点。该值应小于或等于fs.trash.interval。

有关[HDFS][HDFS 1]垃圾功能的更多信息，请参阅[HDFS体系结构指南][HDFS 1]。

##  ##

## find ##

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

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

识别以下主要表达式：

*  \-name pattern   
    \-iname pattern
    
        <p><span style="color:#000000;"><span style="color:#000000;">如果文件的基名与使用标准文件系统globbing的模式匹配，则求值为true。如果使用-iname，则匹配不区分大小写。</span></span></p>
        </li>
        <li>
        <p><span style="color:#000000;"><span style="color:#000000;">-print <br>
        -print0</span></span></p>
        
        <p><span style="color:#000000;"><span style="color:#000000;">始终评估为true。使当前路径名写入标准输出。如果使用-print0表达式，则附加ASCII NULL字符。</span></span></p>
        </li>

以下操作得到承认：

*  expression -a expression  
    expression -and expression  
    expression expression
 *  用于连接两个表达式的逻辑AND运算符。如果两个子表达式都返回true，则返回true。由两个表达式的并置所暗示，因此不需要明确指定。如果第一个表达式失败，则不会应用第二个表达式。

例：

hadoop fs -find / -name test -print

Exit Code:

Returns 0 on success and -1 on error.

## get ##

用法：hadoop fs -get \[-ignorecrc\] \[-crc\] \[-p\] \[-f\] <src> <localdst>

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

Example:

*  hadoop fs -get /user/hadoop/file localfile
 *  hadoop fs -get hdfs://nn.example.com/user/hadoop/file localfile

Exit Code:

Returns 0 on success and -1 on error.

选项：

*  \-p：保留访问和修改时间，所有权和权限。（假设权限可以跨文件系统传播）
 *  \-f：覆盖目标（如果已存在）。
 *  \-ignorecrc：对下载的文件进行跳过CRC校验。
 *  \-crc：为下载的文件写入CRC校验和。

## getfacl的说明书 ##

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

显示文件和目录的访问控制列表（ACL）。如果目录具有默认ACL，则getfacl还会显示默认ACL。

选项：

*  \-R：递归列出所有文件和目录的ACL。
 *  *path*：要列出的文件或目录。

Examples:

*  hadoop fs -getfacl /file
 *  hadoop fs -getfacl -R /dir

Exit Code:

Returns 0 on success and non-zero on error.

## getfattr ##

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

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

选项：

*  \-R：递归列出所有文件和目录的属性。
 *  \-n name：转储指定的扩展属性值。
 *  \-d：转储与pathname关联的所有扩展属性值。
 *  \-e *encoding*：检索后*对代码*值进行编码。有效编码为“text”，“hex”和“base64”。编码为文本字符串的值用双引号（“）括起来，编码为十六进制和base64的值分别以0x和0s为前缀。
 *  *path*：文件或目录。

Examples:

*  hadoop fs -getfattr -d /file
 *  hadoop fs -getfattr -R -n user.myAttr /dir

Exit Code:

Returns 0 on success and non-zero on error.

## getmerge ##

用法：hadoop fs -getmerge \[-nl\] <src> <localdst>

将源目录和目标文件作为输入，并将src中的文件连接到目标本地文件。可选地，-nl可以设置为允许在每个文件的末尾添加换行符（LF）。-skip-empty-file可用于在空文件的情况下避免不需要的换行符。

Examples:

*  hadoop fs -getmerge -nl /src /opt/output.txt
 *  hadoop fs -getmerge -nl /src/file1.txt /src/file2.txt /output.txt

Exit Code:

Returns 0 on success and non-zero on error.

## head ##

用法：hadoop fs -head URI

显示文件的第一个千字节到stdout。

Example:

*  hadoop fs -head pathname

Exit Code: Returns 0 on success and -1 on error.

## help ##

用法：hadoop fs -help

返回使用量输出。

## ls ##

用法：hadoop fs -ls \[-C\] \[-d\] \[-h\] \[-q\] \[-R\] \[-t\] \[-S\] \[-r\] \[-u\] \[-e\] <args>

选项：

*  \-C：仅显示文件和目录的路径。
 *  \-d：目录列为纯文件。
 *  \-h：以人类可读的方式格式化文件大小（例如64.0m而不是67108864）。
 *  \-q：打印？而不是不可打印的字符。
 *  \-R：递归列出遇到的子目录。
 *  \-t：按修改时间排序输出（最近的第一个）。
 *  \-S：按文件大小排序输出。
 *  \-r：反转排序顺序。
 *  \-u：使用访问时间而不是修改时间进行显示和排序。
 *  \-e：仅显示文件和目录的擦除编码策略。

对于文件，ls使用以下格式返回文件的stat：

permissions number_of_replicas userid groupid filesize modification_date modification_time filename

对于目录，它返回其直接子节点的列表，如在Unix中。目录列为：

permissions userid groupid modification_date modification_time dirname

默认情况下，目录中的文件按文件名排序。

Example:

*  hadoop fs -ls /user/hadoop/file1
 *  hadoop fs -ls -e /ecdir

Exit Code:

Returns 0 on success and -1 on error.

## lsr ##

用法：hadoop fs -lsr <args>

ls的递归版本。

**注意：**不推荐使用此命令。而是使用hadoop fs -ls -R

##  ##

## mkdir ##

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

将路径uri作为参数并创建目录。

选项：

*  \-p选项行为很像Unix mkdir -p，沿路径创建父目录。

Example:

*  hadoop fs -mkdir /user/hadoop/dir1 /user/hadoop/dir2
 *  hadoop fs -mkdir hdfs://nn1.example.com/user/hadoop/dir hdfs://nn2.example.com/user/hadoop/dir

Exit Code:

Returns 0 on success and -1 on error.

## moveFromLocal ##

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

与put命令类似，只是在复制后删除了源localsrc。

## moveToLocal ##

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

显示“尚未实现”消息。

##  ##

## mv ##

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

将文件从源移动到目标。此命令允许多个源，在这种情况下，目标需要是目录。不允许跨文件系统移动文件。

Example:

*  hadoop fs -mv /user/hadoop/file1 /user/hadoop/file2
 *  hadoop fs -mv hdfs://nn.example.com/file1 hdfs://nn.example.com/file2 hdfs://nn.example.com/file3 hdfs://nn.example.com/dir1

Exit Code:

Returns 0 on success and -1 on error.

## put ##

用法：hadoop fs -put \[-f\] \[-p\] \[-l\] \[-d\] \[ - | <localsrc1> ..\]。<DST>

将单个src或多个srcs从本地文件系统复制到目标文件系统。如果源设置为“ - ”，还从stdin读取输入并写入目标文件系统

如果文件已存在，则复制失败，除非给出-f标志。

选项：

Examples:

*  hadoop fs -put localfile /user/hadoop/hadoopfile
 *  hadoop fs -put -f localfile1 localfile2 /user/hadoop/hadoopdir
 *  hadoop fs -put -d localfile hdfs://nn.example.com/hadoop/hadoopfile
 *  hadoop fs -put - hdfs://nn.example.com/hadoop/hadoopfile Reads the input from stdin.

Exit Code:

Returns 0 on success and -1 on error.

## renameSnapshot ##

请参阅“ [HDFS快照指南”][HDFS]。

##  ##

## rm ##

用法：hadoop fs -rm \[-f\] \[-r | -R\] \[-skipTrash\] \[-safely\] URI \[URI ...\]

删除指定为args的文件。

如果启用了垃圾箱，则文件系统会将已删除的文件移动到垃圾箱目录（由[FileSystem＃getTrashRoot提供][FileSystem_getTrashRoot]）。

目前，默认情况下禁用垃圾箱功能。用户可以通过为参数fs.trash.interval（在core-site.xml中）设置大于零的值来启用垃圾。

请参阅[删除][expunge]有关删除垃圾箱中文件的信息。

选项：

*  如果文件不存在，-f选项将不显示诊断消息或修改退出状态以反映错误。
 *  \-R选项以递归方式删除目录及其下的任何内容。
 *  \-r选项等效于-R。
 *  \-skipTrash选项将绕过垃圾桶（如果已启用），并立即删除指定的文件。当需要从超配额目录中删除文件时，这非常有用。
 *  \-safely选项在删除目录之前需要安全确认，文件总数大于hadoop.shell.delete.limit.num.files（在core-site.xml中，默认值：100）。它可以与-skipTrash一起使用，以防止意外删除大目录。当递归地遍历大目录以计算在确认之前要删除的文件的数量时，预期延迟。

Example:

*  hadoop fs -rm hdfs://nn.example.com/file /user/hadoop/emptydir

Exit Code:

Returns 0 on success and -1 on error.

## 命令rmdir ##

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

删除目录。

选项：

*  \--ignore-fail-on-non-empty：使用通配符时，如果目录仍包含文件，请不要失败。

Example:

*  hadoop fs -rmdir /user/hadoop/emptydir

## rmr ##

用法：hadoop fs -rmr \[-skipTrash\] URI \[URI ...\]

删除的递归版本。

**注意：**不推荐使用此命令。而是使用hadoop fs -rm -r

## setfacl的 ##

用法：hadoop fs -setfacl \[-R\] \[-b | -k -m | -x <acl\_spec> <path>\] | \[ - set <acl\_spec> <path>\]

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

选项：

*  \-b：删除除基本ACL条目之外的所有条目。保留用户，组和其他条目以与权限位兼容。
 *  \-k：删除默认ACL。
 *  \-R：递归地对所有文件和目录应用操作。
 *  \-m：修改ACL。新条目将添加到ACL，并保留现有条目。
 *  \-x：删除指定的ACL条目。保留其他ACL条目。
 *  \--set：完全替换ACL，丢弃所有现有条目。所述*acl\_spec*必须包括用户，组条目和其他用于与权限位兼容性。
 *  *acl\_spec*：以逗号分隔的ACL条目列表。
 *  *path*：要修改的文件或目录。

Examples:

*  hadoop fs -setfacl -m user:hadoop:rw- /file
 *  hadoop fs -setfacl -x user:hadoop /file
 *  hadoop fs -setfacl -b /file
 *  hadoop fs -setfacl -k /dir
 *  hadoop fs -setfacl --set user::rw-,user:hadoop:rw-,group::r--,other::r-- /file
 *  hadoop fs -setfacl -R -m user:hadoop:r-x /dir
 *  hadoop fs -setfacl -m default:user:hadoop:r-x /dir

Exit Code:

Returns 0 on success and non-zero on error.

## setfattr ##

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

设置文件或目录的扩展属性名称和值。

选项：

*  \-n name：扩展属性名称。
 *  \-v value：扩展属性值。该值有三种不同的编码方法。如果参数用双引号括起来，那么值就是引号内的字符串。如果参数的前缀为0x或0X，则将其视为十六进制数。如果参数以0或0S开头，则将其视为base64编码。
 *  \-x name：删除扩展属性。
 *  *path*：文件或目录。

Examples:

*  hadoop fs -setfattr -n user.myAttr -v myValue /file
 *  hadoop fs -setfattr -n user.noValue /file
 *  hadoop fs -setfattr -x user.myAttr /file

Exit Code:

Returns 0 on success and non-zero on error.

## setrep ##

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

更改文件的复制因子。如果*path*是目录，则命令以递归方式更改以*path为*根的目录树下的所有文件的复制因子。执行此命令时将忽略EC文件。

选项：

*  \-w标志请求命令等待复制完成。这可能需要很长时间。
 *  接受-R标志是为了向后兼容。它没有效果。

Example:

*  hadoop fs -setrep -w 3 /user/hadoop/dir1

Exit Code:

Returns 0 on success and -1 on error.

## stat ##

用法：hadoop fs -stat \[格式\] <路径> ...

以指定格式打印有关<path>的文件/目录的统计信息。格式接受八进制（％a）和符号（％A），文件大小（字节）（％b），类型（％F），所有者组名（％g），名称（％n），块大小（％o）的权限），复制（％r），所有者的用户名（％u），访问日期（％x，％X）和修改日期（％y，％Y）。％x和％y将UTC日期显示为“yyyy-MM-dd HH：mm：ss”，％X和％Y显示自1970年1月1日UTC以来的毫秒数。如果未指定格式，则默认使用％y。

Example:

*  hadoop fs -stat "type:%F perm:%a %u:%g size:%b mtime:%y atime:%x name:%n" /file

Exit Code: Returns 0 on success and -1 on error.

## tail ##

用法：hadoop fs -tail \[-f\] URI

显示文件的最后一千字节到stdout。

选项：

*  \-f选项将在文件增长时输出附加数据，如在Unix中一样。

Example:

*  hadoop fs -tail pathname

Exit Code: Returns 0 on success and -1 on error.

## test ##

用法：hadoop fs -test - \[defsz\] URI

选项：

*  \-d：f路径是目录，返回0。
 *  \-e：如果路径存在，则返回0。
 *  \-f：如果路径是文件，则返回0。
 *  \-s：如果路径不为空，则返回0。
 *  \-r：如果路径存在且授予读权限，则返回0。
 *  \-w：如果路径存在且授予写入权限，则返回0。
 *  \-z：如果文件长度为零，则返回0。

例：

*  hadoop fs -test -e filename

## text ##

用法：hadoop fs -text <src>

获取源文件并以文本格式输出文件。允许的格式为zip和TextRecordInputStream。

##  ##

## touch ##

用法：hadoop fs -touch \[-a\] \[-m\] \[-t TIMESTAMP\] \[-c\] URI \[URI ...\]

将URI指定的文件的访问和修改时间更新为当前时间。如果该文件不存在，则在URI处创建零长度文件，其中当前时间作为该URI的时间戳。

*  使用-a选项仅更改访问时间
 *  使用-m选项仅更改修改时间
 *  使用-t选项指定时间戳（格式为yyyyMMddHHmmss）而不是当前时间
 *  如果文件不存在，请使用-c选项不创建文件

时间戳格式如下\* yyyy四位数年份（例如2018年）\* MM一年中的两位数月份（例如8月份的08月份）\* dd月份的两位数日期（例如，每月第一天的01）\* HH一天中的两位数小时使用24小时表示法（例如23表示晚上11点，11表示上午11点）\* mm两位数小时\* ss两位数分钟，例如20180809230000代表2018年8月9日，晚上11点

Example:

*  hadoop fs -touch pathname
 *  hadoop fs -touch -m -t 20180809230000 pathname
 *  hadoop fs -touch -t 20180809230000 pathname
 *  hadoop fs -touch -a pathname

Exit Code: Returns 0 on success and -1 on error.

## touchz ##

用法：hadoop fs -touchz URI \[URI ...\]

创建一个零长度的文件。如果文件存在非零长度，则返回错误。

Example:

*  hadoop fs -touchz pathname

Exit Code: Returns 0 on success and -1 on error.

## truncate ##

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

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

选项：

*  如果需要，-w标志请求命令等待块恢复完成。  
    如果没有-w标志，则在恢复过程中文件可能会保持未闭合一段时间。  
    在此期间，无法重新打开文件以进行追加。

Example:

*  hadoop fs -truncate 55 /user/hadoop/file1 /user/hadoop/file2
 *  hadoop fs -truncate -w 127 hdfs://nn1.example.com/user/hadoop/file1
 *

## usage ##

用法：hadoop fs -usage command

返回单个命令的帮助。

#  #

# 使用对象存储 #

Hadoop FileSystem shell可与Object Stores（如Amazon S3，Azure WASB和OpenStack Swift）配合使用。

# Create a directory
    hadoop fs -mkdir s3a://bucket/datasets/
    
    # Upload a file from the cluster filesystem
    hadoop fs -put /datasets/example.orc s3a://bucket/datasets/
    
    # touch a file
    hadoop fs -touchz wasb://yourcontainer@youraccount.blob.core.windows.net/touched

与普通文件系统不同，重命名对象库中的文件和目录通常需要与被操作对象的大小成比例的时间。由于许多文件系统shell操作使用重命名作为操作的最后阶段，因此跳过该阶段可以避免长时间的延迟。

特别是，put和copyFromLocal命令都应该为直接上载设置-d选项。

# Upload a file from the cluster filesystem
    hadoop fs -put -d /datasets/example.orc s3a://bucket/datasets/
    
    # Upload a file from under the user's home directory in the local filesystem.
    # Note it is the shell expanding the "~", not the hadoop fs command
    hadoop fs -copyFromLocal -d -f ~/datasets/devices.orc s3a://bucket/datasets/
    
    # create a file from stdin
    # the special "-" source means "use stdin"
    echo "hello" | hadoop fs -put -d -f - wasb://yourcontainer@youraccount.blob.core.windows.net/hello.txt

可以下载和查看对象：

# copy a directory to the local filesystem
    hadoop fs -copyToLocal s3a://bucket/datasets/
    
    # copy a file from the object store to the cluster filesystem.
    hadoop fs -get wasb://yourcontainer@youraccount.blob.core.windows.net/hello.txt /examples
    
    # print the object
    hadoop fs -cat wasb://yourcontainer@youraccount.blob.core.windows.net/hello.txt
    
    # print the object, unzipping it if necessary
    hadoop fs -text wasb://yourcontainer@youraccount.blob.core.windows.net/hello.txt
    
    ## download log files into a local file
    hadoop fs -getmerge wasb://yourcontainer@youraccount.blob.core.windows.net/logs\* log.txt

列出许多文件的命令往往比使用HDFS或其他文件系统时要慢得多

hadoop fs -count s3a://bucket/
    hadoop fs -du s3a://bucket/

其他慢速命令包括find，mv，cp和rm。

**Find**

在提供路径下有许多目录的大型商店中，这可能会非常慢。

# enumerate all files in the object store's container.
    hadoop fs -find s3a://bucket/ -print
    
    # remember to escape the wildcards to stop the shell trying to expand them first
    hadoop fs -find s3a://bucket/datasets/ -name \*.txt -print

**Rename**

重命名文件的时间取决于其大小。

重命名目录的时间取决于该目录下所有文件的数量和大小。

hadoop fs -mv s3a://bucket/datasets s3a://bucket/historical

如果操作中断，则对象存储将处于未定义状态。

**Copy**

hadoop fs -cp s3a://bucket/datasets s3a://bucket/historical

复制操作读取每个文件，然后将其写回对象存储区; 完成的时间取决于要复制的数据量，以及本地计算机和对象存储库之间双向带宽。

**计算机离对象存储越远，复制所用的时间越长**

## 删除对象 ##

该RM命令删除对象和目录满对象。如果对象存储*最终*是*一致的*，则fs ls命令和其他访问器可能会暂时返回现在删除的对象的详细信息; 这是对象存储的工件，无法避免。

如果文件系统客户端配置为将文件复制到废纸篓目录，则这将在存储桶中; 然后，rm操作将花费与数据大小成比例的时间。此外，删除的文件将继续产生存储成本。

要避免这种情况，请使用-skipTrash选项。

hadoop fs -rm -skipTrash s3a://bucket/dataset

可以使用expunge命令清除移动到.Trash目录的数据。由于此命令仅适用于默认文件系统，因此必须将其配置为使默认文件系统成为目标对象库。

hadoop fs -expunge -D fs.defaultFS=s3a://bucket/

## 覆盖对象 ##

如果对象存储*最终*是*一致的*，则任何覆盖现有对象的操作可能不会立即对所有客户端/查询可见。即：以后查询相同对象的状态或内容的操作可以获得前一个对象。在读取单个对象时，这有时可以在同一客户端中显示。

避免使用一系列覆盖对象的命令，然后立即处理更新的数据; 存在以下风险：将使用先前的数据。

## Timestamps ##

对象存储中对象和目录的时间戳可能不遵循HDFS中文件和目录的行为。

1.  对象的创建和初始修改时间将是它在对象存储上创建的时间; 这将是写入过程的结束，而不是开始。
2.  时间戳将取自对象存储基础架构的时钟，而不是客户端的时钟。
3.  如果覆盖了对象，则将更新修改时间。
4.  目录可能有也可能没有有效的时间戳。当更新下面的对象时，他们不太可能更新修改时间。
5.  该atime的访问时间特征不被任何在Apache Hadoop的代码库中找到的对象存储的支持。

有关这可能如何影响distcp -update操作的详细信息，请参阅DistCp文档。

## 安全模型和操作 ##

对象存储的安全性和权限模型通常与Unix式文件系统的安全性和权限模型非常不同。查询或操纵权限的操作通常不受支持。

适用的操作包括：chgrp，chmod，chown，getfacl和setfacl。相关属性命令getfattr和setfattr通常也不可用。

*  列出权限和用户/组详细信息的文件系统命令通常模拟这些详细信息。
 *  尝试保留权限的操作（例如fs -put -p）不会因此原因保留权限。（特例：wasb：//，保留权限但不强制执行）。

当与只读对象存储库交互时，“list”和“stat”命令中的权限可以指示用户具有写访问权限，而实际上他们没有。

对象存储通常具有自己的权限模型，模型可以通过特定于商店的工具进行操作。请注意，对象存储可能提供的某些权限（例如只写路径或根路径上的不同权限）可能与Hadoop文件系统客户端不兼容。这些往往需要对它们写入数据的整个对象存储桶/容器进行完全读写访问。

作为如何模拟权限的示例，以下是亚马逊的公共，只读桶Landsat图像的列表：

$ hadoop fs -ls s3a://landsat-pds/
    Found 10 items
    drwxrwxrwx   - mapred          0 2016-09-26 12:16 s3a://landsat-pds/L8
    -rw-rw-rw-   1 mapred      23764 2015-01-28 18:13 s3a://landsat-pds/index.html
    drwxrwxrwx   - mapred          0 2016-09-26 12:16 s3a://landsat-pds/landsat-pds_stats
    -rw-rw-rw-   1 mapred        105 2016-08-19 18:12 s3a://landsat-pds/robots.txt
    -rw-rw-rw-   1 mapred         38 2016-09-26 12:16 s3a://landsat-pds/run_info.json
    drwxrwxrwx   - mapred          0 2016-09-26 12:16 s3a://landsat-pds/runs
    -rw-rw-rw-   1 mapred   27458808 2016-09-26 12:16 s3a://landsat-pds/scene_list.gz
    drwxrwxrwx   - mapred          0 2016-09-26 12:16 s3a://landsat-pds/tarq
    drwxrwxrwx   - mapred          0 2016-09-26 12:16 s3a://landsat-pds/tarq_corrupt
    drwxrwxrwx   - mapred          0 2016-09-26 12:16 s3a://landsat-pds/test

1.  所有文件都列为具有完全读/写权限。
2.  所有目录似乎都具有完整的rwx权限。
3.  所有文件的复制计数为“1”。
4.  所有文件和目录的所有者被声明为当前用户（mapred）。
5.  所有目录的时间戳实际上是-ls操作执行时的时间戳。这是因为这些目录不是商店中的实际对象; 它们是基于路径下对象存在的模拟目录。

当尝试删除其中一个文件时，操作失败 - 尽管ls命令显示的权限：

$ hadoop fs -rm s3a://landsat-pds/scene_list.gz
    rm: s3a://landsat-pds/scene_list.gz: delete on s3a://landsat-pds/scene_list.gz:
      com.amazonaws.services.s3.model.AmazonS3Exception: Access Denied (Service: Amazon S3;
      Status Code: 403; Error Code: AccessDenied; Request ID: 1EF98D5957BCAB3D),
      S3 Extended Request ID: wi3veOXFuFqWBUCJgV3Z+NQVj9gWgZVdXlPU4KBbYMsw/gA+hyhRXcaQ+PogOsDgHh31HlTCebQ=

这表明列出的权限不能作为写访问的证据; 只有对象操作才能确定这一点。

请注意，Microsoft Azure WASB文件系统确实允许设置和检查权限，但实际上并未强制实施权限。此功能提供了使用DistCp备份HDFS目录树的功能，其权限得以保留，权限可在将目录复制回HDFS时恢复。但是，为了保护对对象库中数据的访问，[必须使用][Link 3] Azure [自己的模型和工具][Link 3]。

## 价值有限的命令 ##

以下是通常没有效果的shell命令列表 - 实际上可能会失败。

<table> 
 <thead> 
  <tr> 
   <th>命令</th> 
   <th>限制</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>appendToFile</td> 
   <td>通常不受支持</td> 
  </tr> 
  <tr> 
   <td>checksum</td> 
   <td>通常的校验和是“无”</td> 
  </tr> 
  <tr> 
   <td>chgrp</td> 
   <td>通常不受支持的权限模型;&nbsp;空操作</td> 
  </tr> 
  <tr> 
   <td>chmod</td> 
   <td>通常不受支持的权限模型;&nbsp;空操作</td> 
  </tr> 
  <tr> 
   <td>chown</td> 
   <td>通常不受支持的权限模型;&nbsp;空操作</td> 
  </tr> 
  <tr> 
   <td>createSnapshot</td> 
   <td>通常不受支持</td> 
  </tr> 
  <tr> 
   <td>deleteSnapshot</td> 
   <td>通常不受支持</td> 
  </tr> 
  <tr> 
   <td>df</td> 
   <td>通常会显示默认值</td> 
  </tr> 
  <tr> 
   <td>getfac</td> 
   <td>可能支持也可能不支持</td> 
  </tr> 
  <tr> 
   <td> <p>getfattrl</p> </td> 
   <td>普遍支持</td> 
  </tr> 
  <tr> 
   <td>renameSnapshot</td> 
   <td>通常不受支持</td> 
  </tr> 
  <tr> 
   <td>setfacl</td> 
   <td>通常不受支持的权限模型</td> 
  </tr> 
  <tr> 
   <td>setfattr</td> 
   <td>通常不受支持的权限模型</td> 
  </tr> 
  <tr> 
   <td>setrep</td> 
   <td>没有效果</td> 
  </tr> 
  <tr> 
   <td>truncate</td> 
   <td>通常不受支持</td> 
  </tr> 
 </tbody> 
</table>

不同的对象存储客户端*可能*支持这些命令：请查阅文档并针对目标存储进行测试。

原文链接: [https://hadoop.apache.org/docs/r3.2.0/][https_hadoop.apache.org_docs_r3.2.0]

[appendToFile]: https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-common/FileSystemShell.html#appendToFile
[cat]: https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-common/FileSystemShell.html#cat
[checksum]: https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-common/FileSystemShell.html#checksum
[chgrp]: https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-common/FileSystemShell.html#chgrp
[chmod]: https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-common/FileSystemShell.html#chmod
[chown]: https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-common/FileSystemShell.html#chown
[copyFromLocal]: https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-common/FileSystemShell.html#copyFromLocal
[copyToLocal]: https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-common/FileSystemShell.html#copyToLocal
[count]: https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-common/FileSystemShell.html#count
[cp]: https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-common/FileSystemShell.html#cp
[createSnapshot]: https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-common/FileSystemShell.html#createSnapshot
[deleteSnapshot]: https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-common/FileSystemShell.html#deleteSnapshot
[df]: https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-common/FileSystemShell.html#df
[du]: https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-common/FileSystemShell.html#du
[dus]: https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-common/FileSystemShell.html#dus
[expunge]: https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-common/FileSystemShell.html#expunge
[find]: https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-common/FileSystemShell.html#find
[get]: https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-common/FileSystemShell.html#get
[getfacl]: https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-common/FileSystemShell.html#getfacl
[getfattr]: https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-common/FileSystemShell.html#getfattr
[getmerge]: https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-common/FileSystemShell.html#getmerge
[head]: https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-common/FileSystemShell.html#head
[help]: https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-common/FileSystemShell.html#help
[ls]: https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-common/FileSystemShell.html#ls
[lsr]: https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-common/FileSystemShell.html#lsr
[mkdir]: https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-common/FileSystemShell.html#mkdir
[moveFromLocal]: https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-common/FileSystemShell.html#moveFromLocal
[moveToLocal]: https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-common/FileSystemShell.html#moveToLocal
[mv]: https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-common/FileSystemShell.html#mv
[put]: https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-common/FileSystemShell.html#put
[renameSnapshot]: https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-common/FileSystemShell.html#renameSnapshot
[rm]: https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-common/FileSystemShell.html#rm
[rmdir]: https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-common/FileSystemShell.html#rmdir
[rmr]: https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-common/FileSystemShell.html#rmr
[setfacl]: https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-common/FileSystemShell.html#setfacl
[setfattr]: https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-common/FileSystemShell.html#setfattr
[setrep]: https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-common/FileSystemShell.html#setrep
[stat]: https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-common/FileSystemShell.html#stat
[tail]: https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-common/FileSystemShell.html#tail
[test]: https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-common/FileSystemShell.html#test
[text]: https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-common/FileSystemShell.html#text
[touch]: https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-common/FileSystemShell.html#touch
[touchz]: https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-common/FileSystemShell.html#touchz
[truncate]: https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-common/FileSystemShell.html#truncate
[usage]: https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-common/FileSystemShell.html#usage
[Deleting objects]: https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-common/FileSystemShell.html#Deleting_objects
[Overwriting Objects]: https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-common/FileSystemShell.html#Overwriting_Objects
[Timestamps]: https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-common/FileSystemShell.html#Timestamps
[Security model and operations]: https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-common/FileSystemShell.html#Security_model_and_operations
[Commands of limited value]: https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-common/FileSystemShell.html#Commands_of_limited_value
[Link 1]: https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-common/CommandsManual.html
[Link 2]: https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-hdfs/HdfsPermissionsGuide.html
[HDFS]: https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-hdfs/HdfsSnapshots.html
[HDFS 1]: https://hadoop.apache.org/docs/r3.2.0/hadoop-project-dist/hadoop-hdfs/HdfsDesign.html#File_Deletes_and_Undeletes
[FileSystem_getTrashRoot]: https://hadoop.apache.org/docs/r3.2.0/api/org/apache/hadoop/fs/FileSystem.html
[Link 3]: https://azure.microsoft.com/en-us/documentation/articles/storage-security-guide/
[https_hadoop.apache.org_docs_r3.2.0]: https://hadoop.apache.org/docs/r3.2.0/