All Products
Search
Document Center

PolarDB:Object storage service paths

Last Updated:Mar 28, 2026

GanosBase supports file import from Alibaba Cloud Object Storage Service (OSS), MinIO, and Hadoop Distributed File System (HDFS).

OSS path

Syntax:

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

access_key_id, secret_key, and bucket are required. Endpoint is optional — if omitted, GanosBase resolves the endpoint automatically. When omitting Endpoint, start the path with a forward slash (/).

Parameters:

ParameterRequiredDescription
access_key_idYesYour AccessKey ID
secret_keyYesYour AccessKey secret
EndpointNoThe OSS region endpoint. If omitted, GanosBase resolves it automatically.
bucketYesThe name of the OSS bucket
path_to/fileYesThe path to the file within the bucket
Endpoint specifies the region where OSS resides. Make sure the cluster and OSS are in the same region, and use an internal endpoint for access. For more information, see OSS domain names.

Example:

OSS://my_id:my_secret@oss-cn-hangzhou-internal.aliyuncs.com/my_bucket/my_folder/my_file

MinIO path

Syntax:

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

id, key, host, and bucket are required. port is optional — if omitted, the HTTPS port is used.

Parameters:

ParameterRequiredDescription
idYesYour MinIO access key ID
keyYesYour MinIO access key secret
hostYesThe hostname or IP address of the MinIO server
portNoThe MinIO server port. Defaults to the HTTPS port if omitted.
bucketYesThe name of the MinIO bucket
path_to/fileYesThe path to the file within the bucket
Make sure the cluster and MinIO are in the same region and Virtual Private Cloud (VPC), and use an internal network address for access.

Example:

MIO://my_id:my_secret@250.0.0.1:8080/my_bucket/my_folder/my_file

HDFS path

Syntax:

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

host and port are required and must match the Remote Procedure Call (RPC) endpoint and port in your HDFS configuration file. user_name is optional — if omitted, hadoop is used as the default.

Parameters:

ParameterRequiredDescription
user_nameNoThe HDFS username. Defaults to hadoop if omitted.
hostYesThe RPC endpoint from the HDFS configuration file
portYesThe RPC port from the HDFS configuration file
path_to/fileYesThe path to the file in HDFS
Make sure the cluster and HDFS are in the same region and VPC, and use an internal IP address for access.

Examples:

Without user_name (defaults to hadoop):

HDFS://my_id@250.0.0.1:8081/my_folder/my_file

With user_name specified:

HDFS://my_id:my_secret@250.0.0.1:8081/my_folder/my_file