OSS-HDFS服务(JindoFS服务)完全兼容HDFS接口,同时支持目录层级的操作。JindoSDK为Apache Hadoop的计算分析应用(例如MapReduce、Hive、Spark、Flink等)提供了访问HDFS服务的能力。本文介绍如何通过在ECS实例中部署JindoSDK,然后完成OSS-HDFS服务快速入门相关操作。
前提条件
已创建ECS实例。具体步骤,请参见选购ECS实例。
已创建Hadoop环境。具体步骤,请参见创建Hadoop运行环境。
已开通并授权访问OSS-HDFS服务。具体操作,请参见开通并授权访问OSS-HDFS服务。
操作视频
观看以下视频了解如何通过非EMR集群快速接入OSS-HDFS服务并完成常见操作。
操作步骤
连接ECS实例。具体操作,请参见连接ECS实例。
下载并解压JindoSDK JAR包。
执行以下命令,下载最新版本的JindoSDK JAR包。下载地址,请参见GitHub。
wget https://jindodata-binary.oss-cn-hangzhou.aliyuncs.com/release/x.x.x/jindosdk-x.x.x.tar.gz
说明x.x.x表示JindoSDK JAR包版本号。
执行以下命令,解压JindoSDK JAR包。
tar zxvf jindosdk-x.x.x.tar.gz
配置环境变量。
配置
JINDOSDK_HOME
。以安装包内容解压在/usr/lib/jindosdk-x.x.x目录为例:
export JINDOSDK_HOME=/usr/lib/jindosdk-x.x.x
配置
HADOOP_CLASSPATH
。export HADOOP_CLASSPATH=$HADOOP_CLASSPATH:${JINDOSDK_HOME}/lib/*
重要请将安装目录和环境变量部署到所有所需节点上。
配置JindoFS服务实现类及AccessKey。
执行以下命令,进入Hadoop的core-site.xml配置文件。
vim /usr/local/hadoop/etc/hadoop/core-site.xml
将JindoSDK DLS实现类配置到Hadoop的core-site.xml中。
<configuration> <property> <name>fs.AbstractFileSystem.oss.impl</name> <value>com.aliyun.jindodata.oss.JindoOSS</value> </property> <property> <name>fs.oss.impl</name> <value>com.aliyun.jindodata.oss.JindoOssFileSystem</value> </property> </configuration>
将已开启HDFS服务的Bucket对应的accessKeyId、accessKeySecret预先配置在Hadoop的core-site.xml中。
<configuration> <property> <name>fs.oss.accessKeyId</name> <value>xxx</value> </property> <property> <name>fs.oss.accessKeySecret</name> <value>xxx</value> </property> </configuration>
配置JindoFS服务Endpoint。
使用JindoFS服务访问OSS Bucket时需要配置Endpoint。推荐访问路径格式为
oss://<Bucket>.<Endpoint>/<Object>
,例如oss://examplebucket.cn-hangzhou.oss-dls.aliyuncs.com/exampleobject.txt
。配置完成后,JindoSDK会根据访问路径中的Endpoint访问对应的JindoFS服务接口。您还可以通过其他方式配置JindoFS服务Endpoint,且不同方式配置的Endpoint存在生效优先级。更多信息,请参见附录一:配置Endpoint的其他方式。
通过HDFS Shell命令执行OSS-HDFS服务快速入门常见操作。
上传文件
将本地根目录下的examplefile.txt文件上传至examplebucket,示例如下:
hdfs dfs -put examplefile.txt oss://examplebucket.cn-hangzhou.oss-dls.aliyuncs.com/
新建目录
在examplebucket下创建名为dir/的目录,示例如下:
hdfs dfs -mkdir oss://examplebucket.cn-hangzhou.oss-dls.aliyuncs.com/dir/
查看文件或目录信息
查看examplebucket下的文件或目录信息,示例如下:
hdfs dfs -ls oss://examplebucket.cn-hangzhou.oss-dls.aliyuncs.com/
获取文件或目录大小
获取examplebucket下所有文件或目录的大小,示例如下:
hdfs dfs -du oss://examplebucket.cn-hangzhou.oss-dls.aliyuncs.com/
查看文件内容
查看examplebucket下名为localfile.txt的文件内容,示例如下:
hdfs dfs -cat oss://examplebucket.cn-hangzhou.oss-dls.aliyuncs.com/localfile.txt
重要查看文件内容时,文件内容将以纯文本形式打印到屏幕上。如果文件内容进行了特定格式的编码,请使用HDFS的Java API读取并解码文件内容。
拷贝目录或文件
例如,将examplebucket下根目录subdir1拷贝到目录subdir2下,且根目录subdir1所在的位置、根目录下的文件和子目录结构和内容保持不变,示例如下:
hdfs dfs -cp oss://examplebucket.cn-hangzhou.oss-dls.aliyuncs.com/subdir1 oss://examplebucket.cn-hangzhou.oss-dls.aliyuncs.com/subdir2/subdir1
移动目录或文件
例如,将examplebucket根目录srcdir及其包含的文件或者子目录移动至另一个根目录destdir下,示例如下:
hdfs dfs -mv oss://examplebucket.cn-hangzhou.oss-dls.aliyuncs.com/srcdir oss://examplebucket.cn-hangzhou.oss-dls.aliyuncs.com/destdir
下载文件
将examplebucket下的exampleobject.txt下载到本地根目录文件夹/tmp,示例如下:
hdfs dfs -get oss://examplebucket.cn-hangzhou.oss-dls.aliyuncs.com/exampleobject.txt /tmp/
删除目录或文件
删除examplebucket下destfolder/目录及其目录下的所有文件,示例如下:
hdfs dfs -rm -r oss://examplebucket.cn-hangzhou.oss-dls.aliyuncs.com/destfolder/