07 · Tables A→ZJ · Organize & reshape
Rename a table
Change a table's path within the same storage connection - identity is preserved.
rename_table gives a table a new path within the same
storage connection. The table keeps its
stable UUID - only its
fully-qualified name / path
changes.
Rename
eddytor rename table eddytor sales orders --destination-path europe/ordersrename_table(table="eddytor.cfg_xxx.<uuid>_products", destination_path="europe/products")Heads up
destination_path is RELATIVE (e.g. europe/products) -
never a URL like s3://… or abfss://…. It stays within the same storage
config; to cross configs use move_table.It copies, then re-identifies
Rename copies the underlying _delta_log and data files, so the table keeps its
identity (table_id) but its FQN/path changes.
Good to know
Refresh the FQN from
list_tables afterward - the path you used in
prior calls is now stale.Blocked while referenced
Rename is refused while another table references this one via a cross-table reference domain. Remove the dependent reference first.