From c44c01b6192a062a362d4f39b2a384fcec752b71 Mon Sep 17 00:00:00 2001 From: ConductAI Bot Date: Sat, 13 Jun 2026 12:14:21 +0000 Subject: [PATCH] docs(lakeformation): document TIMESTAMP limitation in data-cells-filter row filter TIMESTAMP data type columns are not supported in the RowFilter.FilterExpression predicate when creating LakeFormation Data Cells Filters. This commit adds a clearly visible note/warning in the create-data-cells-filter examples RST file documenting the limitation and available workarounds. Closes #10397 --- .../create-data-cells-filter.rst | 33 +++++++++++++++++++ 1 file changed, 33 insertions(+) diff --git a/awscli/examples/lakeformation/create-data-cells-filter.rst b/awscli/examples/lakeformation/create-data-cells-filter.rst index 5207f41e9bc5..125c2020ae8d 100644 --- a/awscli/examples/lakeformation/create-data-cells-filter.rst +++ b/awscli/examples/lakeformation/create-data-cells-filter.rst @@ -77,3 +77,36 @@ Contents of ``input.json``:: This command produces no output. For more information, see `Data filtering and cell-level security in Lake Formation `__ in the *AWS Lake Formation Developer Guide*. + +.. note:: + + **TIMESTAMP data type not supported in RowFilter FilterExpression** + + AWS Lake Formation Data Cells Filters do **not** support ``TIMESTAMP`` columns + in the ``RowFilter.FilterExpression`` predicate. Attempting to use a timestamp + column in the filter expression (e.g. + ``"timestamp" > '2026-05-01 00:00:00'``) will return:: + + InvalidInputException: TIMESTAMP data type not supported for row level filter predicate. + + **Tested expressions that all fail:** + + - ``"timestamp" > '2026-05-01 00:00:00'`` + - ``timestamp > date_sub(current_date(), 30)`` + - ``timestamp > cast(now() - interval 30 days as timestamp)`` + - ``timestamp >= current_timestamp - interval '30' day`` + - ``timestamp >= current_date() - INTERVAL 30 DAYS`` + + **Workarounds:** + + - Filter on a *derived string column* (e.g., a partition column formatted as + ``YYYY-MM-DD``) using string comparison instead of a native timestamp column. + - Pre-process the table to store the date portion as a ``STRING`` or ``DATE`` + column and apply the row filter on that column. + - Use column-level security (``ColumnNames`` / ``ExcludedColumnNames``) to + restrict access to the timestamp column entirely rather than filtering by + value. + + For more information see the + `Data Cells Filters documentation `__. +