릴리스 노트
제품 공지

fs.ofs.tmp.cache.dir로 구성된 디렉터리에서 해당 JAR 패키지 및 버전을 확인할 수 있습니다.find / -name "chdfs*"find / -name "temrfs_hadoop*"
temrfs_hadoop_plugin 및 chdfs_hadoop_plugin 두 개의 jar 패키지가 있는지, chdfs_hadoop_plugin 버전이 2.7 이상인지 확인합니다.

chdfs_hadoop_plugin 버전을 업데이트해야 하는 경우 다음 작업을 수행하십시오.sh update_cos_jar.sh https://hadoop-jar-beijing-1259378398.cos.ap-beijing.myqcloud.com/hadoop_plugin_network/2.7
fs.cosn.bucket.region을 추가합니다. 매개변수 fs.cosn.trsf.fs.ofs.bucket.region은 버킷의 COS 리전(예: ap-shanghai)을 지정하는 데 사용됩니다.fs.cosn.bucket.region 및 fs.cosn.trsf.fs.ofs.bucket.region은 버킷의 COS 리전(예: ap-shanghai)을 지정하기 위한 필수 구성 항목입니다. 버킷에 해당하는 리전은 COS 리전 설명 문서를 참고하십시오.core-site.xml을 모든 Hadoop 노드에 동기화합니다.hadoop fs -ls cosn://${bucketname-appid}/ 명령어를 실행합니다(bucketname-appid는 마운트 주소, 즉 버킷 이름). 파일 목록이 정상적으로 나열되면 COS 버킷이 성공적으로 마운트되었음을 의미합니다.
classpath 경로에 올바르게 배치합니다./usr/local/service/hadoop/share/hadoop/common/lib/, 실제 상황에 따라 컴포넌트의 배치 위치가 다를 수 있습니다.hadoop-env.sh 파일을 수정합니다. $HADOOP_HOME/etc/hadoop 디렉터리로 이동하여 hadoop-env.sh 파일을 편집하고, 다음 내용을 추가하여 cosn 관련 jar 패키지를 Hadoop 환경 변수에 추가합니다.for f in $HADOOP_HOME/share/hadoop/tools/lib/*.jar; doif [ -n "$HADOOP_CLASSPATH" ]; thenHADOOP_CLASSPATH="$HADOOP_CLASSPATH:$f"elseHADOOP_CLASSPATH="$f"fidoneexport HADOOP_CLASSPATH
구성 항목 | 구성 항목 내용 | 설명 |
fs.AbstractFileSystem.ofs.impl | com.qcloud.chdfs.fs.CHDFSDelegateFSAdapter | 메타데이터 버킷 액세스 구현 클래스 |
fs.ofs.impl | com.qcloud.chdfs.fs.CHDFSHadoopFileSystemAdapter | 메타데이터 버킷 액세스 구현 클래스 |
fs.ofs.tmp.cache.dir | 형식 예시: /data/emr/hdfs/tmp/posix-cosn/ | 실제로 존재하는 로컬 디렉터리를 설정합니다. 실행 과정에서 생성된 임시 파일은 일시적으로 여기에 저장됩니다. 동시에 각 노드에서 해당 디렉터리에 충분한 공간과 권한을 구성할 것을 권장합니다. 예: /data/emr/hdfs/tmp/posix-cosn/ |
fs.ofs.user.appid | 형식 예시: 12500000000 | 필수. 사용자 appid |
fs.ofs.bucket.region | 형식 예시: ap-beijing | 필수. 사용자 bucket에 해당하는 region |
core-site.xml 구성 참조 예시:<!--ofs 구현 클래스--><property><name>fs.AbstractFileSystem.ofs.impl</name><value>com.qcloud.chdfs.fs.CHDFSDelegateFSAdapter</value></property><!--ofs 구현 클래스--><property><name>fs.ofs.impl</name><value>com.qcloud.chdfs.fs.CHDFSHadoopFileSystemAdapter</value></property><!--로컬 cache의 임시 디렉터리입니다. 데이터 읽기/쓰기 시 메모리가 부족한 경우 cache가 로컬 하드 디스크에 저장되며, 이 경로가 존재하지 않으면 자동 생성됩니다.--><property><name>fs.ofs.tmp.cache.dir</name><value>/data/chdfs_tmp_cache</value></property><!--사용자의 appId, Tencent Cloud 콘솔(https://console.tencentcloud.com/developer)에서 확인 가능--><property><name>fs.ofs.user.appid</name><value>1250000000</value></property><!--사용자 버킷의 리전 정보, 형식 예시: ap-guangzhou--><property><name>fs.ofs.bucket.region</name><value>ap-guangzhou</value></property>
구성 항목 | 구성 항목 내용 | 설명 |
fs.cosn.userinfo.secretId/secretKey | 형식 예시: ************************************ | |
fs.cosn.impl | org.apache.hadoop.fs.CosFileSystem | cosn이 FileSystem에 대한 구현 클래스이며, 고정 값은 org.apache.hadoop.fs.CosFileSystem입니다. |
fs.AbstractFileSystem.cosn.impl | org.apache.hadoop.fs.CosN | cosn은 AbstractFileSystem에 대한 구현 클래스이며, 고정 값은 org.apache.hadoop.fs.CosN입니다. |
fs.cosn.bucket.region | 형식 예시: ap-beijing | 액세스할 버킷의 리전 정보를 작성합니다. 열거형 값은 리전 및 액세스 도메인의 리전 약칭(예: ap-beijing, ap-guangzhou)을 참조하십시오. 기존 구성과 호환: fs.cosn.userinfo.region. |
fs.cosn.tmp.dir | 기본값 /tmp/hadoop_cos | 실제로 존재하는 로컬 디렉터리를 설정합니다. 실행 과정에서 생성된 임시 파일은 일시적으로 여기에 저장됩니다. 동시에 각 노드에서 해당 디렉터리에 충분한 공간과 권한을 구성할 것을 권장합니다. |
trsf.fs.ofs를 추가하여 구성 항목 매핑을 구현합니다. 필수 구성 항목은 다음과 같습니다.구성 항목 | 구성 항목 내용 | 설명 |
fs.cosn.trsf.fs.AbstractFileSystem.ofs.impl | com.qcloud.chdfs.fs.CHDFSDelegateFSAdapter | 메타데이터 버킷 액세스 구현 클래스 |
fs.cosn.trsf.fs.ofs.impl | com.qcloud.chdfs.fs.CHDFSHadoopFileSystemAdapter | 메타데이터 버킷 액세스 구현 클래스 |
fs.cosn.trsf.fs.ofs.tmp.cache.dir | 형식 예시: /data/emr/hdfs/tmp/posix-cosn/ | 실제로 존재하는 로컬 디렉터리를 설정합니다. 실행 과정에서 생성된 임시 파일은 일시적으로 여기에 저장됩니다. 동시에 각 노드에서 해당 디렉터리에 충분한 공간과 권한을 구성할 것을 권장합니다. 예: /data/emr/hdfs/tmp/posix-cosn/ |
fs.cosn.trsf.fs.ofs.user.appid | 형식 예시: 12500000000 | 필수. 사용자 appid |
fs.cosn.trsf.fs.ofs.bucket.region | 형식 예시: ap-beijing | 필수. 사용자 bucket에 해당하는 region |
core-site.xml 구성 참조 예시:<!--계정의 API 키 정보. [CAM 콘솔](https://console.tencentcloud.com/capi)에 로그인하여 API 키 확인 가능합니다.--><!--구성 보안을 강화하기 위해 서브 계정 키 또는 임시 키를 사용하는 것을 권장합니다. 서브 계정 권한 부여 시 [최소 권한 지침 원칙](https://www.tencentcloud.com/document/product/436/32972)을 준수하십시오.--><property><name>fs.cosn.userinfo.secretId/secretKey</name><value>************************************</value></property><!--cosn 구현 클래스--><property><name>fs.AbstractFileSystem.cosn.impl</name><value>org.apache.hadoop.fs.CosN</value></property><!--cosn 구현 클래스--><property><name>fs.cosn.impl</name><value>org.apache.hadoop.fs.CosFileSystem</value></property><!--사용자 버킷의 리전 정보, 형식 예시: ap-guangzhou--><property><name>fs.cosn.bucket.region</name><value>ap-guangzhou</value></property><!--로컬 임시 디렉터리, 실행 과정에서 생성된 임시 파일을 저장합니다.--><property><name>fs.cosn.tmp.dir</name><value>/tmp/hadoop_cos</value></property><!--ofs 구현 클래스--><property><name>fs.cosn.trsf.fs.AbstractFileSystem.ofs.impl</name><value>com.qcloud.chdfs.fs.CHDFSDelegateFSAdapter</value></property><!--ofs 구현 클래스--><property><name>fs.cosn.trsf.fs.ofs.impl</name><value>com.qcloud.chdfs.fs.CHDFSHadoopFileSystemAdapter</value></property><!--로컬 cache의 임시 디렉터리입니다. 데이터 읽기/쓰기 시 메모리가 부족한 경우 cache가 로컬 하드 디스크에 저장되며, 이 경로가 존재하지 않으면 자동 생성됩니다.--><property><name>fs.cosn.trsf.fs.ofs.tmp.cache.dir</name><value>/data/chdfs_tmp_cache</value></property><!--사용자의 appId, Tencent Cloud 콘솔(https://console.tencentcloud.com/developer)에서 확인 가능--><property><name>fs.cosn.trsf.fs.ofs.user.appid</name><value>1250000000</value></property><!--사용자 버킷의 리전 정보, 형식 예시: ap-guangzhou--><property><name>fs.cosn.trsf.fs.ofs.bucket.region</name><value>ap-guangzhou</value></property>
hadoop fs -ls cosn://${bucketname-appid}/ 명령어를 실행합니다(bucketname-appid는 마운트 주소, 즉 버킷 이름). 파일 목록이 정상적으로 나열되면 COS 버킷이 성공적으로 마운트되었음을 의미합니다.
피드백