diff --git a/pgcolumnar--1.0-alpha2--1.0-alpha3.sql b/pgcolumnar--1.0-alpha2--1.0-alpha3.sql index 4f80f4b..9b50bf8 100644 --- a/pgcolumnar--1.0-alpha2--1.0-alpha3.sql +++ b/pgcolumnar--1.0-alpha2--1.0-alpha3.sql @@ -293,3 +293,6 @@ $sort_status$; COMMENT ON FUNCTION pgcolumnar.sort_status(regclass) IS 'how much of an ordered columnar table is still in its ordered run, and by what kind of ordering (#301, #761)'; + +COMMENT ON FUNCTION pgcolumnar.vacuum_sorted(regclass, name[]) + IS 'compact a columnar table, storing rows sorted ascending (NULLS LAST) on the given columns. With no columns, applies the table''s declared sort_by key from set_options (#288), like a bare CLUSTER re-applying a remembered index; errors if none is declared. Supports any btree-orderable column including text and numeric, unlike Z-order cluster(), which takes integer, date/time, boolean and floating-point columns only. One-shot: not auto-maintained.'; diff --git a/pgcolumnar--1.0-alpha3.sql b/pgcolumnar--1.0-alpha3.sql index b7355bc..56596d8 100644 --- a/pgcolumnar--1.0-alpha3.sql +++ b/pgcolumnar--1.0-alpha3.sql @@ -895,7 +895,7 @@ CREATE FUNCTION pgcolumnar.vacuum_sorted( AS 'MODULE_PATHNAME', 'pgcolumnar_vacuum_sorted'; COMMENT ON FUNCTION pgcolumnar.vacuum_sorted(regclass, name[]) - IS 'compact a columnar table, storing rows sorted ascending (NULLS LAST) on the given columns. With no columns, applies the table''s declared sort_by key from set_options (#288), like a bare CLUSTER re-applying a remembered index; errors if none is declared. Supports any btree-orderable column including text (unlike the numeric-only Z-order cluster()). One-shot: not auto-maintained.'; + IS 'compact a columnar table, storing rows sorted ascending (NULLS LAST) on the given columns. With no columns, applies the table''s declared sort_by key from set_options (#288), like a bare CLUSTER re-applying a remembered index; errors if none is declared. Supports any btree-orderable column including text and numeric, unlike Z-order cluster(), which takes integer, date/time, boolean and floating-point columns only. One-shot: not auto-maintained.'; /* * One-argument form: apply the declared sort_by key (#288). A VARIADIC function diff --git a/src/columnar_vacuum.c b/src/columnar_vacuum.c index 35f5275..b041973 100644 --- a/src/columnar_vacuum.c +++ b/src/columnar_vacuum.c @@ -1740,7 +1740,8 @@ vacuum_sorted_gate_is_noop(Relation rel, int ncols, AttrNumber *atts) * declared sort_by key from pgcolumnar.options (#288), like a bare * "CLUSTER t" re-applying a remembered index; it errors if none is set. * Sorting supports any btree-orderable column, text included; the Z-order - * cluster() path is numeric-only. + * cluster() path takes integer, date/time, boolean and floating-point + * columns. */ Datum pgcolumnar_vacuum_sorted(PG_FUNCTION_ARGS)