All Products
Search
Document Center

ApsaraDB RDS:Object storage paths

Last Updated:Dec 13, 2023

Ganos allows you to create, import, and export raster data that is stored in Alibaba Cloud Object Storage Service (OSS) buckets, self-managed Multi-Cloud Object Storage (MinIO) buckets, and Hadoop Distributed File System (HDFS) files. This topic describes the paths of the raster data in the buckets and files.

Paths of raster data in OSS buckets

The path of raster data in an OSS bucket is in the following format:

oss://<access_id>:<secrect_key>@[<Endpoint>]/bucket_name/path_to/file[:<subset>]
Note

The following list describes the parameters:

  • If the raster data is in NetCDF and contains a subset, you can specify the :<subset> parameter.

  • access_id and secrect_key specify the AccessKey ID and AccessKey secret of the AccessKey pair that is used to access your Object Storage Service (OSS) bucket. For more information, see Obtain an AccessKey pair.

  • Endpoint specifies the endpoint of the OSS bucket. To ensure data accessibility, make sure that your RDS instance and your OSS bucket reside in the same region and are connected by using the internal OSS endpoint. For more information, see OSS endpoints.

  • bucket_name specifies the name of the OSS bucket.

  • /path_to/file specifies the directory of the file in the OSS bucket.

Paths of raster data in MinIO buckets

The path of raster data in a MinIO bucket is in the following format. For more information about MinIO buckets, see Multi-Cloud Object Storage.

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

If the raster data is in NetCDF and contains a subset, you can specify the :<subset> parameter.

If you do not specify the port parameter, the HTTPS port is used. To import data at high performance, make sure that your RDS instance and the self-managed MinIO bucket reside in the same region and can communicate over an internal network.

Paths of raster data in HDFS files

The path of raster data in an HDFS file is in the following format:

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

If the raster data is in NetCDF and contains a subset, you can specify the :<subset> parameter.

  • If you do not specify the user_name parameter, the default value hadoop is used.

  • The host and port parameters specify the endpoint and port of remote procedure calls (RPCs) in the HDFS configuration file.

  • To import data at high performance, make sure that your RDS instance and the HDFS cluster reside in the same VPC and communicate over an internal network.