Todos os produtos
Search
Central de documentação

E-MapReduce:Guia de início rápido para OSS e OSS-HDFS

Última atualização: Jun 27, 2026

Este tópico explica como acessar rapidamente o OSS e o OSS-HDFS.

Pré-requisitos

  • Ativar o OSS.

  • Crie buckets.

  • Verifique se você tem as permissões necessárias para acessar o OSS.

    • Clusters EMR gerenciados no novo console já possuem as permissões necessárias por padrão. Caso encontre algum problema, consulte Autorizar funções de serviço.

    • Clusters EMR gerenciados no console antigo também possuem as permissões necessárias por padrão. Se houver algum erro, consulte Atribuir funções.

    • Para conceder permissões em um ambiente fora do EMR, consulte Autorização do OSS e OSS-HDFS.

  • (Opcional, recomendado) Ative o OSS-HDFS e conceda permissões de acesso ao serviço.

  • Verifique a versão do JindoSDK implantada.

    • O JindoSDK vem incluído por padrão nos clusters EMR.

      Nota

      Para acessar o OSS-HDFS, crie um cluster com a versão EMR-3.42.0 ou posterior, ou EMR-5.8.0 ou posterior.

    • Em ambientes que não utilizam EMR, consulte Implantar o JindoSDK em um ambiente diferente do EMR.

      Nota

      O acesso ao OSS-HDFS exige a implantação do JindoSDK 4.x ou superior.

Caminhos

A única diferença entre o acesso ao OSS e ao OSS-HDFS é o endpoint utilizado no caminho. As demais formas de uso são idênticas. A tabela a seguir apresenta exemplos de caminhos raiz e descrições para ambos os sistemas.

Sistema de armazenamento

Exemplo de caminho raiz

Descrição

OSS

oss://examplebucket.oss-cn-shanghai-internal.aliyuncs.com/

Caminho referente a um bucket do OSS chamado examplebucket na região China (Shanghai), acessado por meio de um endpoint interno.

Nota

Essa configuração indica que o acesso entre regiões não é suportado por padrão.

OSS-HDFS

oss://examplebucket.cn-shanghai.oss-dls.aliyuncs.com/

Caminho referente a um bucket com OSS-HDFS habilitado, denominado examplebucket, na região China (Shanghai).

Nota

Essa configuração indica que o acesso entre regiões não é suportado por padrão.

Métodos de acesso

Você pode acessar o OSS e o OSS-HDFS de quatro maneiras: comandos Hadoop Shell, comandos Jindo CLI, comandos POSIX e pelo console do OSS.

Método de acesso

Exemplo

Descrição

Comando Hadoop Shell

hadoop fs -ls oss://examplebucket.cn-shanghai.oss-dls.aliyuncs.com/

O JindoOssFileSystem, parte do JindoSDK, implementa a interface Hadoop FileSystem. Ao executar um comando Hadoop Shell, o cliente utiliza o endpoint presente no caminho para acessar o OSS ou o OSS-HDFS. Para mais informações, consulte Usar comandos Hadoop Shell para acessar o OSS ou OSS-HDFS.

Comando Jindo CLI

jindo fs -ls oss://examplebucket.cn-shanghai.oss-dls.aliyuncs.com/

O acesso ao OSS ou OSS-HDFS via comandos Jindo CLI assemelha-se ao uso de comandos Hadoop Shell. O Jindo CLI oferece recursos adicionais, como arquivamento de dados, cache e análise de erros. Para mais detalhes, consulte Usar comandos Jindo CLI para acessar o OSS ou OSS-HDFS.

Comando POSIX

mkdir -p /mnt/oss jindo-fuse /mnt/oss -ouri=oss://examplebucket.cn-shanghai.oss-dls.aliyuncs.com/ ls /mnt/oss

O JindoFuse implementa a API FUSE para montar um caminho do OSS ou OSS-HDFS em um diretório local. Essa configuração permite acessar objetos no OSS ou OSS-HDFS como se fossem arquivos locais. Para saber mais, consulte Usar comandos POSIX para acessar o OSS ou OSS-HDFS.

Console do OSS

Use a interface do console. Consulte a coluna Descrição para obter detalhes.

Para gerencie seus dados no console do OSS, siga estas etapas:

  1. Faça login no console do OSS.

  2. Na página Buckets, clique em no nome do bucket desejado.

  3. No painel de navegação à esquerda, escolha File Management > Objects.

  4. Clique em na aba OSS Object ou HDFS para acessar seus dados.