Skip to content
Draft
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
33 changes: 33 additions & 0 deletions awscli/examples/lakeformation/create-data-cells-filter.rst
Original file line number Diff line number Diff line change
Expand Up @@ -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 <https://docs.aws.amazon.com/lake-formation/latest/dg/data-filtering.html>`__ 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 <https://docs.aws.amazon.com/lake-formation/latest/dg/data-filtering.html>`__.