Paths
The SDK supports a small set of storage path schemes. Put short: choose the scheme that matches where your files live and follow the scheme-specific rules below.
Supported schemes
- Local paths — files available on the local filesystem.
- S3 paths — S3 or S3-compatible object storage (bucket/key or prefix).
- Remote paths — HTTP(S) resources (single files or archives).
- SQL paths — database tables (Postgres-compatible).
Entity paths
When creating an Artifact, Dataitem or Model you pass a path
(a Python str
) to indicate where the data or artifact lives. Rules:
- Local paths have no scheme (e.g.
./dir/file.csv
). - Non-local paths must include a scheme (for example
s3://
,http://
,https://
,sql://
). - A path can reference a single file, a directory/prefix, a partition, or — for
sql://
— a single table. See each scheme page for precise formats and examples.