diff --git a/docs/en/sql-reference/00-sql-reference/31-system-tables/system-copy-history.md b/docs/en/sql-reference/00-sql-reference/31-system-tables/system-copy-history.md new file mode 100644 index 0000000000..e4aace0f65 --- /dev/null +++ b/docs/en/sql-reference/00-sql-reference/31-system-tables/system-copy-history.md @@ -0,0 +1,23 @@ +--- +title: system.copy_history +--- + +import FunctionDescription from '@site/src/components/FunctionDescription'; + + + +Contains information about copy history. + +```sql +select * from copy_history('abc'); + +╭──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮ +│ file_name │ content_length │ last_modified │ etag │ +│ String │ UInt64 │ Nullable(Timestamp) │ Nullable(String) │ +├─────────────────────────────────────────────────────────────┼────────────────┼────────────────────────────┼──────────────────┤ +│ data_0199db4c843a70b2b81f115f01c8de97_0000_00000000.parquet │ 10531 │ 2025-10-13 02:00:49.083208 │ NULL │ +╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯ +``` + +Note that, the results of `system.copy_history` is respected by settings `load_file_metadata_expire_hours` which is 24 hours by default. +