Prerequisites
What you need before creating a table: a registered storage connection and write access.
Two things must be in place before you can create or load a table.
1. A registered storage connection
Tables live in your object storage, so Eddytor needs a connection to write into. Nothing can be created until a storage config exists.
- Register one - see Connect Storage (S3, GCS, Azure Blob), or use the bundled Garage for evaluation.
- Capture its
config_id(eddytor get storage/list_storage_configs) - you'll reference it when creating and moving tables.
2. Write access
Creating tables and managing schemas requires the Builder role (or Admin) - see Roles & scopes. An API key used for automation must carry the matching scopes, and can never exceed its creator's role.
| To… | You need |
|---|---|
| Query / read | Viewer |
| Insert / update / delete rows | Editor |
| Create tables, manage schema & domains | Builder |
| Manage users / org | Admin |
3. Know your location
When creating a table you provide a location - a full storage URL under a
registered connection, e.g.
abfss://mdm@acme.dfs.core.windows.net/master-data or
s3://your-bucket/master-data. (The CLI/REST infer it from the storage config +
path; the MCP create_table takes the full URL.)
Ready?
- Create an empty table from a schema, or
- Spin up a demo table to explore first.