EddytorDocs & API
07 · Tables A→ZJ · Organize & reshape

Move between schemas / folders

Relocate a table to a different storage connection with move_table, or raw objects with move_objects.

Use move_table to relocate a registered table to a different storage connection (e.g. dev → prod). For raw files that aren't a registered table, use move_objects.

Move a table

eddytor move table eddytor sales orders \
  --dest-config-id 550e8400-e29b-41d4-a716-446655440000 \
  --dest-path master-data/orders
move_table(table="eddytor.cfg_xxx.<uuid>_products",
  destination_config_id="550e8400-e29b-41d4-a716-446655440000",
  destination_path="master-data/products")
  • destination_config_id - the target connection's id (from list_tables / list_storage_configs).
  • destination_path is relative, never a URL.

Like rename, move copies the _delta_log + data, so the table keeps its identity while its path/FQN changes - refresh from list_tables afterward.

Good to know

Use rename for in-place reorganisation within one connection; reserve move for crossing storage configs.

Move raw objects

For a whole prefix of raw files (not a registered table):

move_objects(source_config_id, source_path="staging/products",
  destination_config_id, destination_path="master-data/products")

Heads up

move_objects deregisters any Delta table at the source and re-runs discovery at the destination - paths shift, so re-check list_tables after. To relocate a table specifically, prefer move_table.

Blocked while referenced

Move is refused while another table references this one via a reference domain - remove the dependent first.

Next

On this page