Todos os produtos
Search
Central de documentação

ApsaraDB RDS:Caminhos de armazenamento de objetos

Última atualização: Jul 05, 2026

O GanosBase usa strings de caminho baseadas em URI para localizar dados vetoriais em buckets do Object Storage Service (OSS), buckets MinIO autogerenciados e clusters do Hadoop Distributed File System (HDFS). Cada sistema de armazenamento adota um esquema de URI e um conjunto de parâmetros específicos.

Caminhos do OSS

oss://<access_id>:<secret_key>@[<Endpoint>]/<bucket>/path_to/file

Exemplo:

oss://LTAI5tExampleKey:xXxExampleSecret@oss-cn-hangzhou-internal.aliyuncs.com/my-bucket/geodata/points.shp

Parâmetro

Descrição

access_id

AccessKey ID do par de AccessKey usado para acessar o bucket do OSS. Consulte Obter um par de AccessKey.

secret_key

AccessKey secret do par de AccessKey.

Endpoint

(Opcional) Endpoint interno do bucket do OSS. Use o endpoint interno para manter o tráfego na rede privada da Alibaba Cloud. Consulte Endpoints do OSS.

/<bucket>/path_to/file

Caminho do objeto no bucket do OSS.

Requisito para Shapefile: Se o arquivo for um Shapefile, carregue os arquivos .shp, .shx e .dbf na mesma pasta do bucket do OSS. Os três tipos de arquivo são obrigatórios.

Requisito de rede: Coloque a instância do ApsaraDB RDS e o bucket do OSS na mesma região e use o endpoint interno para garantir o acesso aos dados.

Caminhos do MinIO

Nota

O acesso ao MinIO tem suporte apenas em ambientes de nuvem híbrida.

mio://<id>:<key>@<host>[:<port>]/<bucket>/path_to/file

Exemplo:

mio://EXAMPLEID:EXAMPLEKEY@minio.internal.example.com:9000/my-bucket/geodata/points.shp

Parâmetro

Descrição

id

ID de acesso do MinIO.

key

Chave de acesso do MinIO.

host

Nome do host ou endereço IP do servidor MinIO.

port

(Opcional) Porta do servidor MinIO. Se omitida, o sistema usa a porta HTTPS.

/<bucket>/path_to/file

Caminho do arquivo no bucket do MinIO.

Requisito de rede: Para obter o melhor desempenho de importação, coloque a instância do ApsaraDB RDS e o bucket do MinIO na mesma região e na mesma rede interna.

Caminhos do HDFS

Nota

O acesso ao HDFS tem suporte apenas em ambientes de nuvem híbrida.

HDFS://<user_name>@<host>[:<port>]/path_to/file

Exemplo:

HDFS://hdfs-user@namenode.internal.example.com:8020/user/geodata/points.shp

Parâmetro

Descrição

user_name

(Opcional) Nome de usuário do HDFS. Se omitido, o valor padrão é hadoop.

host

Endpoint do serviço Remote Procedure Call (RPC), definido no arquivo de configuração do HDFS.

port

(Opcional) Porta RPC, definida no arquivo de configuração do HDFS.

/path_to/file

Caminho do arquivo no sistema de arquivos HDFS.

Requisito de rede: Para maximizar o desempenho de importação, coloque a instância do ApsaraDB RDS e o cluster HDFS na mesma Virtual Private Cloud (VPC) e comunique-se pela rede interna.

Comparação de caminhos de armazenamento

Sistema de armazenamento

Esquema

Credenciais

Endereço

Padrão quando omitido

OSS

oss://

AccessKey ID, AccessKey secret

Endpoint (opcional)

MinIO

mio://

Access ID, chave de acesso

host[:port]

Porta HTTPS

HDFS

HDFS://

Nome de usuário (opcional)

host[:port]

Usuário hadoop; sem porta padrão