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)
