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 |
|
|
AccessKey ID do par de AccessKey usado para acessar o bucket do OSS. Consulte Obter um par de AccessKey. |
|
|
AccessKey secret do par de AccessKey. |
|
|
(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. |
|
|
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
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 de acesso do MinIO. |
|
|
Chave de acesso do MinIO. |
|
|
Nome do host ou endereço IP do servidor MinIO. |
|
|
(Opcional) Porta do servidor MinIO. Se omitida, o sistema usa a porta HTTPS. |
|
|
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
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 |
|
|
(Opcional) Nome de usuário do HDFS. Se omitido, o valor padrão é |
|
|
Endpoint do serviço Remote Procedure Call (RPC), definido no arquivo de configuração do HDFS. |
|
|
(Opcional) Porta RPC, definida no arquivo de configuração do HDFS. |
|
|
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 |
|
AccessKey ID, AccessKey secret |
Endpoint (opcional) |
— |
|
MinIO |
|
Access ID, chave de acesso |
|
Porta HTTPS |
|
HDFS |
|
Nome de usuário (opcional) |
|
Usuário |