GanosBase supports importing files from Alibaba Cloud Object Storage Service (OSS), MinIO, and Hadoop Distributed File System (HDFS).
OSS path format
oss://<access_id>:<secret_key>@[<Endpoint>]/<bucket>/path_to/file| Parameter | Required | Default | Description |
|---|---|---|---|
access_id | Yes | — | Your OSS access key ID |
secret_key | Yes | — | Your OSS access key secret |
Endpoint | No | Auto-detected | The endpoint of the OSS region. If omitted, GanosBase detects the endpoint automatically, and the path must start with /. Use an internal endpoint to keep the cluster and OSS in the same region and avoid public network egress. For endpoint formats, see OSS domain names. |
bucket | Yes | — | The name of your OSS bucket |
path_to/file | Yes | — | The path to the file within the bucket |
MinIO path format
mio://<id>:<key>@<host>[:<port>]/<bucket>/path_to/file| Parameter | Required | Default | Description |
|---|---|---|---|
id | Yes | — | Your MinIO access key ID |
key | Yes | — | Your MinIO access key secret |
host | Yes | — | The host address of your MinIO instance. Use an internal network address to keep the cluster and MinIO in the same region and Virtual Private Cloud (VPC). |
port | No | HTTPS port | The port of your MinIO instance |
bucket | Yes | — | The name of your MinIO bucket |
path_to/file | Yes | — | The path to the file within the bucket |
HDFS path format
HDFS://<user_name>@<host>:<port>/path_to/file| Parameter | Required | Default | Description |
|---|---|---|---|
user_name | No | hadoop | The HDFS username |
host | Yes | — | The Remote Procedure Call (RPC) endpoint from your HDFS configuration file. Use an internal IP address to keep the cluster and HDFS in the same region and VPC. |
port | Yes | — | The RPC port from your HDFS configuration file |
path_to/file | Yes | — | The path to the file in HDFS |
Examples
OSS
With endpoint specified (recommended for cross-region access control):
oss://my_id:my_secret@oss-cn-hangzhou-internal.aliyuncs.com/my_bucket/my_folder/my_fileMinIO
mio://my_id:my_secret@250.0.0.1:8080/my_bucket/my_folder/my_fileHDFS
Without secret (defaults to hadoop):
HDFS://my_id@250.0.0.1:8081/my_folder/my_fileWith secret specified:
HDFS://my_id:my_secret@250.0.0.1:8081/my_folder/my_file