07 · Tables A→ZJ · Organize & reshape
Attach & manage files alongside data
List, upload, download, and delete raw files in a storage connection - independent of Delta tables.
Not everything is a table. These tools work on the raw objects in a
storage connection (the bucket/container behind a
config_id), independent of Delta tables - upload a CSV, download a file, browse
folders.
Browse
list_objects(config_id, path="master-data", delimiter=true, extensions="csv,parquet", limit=100)CLI: eddytor get objects <config-id>. delimiter=true gives a directory-style
listing (folders in common_prefixes); page with the returned
continuation_token (limit default 100, max 1000).
Upload & download
# upload from base64; destination is path/filename
upload_object(config_id, path="master-data", filename="products.csv", content_base64="<…>")
# download (returns content_base64)
download_object(config_id, path="master-data/products.csv")Heads up
Size limits:
download_object rejects objects over 8
MiB (use the REST download endpoint for larger), and upload_object caps
decoded content at 100 MiB. filename must have no path separators. Paths are
validated - no .., leading /, //, or null bytes.Organise & delete
create_folder(config_id, path="master-data/archive")
delete_object(config_id, path="master-data/old.csv")Heads up
delete_object targets a single object, not a prefix. To
move or remove a whole prefix, use move_objects.Raw files vs tables
Files discovered in storage are read-only even when they appear as tables - only Delta tables are writable. For tabular data you'll query or edit, import it into a real table rather than leaving it as a raw object.