GanosBase supports creating, importing, and exporting data stored in Alibaba Cloud Object Storage Service (OSS) buckets, self-managed Multi-Cloud Object Storage (MinIO) buckets, and Hadoop Distributed File System (HDFS). Use the path formats below to reference files in GanosBase operations.
OSS paths
oss://<access_id>:<secret_key>@[<Endpoint>]/<bucket>/path_to/file[:<subset>]Example:
oss://my_access_id:my_secret_key@oss-cn-hangzhou.aliyuncs.com/my-bucket/spatial-data/cities.csvParameters:
| Parameter | Required | Description |
|---|---|---|
access_id | Yes | Your access key ID |
secret_key | Yes | Your secret access key |
Endpoint | No | The OSS endpoint for the region where your bucket resides. If omitted, the system resolves the endpoint automatically — the path must then start with a forward slash (/). For endpoint values, see OSS domain names. |
bucket | Yes | The name of your OSS bucket |
path_to/file | Yes | The path to the file within the bucket |
subset | No | An optional subset selector for the file |
For best import performance, place your PolarDB instance and the OSS bucket in the same region.
MinIO paths
mio://<id>:<key>@<host>[:<port>]/<bucket>/path_to/file[:<subset>]Example:
mio://my_id:my_key@minio.internal.example.com:9000/my-bucket/spatial-data/cities.csvParameters:
| Parameter | Required | Description |
|---|---|---|
id | Yes | Your MinIO access key ID |
key | Yes | Your MinIO secret access key |
host | Yes | The hostname or IP address of your MinIO server |
port | No | The port number. Defaults to the HTTPS port if omitted. |
bucket | Yes | The name of your MinIO bucket |
path_to/file | Yes | The path to the file within the bucket |
subset | No | An optional subset selector for the file |
For best import performance, place your database instance and the MinIO bucket in the same region and virtual private cloud (VPC) so they can communicate over an internal network.
For more information about MinIO, see Multi-Cloud Object Storage.
HDFS paths
HDFS://<user_name>@<host>:<port>/path_to/file[:<subset>]Example:
HDFS://hadoop@namenode.internal.example.com:8020/user/data/spatial/cities.csvParameters:
| Parameter | Required | Description |
|---|---|---|
user_name | No | The HDFS username. Defaults to hadoop if omitted. |
host | Yes | The HDFS NameNode hostname, as defined in the HDFS configuration file |
port | Yes | The Remote Procedure Call (RPC) port, as defined in the HDFS configuration file |
path_to/file | Yes | The path to the file within HDFS |
subset | No | An optional subset selector for the file |
For best import performance, place your database instance and the HDFS cluster in the same region and VPC so they can communicate over an internal network.