python操作hdfs

hdfs模块时python的一个第三方库,可以允许直接对hadoop的hdfs模块进行访问.

安装

安装hadoop

关于hadoop的安装配置会在另一篇文章中介绍,这里只介绍python的hdfs库的安装.

安装hdfs库

所有python的三方模块均采用pip来安装.

pip install hdfs

hdfs库的使用

下面将介绍hdfs库的方法列表,并会与hadoop自带的命令行工具进行比较

注:hdfs dfs开头是hadoop自带的命令行工具命令

连接hadoop

通过http协议连接hadoop的datanode节点,默认端口50070

from hdfs.client import Client
client = Client("http://127.0.0.1:50070/")

注:为了节省篇幅,下面的所有代码片段默认包含上两行,此外,后续所有的hdfs指代hadoop的hdfs模块,而非python的hdfs库

list()

list()会列出hdfs指定路径的所有文件信息,接收两个参数

• hdfs_path 要列出的hdfs路径
• status 默认为False,是否显示详细信息

print("hdfs中的目录为:", client.list(hdfs_path="/",status=True))

查看hdfs根目录下的文件信息,等同于hdfs dfs -ls /

status()

查看文件或者目录状态,接收两个参数

• hdfs_path 要列出的hdfs路径
• strict 是否开启严格模式,严格模式下目录或文件不存在不会返回None,而是raise

print(client.status(hdfs_path="/b.txt",strict=True))

checksum()

checksum() 计算目录下的文件数量,只有一个参数.

print("根目录下的文件数量为:", client.checksum(hdfs_path="/input.txt"))

parts()

列出路径下的part file,接收三个参数

• hdfs_path 要列出的hdfs路径
• parts 要显示的parts数量 默认全部显示
• status 默认为False,是否显示详细信息

print("", client.parts(hdfs_path="/log", parts=0, status=True))

content()

列出目录或文件详情,接收两个参数

• hdfs_path 要列出的hdfs路径
• strict 是否开启严格模式,严格模式下目录或文件不存在不会返回None,而是raise

print(client.content(hdfs_path="/",strict=True))

makedirs()

创建目录,同hdfs dfs -mkdir与hdfs dfs -chmod的结合体,接收两个参数

• hdfs_path hdfs路径
• permission 文件权限

print("创建目录", client.makedirs(hdfs_path="/t", permission="755"))

rename()

文件或目录重命名,接收两个参数

• hdfs_src_path 原始路径或名称
• hdfs_dst_path 修改后的文件或路径

client.rename(hdfs_src_path="/d.txt",hdfs_dst_path="/d.bak.txt")

resolve()

返回绝对路径,接收一个参数hdfs_path

print(client.resolve("d.txt"))

set_replication()

设置文件在hdfs上的副本(datanode上)数量,接收两个参数,集群模式下的hadoop默认保存3份

• hdfs_path hdfs路径
• replication 副本数量

client.set_replication(hdfs_path="/b.txt",replication=2)

read()

读取文件信息 类似与 hdfs dfs -cat hfds_path,参数如下:

• hdfs_path hdfs路径
• offset 读取位置
• length 读取长度
• buffer_size 设置buffer_size 不设置使用hdfs默认100MB 对于大文件 buffer够大的化 sort与shuffle都更快
• encoding 指定编码
• chunk_size 字节的生成器,必须和encodeing一起使用 满足chunk_size设置即 yield
• delimiter 设置分隔符 必须和encodeing一起设置
• progress 读取进度回调函数 读取一个chunk_size回调一次

# 读取200长度
with client.read("/input.txt", length=200, encoding='utf-8') as obj:
    for i in obj:
        print(i)

# 从200位置读取200长度
with client.read("/input.txt", offset=200, length=200, encoding='utf-8') as obj:
    for i in obj:
        print(i)

# 设置buffer为1024,读取
with client.read("/input.txt", buffer_size=1024, encoding='utf-8') as obj:
    for i in obj:
        print(i)

# 设置分隔符为换行
p = client.read("/input.txt", encoding='utf-8', delimiter='\n')
with p as d:
    print(d, type(d), next(d))

# 设置读取每个块的大小为8
p = client.read("/input.txt", encoding='utf-8', chunk_size=8)
with p as d:
    print(d, type(d), next(d))

download()

从hdfs下载文件到本地,参数列表如下.

• hdfs_path hdfs路径
• local_path 下载到的本地路径
• overwrite 是否覆盖(如果有同名文件) 默认为Flase
• n_threads 启动线程数量,默认为1,不启用多线程
• temp_dir下载过程中文件的临时路径
• **kwargs其他属性

print("下载文件结果input.txt:", client.download(hdfs_path="/input.txt", local_path="~/",overwrite=True))

等同 hdfs dfs copyToLocal /input ~/

upload()

上传文件到hdfs 同hdfs dfs -copyFromLocal local_file hdfs_path,参数列表如下:

• hdfs_path, hdfs上位置
• local_path, 本地文件位置
• n_threads=1 并行线程数量 temp_dir=None, overwrite=True或者文件已存在的情况下的临时路径
• chunk_size=2 ** 16 块大小
• progress=None, 报告进度的回调函数 完成一个chunk_size回调一次 chunk_size可以设置大点 如果大文件的话
• cleanup=True, 上传错误时 是否删除已经上传的文件
• **kwargs 上传的一些关键字 一般设置为 overwrite 来覆盖上传

def callback(filename, size):
    print(filename, "完成了一个chunk上传", "当前大小:", size)
    if size == -1:
        print("文件上传完成")
        
# 上传成功返回 hdfs_path
client.upload(hdfs_path="/a_bak14.txt", local_path="a.txt", chunk_size=2 << 19, progress=callback,cleanup=True)

delete()

删除文件,接收三个参数

• hdfs_path
• recursive=False 是否递归删除
• skip_trash=True 是否移到垃圾箱而不是直接删除 hadoop 2.9+版本支持

client.delete("/a.s")

等同hdfs dfs -rm (-r)

set_owner()

类似与 hdfs dfs -chown root root hdfs_path修改目录或文件的所属用户,用户组,接收三个参数

• hdfs_path hdfs路径
• owner 用户
• group 用户组

注意:对于默认用户,只能修改自己的文件.

client.set_owner(hdfs_path="/a.txt", owner="root", group="root")

set_permission

修改权限,类似于hdfs dfs -chmod 777 hdfs_path,接收两个参数

• hdfs_path hdfs路径
• permission 权限

client.set_permission(hdfs_path="/b.txt",permission='755')

注意:对于默认用户,只能修改自己的文件.

set_acl()与acl_status()

查看和修改访问权限控制 需要开启acl支持

set_times()

设置文件时间,接收参数如下:

• hdfs_path: hdfs路径.
• access_time: 最后访问时间 时间戳 毫秒
• modification_time: 最后修改时间 时间戳 毫秒

import time

client.set_times(hdfs_path="/b.txt", access_time=int(time.time())*1000,
                 modification_time=int(time.time())*1000)