From fe2cceb15096bf3ff0e936fdf06e711b307c3fe7 Mon Sep 17 00:00:00 2001 From: Sreesh Maheshwar Date: Tue, 20 Oct 2026 13:34:41 +0100 Subject: [PATCH] docs: document Table thread safety Co-Authored-By: Claude Opus 5.5 --- src/iceberg/table.h | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/src/iceberg/table.h b/src/iceberg/table.h index 50e6aa8fd..3a5f07047 100644 --- a/src/iceberg/table.h +++ b/src/iceberg/table.h @@ -39,6 +39,9 @@ namespace iceberg { /// \brief Represents an Iceberg table +/// +/// Safe to read from several threads, but not while one of them commits through it +/// or calls Refresh(). class ICEBERG_EXPORT Table : public std::enable_shared_from_this { public: /// \brief Construct a table. @@ -143,6 +146,9 @@ class ICEBERG_EXPORT Table : public std::enable_shared_from_this
{ Result> location_provider() const; /// \brief Refresh the current table metadata + /// + /// Invalidates references returned by accessors such as properties(). Commits made + /// through this table call it when they retry. virtual Status Refresh(); /// \brief Create a new table scan builder for this table