Skip to contents

Rename a DuckLake table

Source: R/schema_evolution.R
rename_ducklake_table.Rd

Renames a table in place with ALTER TABLE ... RENAME TO, a metadata-only change.

Usage

rename_ducklake_table(from, to)

Arguments

from

Current table name.

to

New table name.

Value

Invisibly returns NULL.

Details

History survives the rename, but snapshots from before it stay associated with the old name: get_ducklake_table_version() on the new name reaches back only as far as the rename, while the old name still serves the earlier snapshots.

See also

rename_table_column()

Other schema evolution: add_table_column(), drop_table_column(), rename_table_column(), set_column_type()

Examples

if (FALSE) { # \dontrun{
rename_ducklake_table("sales", "sales_daily")
} # }