JindoSDK 为 JindoFSx 存储加速系统系统提供了 Apache Hadoop 支持。
- 已部署 JindoFSx 存储加速系统
关于如何部署 JindoFSx 存储加速系统,请参考 部署 JindoFSx 存储加速系统
- 已部署 JindoSDK
关于如何部署 JindoSDK,请参考 部署 JindoSDK
- 配置实现类
将 JindoFSx 服务 OSS 实现类配置到 Hadoop 的core-site.xml中。
<configuration>
<property>
<name>fs.AbstractFileSystem.oss.impl</name>
<value>com.aliyun.jindodata.oss.OSS</value>
</property>
<property>
<name>fs.oss.impl</name>
<value>com.aliyun.jindodata.oss.JindoOssFileSystem</value>
</property>
<property>
<name>fs.xengine</name>
<value>jindofsx</value>
</property>
</configuration>- 配置 Access Key
将 OSS-HDFS 服务 Bucket 对应的Access Key ID、Access Key Secret等预先配置在 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>JindoSDK 还支持更多的 AccessKey 的配置方式,详情参考 JindoSDK OSS-HDFS 服务 Credential Provider 配置。
- 配置 OSS-HDFS 服务 Endpoint
访问 OSS Bucket 上 OSS-HDFS 服务需要配置 Endpoint(cn-xxx.oss-dls.aliyuncs.com),与 OSS 对象接口的 Endpoint(oss-cn-xxx-internal.aliyuncs.com)不同。JindoSDK 会根据配置的 Endpoint 访问 OSS-HDFS 服务 或 OSS 对象接口。
使用 OSS-HDFS 服务时,推荐访问路径格式为:oss://<Bucket>.<Endpoint>/<Object>
如: oss://mydlsbucket.cn-shanghai.oss-dls.aliyuncs.com/Test。
这种方式在访问路径中包含 OSS-HDFS 服务的 Endpoint,JindoSDK 会根据路径中的 Endpoint 访问对应的 JindoFS 接口。 JindoSDK 还支持更多的 Endpoint 配置方式,详情参考 OSS-HDFS 服务 Endpoint 配置。
- 配置 JindoFSx Namespace 服务地址
配置在 Hadoop 的core-site.xml中。
<configuration>
<property>
<!-- Namespace service 地址 -->
<name>fs.jindofsx.namespace.rpc.address</name>
<value>headerhost:8101</value>
</property>
</configuration>若使用高可用 Namespace, 请参考 高可用 JindoFSx Namespace 配置和使用
- 开启数据缓存。
配置在 Hadoop 的core-site.xml中。
<configuration>
<property>
<!-- 数据缓存开关 -->
<name>fs.jindofsx.data.cache.enable</name>
<value>true</value>
</property>
</configuration>更多缓存优化相关参数,请参考 缓存优化相关参数
用 Hadoop Shell 访问 JindoFS,下面列举了几个常用的命令。
- put 操作
hadoop fs -put <path> oss://<Bucket>.<Endpoint>/
- ls 操作
hadoop fs -ls oss://<Bucket>.<Endpoint>/
- mkdir 操作
hadoop fs -mkdir oss://<Bucket>.<Endpoint>/<path>
- rm 操作
hadoop fs -rm oss://<Bucket>.<Endpoint>/<path>
JindoSDK 包含一些高级调优参数,配置方式以及配置项参考文档 JindoSDK 配置项列表