pixeltable 0.3.15__py3-none-any.whl → 0.4.0rc1__py3-none-any.whl

pixeltable/catalog/table.py

@@ -4,11 +4,11 @@ import abc
 import builtins
 import json
 import logging
+from keyword import iskeyword as is_python_keyword
 from pathlib import Path
 from typing import TYPE_CHECKING, Any, Iterable, Literal, Optional, Union, overload
 
 from typing import _GenericAlias  # type: ignore[attr-defined]  # isort: skip
-from keyword import iskeyword as is_python_keyword
 from uuid import UUID
 
 import pandas as pd
@@ -16,7 +16,6 @@ import sqlalchemy as sql
 
 import pixeltable as pxt
 from pixeltable import catalog, env, exceptions as excs, exprs, index, type_system as ts
-from pixeltable.env import Env
 from pixeltable.metadata import schema
 
 from ..exprs import ColumnRef
@@ -62,11 +61,6 @@ class Table(SchemaObject):
         self._is_dropped = False
         self.__tbl_version_path = tbl_version_path
 
-    # @property
-    # def _has_dependents(self) -> bool:
-    #     """Returns True if this table has any dependent views, or snapshots."""
-    #     return len(self._get_views(recursive=False)) > 0
-
     def _move(self, new_name: str, new_dir_id: UUID) -> None:
         self._check_is_dropped()
         super()._move(new_name, new_dir_id)
@@ -106,10 +100,12 @@ class Table(SchemaObject):
                 }
                 ```
         """
-        self._check_is_dropped()
-        with env.Env.get().begin_xact():
+        from pixeltable.catalog import Catalog
+
+        with Catalog.get().begin_xact(for_write=False):
+            self._check_is_dropped()
             md = super().get_metadata()
-            md['base'] = self._base_table._path if self._base_table is not None else None
+            md['base'] = self._base_table._path() if self._base_table is not None else None
             md['schema'] = self._schema
             md['is_replica'] = self._tbl_version.get().is_replica
             md['version'] = self._version
@@ -163,9 +159,11 @@ class Table(SchemaObject):
         Returns:
             A list of view paths.
         """
-        self._check_is_dropped()
-        with env.Env.get().begin_xact():
-            return [t._path for t in self._get_views(recursive=recursive)]
+        from pixeltable.catalog import Catalog
+
+        with Catalog.get().begin_xact(for_write=False):
+            self._check_is_dropped()
+            return [t._path() for t in self._get_views(recursive=recursive)]
 
     def _get_views(self, *, recursive: bool = True) -> list['Table']:
         cat = catalog.Catalog.get()
@@ -187,14 +185,20 @@ class Table(SchemaObject):
 
         See [`DataFrame.select`][pixeltable.DataFrame.select] for more details.
         """
-        return self._df().select(*items, **named_items)
+        from pixeltable.catalog import Catalog
+
+        with Catalog.get().begin_xact(for_write=False):
+            return self._df().select(*items, **named_items)
 
     def where(self, pred: 'exprs.Expr') -> 'pxt.DataFrame':
         """Filter rows from this table based on the expression.
 
         See [`DataFrame.where`][pixeltable.DataFrame.where] for more details.
         """
-        return self._df().where(pred)
+        from pixeltable.catalog import Catalog
+
+        with Catalog.get().begin_xact(for_write=False):
+            return self._df().where(pred)
 
     def join(
         self,
@@ -204,21 +208,30 @@ class Table(SchemaObject):
         how: 'pixeltable.plan.JoinType.LiteralType' = 'inner',
     ) -> 'pxt.DataFrame':
         """Join this table with another table."""
-        return self._df().join(other, on=on, how=how)
+        from pixeltable.catalog import Catalog
+
+        with Catalog.get().begin_xact(for_write=False):
+            return self._df().join(other, on=on, how=how)
 
     def order_by(self, *items: 'exprs.Expr', asc: bool = True) -> 'pxt.DataFrame':
         """Order the rows of this table based on the expression.
 
         See [`DataFrame.order_by`][pixeltable.DataFrame.order_by] for more details.
         """
-        return self._df().order_by(*items, asc=asc)
+        from pixeltable.catalog import Catalog
+
+        with Catalog.get().begin_xact(for_write=False):
+            return self._df().order_by(*items, asc=asc)
 
     def group_by(self, *items: 'exprs.Expr') -> 'pxt.DataFrame':
         """Group the rows of this table based on the expression.
 
         See [`DataFrame.group_by`][pixeltable.DataFrame.group_by] for more details.
         """
-        return self._df().group_by(*items)
+        from pixeltable.catalog import Catalog
+
+        with Catalog.get().begin_xact(for_write=False):
+            return self._df().group_by(*items)
 
     def distinct(self) -> 'pxt.DataFrame':
         """Remove duplicate rows from table."""
@@ -305,18 +318,21 @@ class Table(SchemaObject):
         """
         Constructs a list of descriptors for this table that can be pretty-printed.
         """
-        helper = DescriptionHelper()
-        helper.append(self._table_descriptor())
-        helper.append(self._col_descriptor())
-        idxs = self._index_descriptor()
-        if not idxs.empty:
-            helper.append(idxs)
-        stores = self._external_store_descriptor()
-        if not stores.empty:
-            helper.append(stores)
-        if self._comment:
-            helper.append(f'COMMENT: {self._comment}')
-        return helper
+        from pixeltable.catalog import Catalog
+
+        with Catalog.get().begin_xact(for_write=False):
+            helper = DescriptionHelper()
+            helper.append(self._table_descriptor())
+            helper.append(self._col_descriptor())
+            idxs = self._index_descriptor()
+            if not idxs.empty:
+                helper.append(idxs)
+            stores = self._external_store_descriptor()
+            if not stores.empty:
+                helper.append(stores)
+            if self._comment:
+                helper.append(f'COMMENT: {self._comment}')
+            return helper
 
     def _col_descriptor(self, columns: Optional[list[str]] = None) -> pd.DataFrame:
         return pd.DataFrame(
@@ -473,15 +489,17 @@ class Table(SchemaObject):
             ... }
             ... tbl.add_columns(schema)
         """
-        self._check_is_dropped()
-        if self.get_metadata()['is_snapshot']:
-            raise excs.Error('Cannot add column to a snapshot.')
-        col_schema = {
-            col_name: {'type': ts.ColumnType.normalize_type(spec, nullable_default=True, allow_builtin_types=False)}
-            for col_name, spec in schema.items()
-        }
-
-        with Env.get().begin_xact():
+        from pixeltable.catalog import Catalog
+
+        with Catalog.get().begin_xact(tbl_id=self._id, for_write=True):
+            self._check_is_dropped()
+            if self.get_metadata()['is_snapshot']:
+                raise excs.Error('Cannot add column to a snapshot.')
+            col_schema = {
+                col_name: {'type': ts.ColumnType.normalize_type(spec, nullable_default=True, allow_builtin_types=False)}
+                for col_name, spec in schema.items()
+            }
+
             # handle existing columns based on if_exists parameter
             cols_to_ignore = self._ignore_or_drop_existing_columns(
                 list(col_schema.keys()), IfExistsParam.validated(if_exists, 'if_exists')
@@ -534,22 +552,25 @@ class Table(SchemaObject):
 
             >>> tbl.add_columns({'new_col': pxt.Int})
         """
-        self._check_is_dropped()
-        # verify kwargs
-        if self._tbl_version.get().is_snapshot:
-            raise excs.Error('Cannot add column to a snapshot.')
-        # verify kwargs and construct column schema dict
-        if len(kwargs) != 1:
-            raise excs.Error(
-                f'add_column() requires exactly one keyword argument of the form "col_name=col_type"; '
-                f'got {len(kwargs)} instead ({", ".join(kwargs.keys())})'
-            )
-        col_type = next(iter(kwargs.values()))
-        if not isinstance(col_type, (ts.ColumnType, type, _GenericAlias)):
-            raise excs.Error(
-                'The argument to add_column() must be a type; did you intend to use add_computed_column() instead?'
-            )
-        return self.add_columns(kwargs, if_exists=if_exists)
+        from pixeltable.catalog import Catalog
+
+        with Catalog.get().begin_xact(tbl_id=self._id, for_write=True):
+            self._check_is_dropped()
+            # verify kwargs
+            if self._tbl_version.get().is_snapshot:
+                raise excs.Error('Cannot add column to a snapshot.')
+            # verify kwargs and construct column schema dict
+            if len(kwargs) != 1:
+                raise excs.Error(
+                    f'add_column() requires exactly one keyword argument of the form "col_name=col_type"; '
+                    f'got {len(kwargs)} instead ({", ".join(kwargs.keys())})'
+                )
+            col_type = next(iter(kwargs.values()))
+            if not isinstance(col_type, (ts.ColumnType, type, _GenericAlias)):
+                raise excs.Error(
+                    'The argument to add_column() must be a type; did you intend to use add_computed_column() instead?'
+                )
+            return self.add_columns(kwargs, if_exists=if_exists)
 
     def add_computed_column(
         self,
@@ -598,33 +619,35 @@ class Table(SchemaObject):
 
             >>> tbl.add_computed_column(rotated=tbl.frame.rotate(90), stored=False)
         """
-        self._check_is_dropped()
-        if self.get_metadata()['is_snapshot']:
-            raise excs.Error('Cannot add column to a snapshot.')
-        if len(kwargs) != 1:
-            raise excs.Error(
-                f'add_computed_column() requires exactly one keyword argument of the form '
-                '"column-name=type|value-expression"; '
-                f'got {len(kwargs)} arguments instead ({", ".join(list(kwargs.keys()))})'
-            )
-        col_name, spec = next(iter(kwargs.items()))
-        if not is_valid_identifier(col_name):
-            raise excs.Error(f'Invalid column name: {col_name!r}')
-
-        col_schema: dict[str, Any] = {'value': spec}
-        if stored is not None:
-            col_schema['stored'] = stored
-
-        # Raise an error if the column expression refers to a column error property
-        if isinstance(spec, exprs.Expr):
-            for e in spec.subexprs(expr_class=exprs.ColumnPropertyRef, traverse_matches=False):
-                if e.is_error_prop():
-                    raise excs.Error(
-                        'Use of a reference to an error property of another column is not allowed in a computed '
-                        f'column. The specified computation for this column contains this reference: `{e!r}`'
-                    )
+        from pixeltable.catalog import Catalog
+
+        with Catalog.get().begin_xact(tbl_id=self._id, for_write=True):
+            self._check_is_dropped()
+            if self.get_metadata()['is_snapshot']:
+                raise excs.Error('Cannot add column to a snapshot.')
+            if len(kwargs) != 1:
+                raise excs.Error(
+                    f'add_computed_column() requires exactly one keyword argument of the form '
+                    '"column-name=type|value-expression"; '
+                    f'got {len(kwargs)} arguments instead ({", ".join(list(kwargs.keys()))})'
+                )
+            col_name, spec = next(iter(kwargs.items()))
+            if not is_valid_identifier(col_name):
+                raise excs.Error(f'Invalid column name: {col_name!r}')
+
+            col_schema: dict[str, Any] = {'value': spec}
+            if stored is not None:
+                col_schema['stored'] = stored
+
+            # Raise an error if the column expression refers to a column error property
+            if isinstance(spec, exprs.Expr):
+                for e in spec.subexprs(expr_class=exprs.ColumnPropertyRef, traverse_matches=False):
+                    if e.is_error_prop():
+                        raise excs.Error(
+                            'Use of a reference to an error property of another column is not allowed in a computed '
+                            f'column. The specified computation for this column contains this reference: `{e!r}`'
+                        )
 
-        with Env.get().begin_xact():
             # handle existing columns based on if_exists parameter
             cols_to_ignore = self._ignore_or_drop_existing_columns(
                 [col_name], IfExistsParam.validated(if_exists, 'if_exists')
@@ -781,36 +804,39 @@ class Table(SchemaObject):
             >>> tbl = pxt.get_table('my_table')
             ... tbl.drop_col(tbl.col, if_not_exists='ignore')
         """
-        self._check_is_dropped()
-        if self._tbl_version_path.is_snapshot():
-            raise excs.Error('Cannot drop column from a snapshot.')
-        col: Column = None
-        if_not_exists_ = IfNotExistsParam.validated(if_not_exists, 'if_not_exists')
-        if isinstance(column, str):
-            col = self._tbl_version_path.get_column(column, include_bases=False)
-            if col is None:
-                if if_not_exists_ == IfNotExistsParam.ERROR:
-                    raise excs.Error(f'Column {column!r} unknown')
-                assert if_not_exists_ == IfNotExistsParam.IGNORE
-                return
-            col = self._tbl_version.get().cols_by_name[column]
-        else:
-            exists = self._tbl_version_path.has_column(column.col, include_bases=False)
-            if not exists:
-                if if_not_exists_ == IfNotExistsParam.ERROR:
-                    raise excs.Error(f'Unknown column: {column.col.qualified_name}')
-                assert if_not_exists_ == IfNotExistsParam.IGNORE
-                return
-            col = column.col
+        from pixeltable.catalog import Catalog
 
-        dependent_user_cols = [c for c in col.dependent_cols if c.name is not None]
-        if len(dependent_user_cols) > 0:
-            raise excs.Error(
-                f'Cannot drop column `{col.name}` because the following columns depend on it:\n'
-                f'{", ".join(c.name for c in dependent_user_cols)}'
-            )
+        with Catalog.get().begin_xact(tbl_id=self._id, for_write=True):
+            self._check_is_dropped()
+            if self._tbl_version_path.is_snapshot():
+                raise excs.Error('Cannot drop column from a snapshot.')
+            col: Column = None
+            if_not_exists_ = IfNotExistsParam.validated(if_not_exists, 'if_not_exists')
+
+            if isinstance(column, str):
+                col = self._tbl_version_path.get_column(column, include_bases=False)
+                if col is None:
+                    if if_not_exists_ == IfNotExistsParam.ERROR:
+                        raise excs.Error(f'Column {column!r} unknown')
+                    assert if_not_exists_ == IfNotExistsParam.IGNORE
+                    return
+                col = self._tbl_version.get().cols_by_name[column]
+            else:
+                exists = self._tbl_version_path.has_column(column.col, include_bases=False)
+                if not exists:
+                    if if_not_exists_ == IfNotExistsParam.ERROR:
+                        raise excs.Error(f'Unknown column: {column.col.qualified_name}')
+                    assert if_not_exists_ == IfNotExistsParam.IGNORE
+                    return
+                col = column.col
+
+            dependent_user_cols = [c for c in col.dependent_cols if c.name is not None]
+            if len(dependent_user_cols) > 0:
+                raise excs.Error(
+                    f'Cannot drop column `{col.name}` because the following columns depend on it:\n'
+                    f'{", ".join(c.name for c in dependent_user_cols)}'
+                )
 
-        with Env.get().begin_xact():
             # See if this column has a dependent store. We need to look through all stores in all
             # (transitive) views of this table.
             dependent_stores = [
@@ -847,7 +873,9 @@ class Table(SchemaObject):
             >>> tbl = pxt.get_table('my_table')
             ... tbl.rename_column('col1', 'col2')
         """
-        with Env.get().begin_xact():
+        from pixeltable.catalog import Catalog
+
+        with Catalog.get().begin_xact(tbl_id=self._id, for_write=True):
             self._tbl_version.get().rename_column(old_name, new_name)
 
     def _list_index_info_for_test(self) -> list[dict[str, Any]]:
@@ -955,11 +983,13 @@ class Table(SchemaObject):
             ...     image_embed=image_embedding_fn
             ... )
         """
-        if self._tbl_version_path.is_snapshot():
-            raise excs.Error('Cannot add an index to a snapshot')
-        col = self._resolve_column_parameter(column)
+        from pixeltable.catalog import Catalog
+
+        with Catalog.get().begin_xact(tbl_id=self._id, for_write=True):
+            if self._tbl_version_path.is_snapshot():
+                raise excs.Error('Cannot add an index to a snapshot')
+            col = self._resolve_column_parameter(column)
 
-        with Env.get().begin_xact():
             if idx_name is not None and idx_name in self._tbl_version.get().idxs_by_name:
                 if_exists_ = IfExistsParam.validated(if_exists, 'if_exists')
                 # An index with the same name already exists.
@@ -1039,15 +1069,17 @@ class Table(SchemaObject):
             >>> tbl = pxt.get_table('my_table')
             ... tbl.drop_embedding_index(idx_name='idx1', if_not_exists='ignore')
         """
+        from pixeltable.catalog import Catalog
+
         if (column is None) == (idx_name is None):
             raise excs.Error("Exactly one of 'column' or 'idx_name' must be provided")
 
-        col: Column = None
-        if idx_name is None:
-            col = self._resolve_column_parameter(column)
-            assert col is not None
+        with Catalog.get().begin_xact(tbl_id=self._id, for_write=True):
+            col: Column = None
+            if idx_name is None:
+                col = self._resolve_column_parameter(column)
+                assert col is not None
 
-        with Env.get().begin_xact():
             self._drop_index(col=col, idx_name=idx_name, _idx_class=index.EmbeddingIndex, if_not_exists=if_not_exists)
 
     def _resolve_column_parameter(self, column: Union[str, ColumnRef]) -> Column:
@@ -1116,15 +1148,17 @@ class Table(SchemaObject):
             ... tbl.drop_index(idx_name='idx1', if_not_exists='ignore')
 
         """
+        from pixeltable.catalog import Catalog
+
         if (column is None) == (idx_name is None):
             raise excs.Error("Exactly one of 'column' or 'idx_name' must be provided")
 
-        col: Column = None
-        if idx_name is None:
-            col = self._resolve_column_parameter(column)
-            assert col is not None
+        with Catalog.get().begin_xact(tbl_id=self._id, for_write=True):
+            col: Column = None
+            if idx_name is None:
+                col = self._resolve_column_parameter(column)
+                assert col is not None
 
-        with Env.get().begin_xact():
             self._drop_index(col=col, idx_name=idx_name, if_not_exists=if_not_exists)
 
     def _drop_index(
@@ -1150,7 +1184,7 @@ class Table(SchemaObject):
         else:
             if col.tbl.id != self._tbl_version.id:
                 raise excs.Error(
-                    f'Column {col.name!r}: cannot drop index from column that belongs to base ({col.tbl.get().name}!r)'
+                    f'Column {col.name!r}: cannot drop index from column that belongs to base ({col.tbl.name!r})'
                 )
             idx_info_list = [info for info in self._tbl_version.get().idxs_by_name.values() if info.col.id == col.id]
             if _idx_class is not None:
@@ -1299,7 +1333,9 @@ class Table(SchemaObject):
 
             >>> tbl.update({'int_col': tbl.int_col + 1}, where=tbl.int_col == 0)
         """
-        with Env.get().begin_xact():
+        from pixeltable.catalog import Catalog
+
+        with Catalog.get().begin_xact(tbl_id=self._id, for_write=True):
             status = self._tbl_version.get().update(value_spec, where, cascade)
             FileCache.get().emit_eviction_warnings()
             return status
@@ -1335,35 +1371,37 @@ class Table(SchemaObject):
                 [{'id': 1, 'name': 'Alice', 'age': 30}, {'id': 3, 'name': 'Bob', 'age': 40}],
                 if_not_exists='insert')
         """
-        if self._tbl_version_path.is_snapshot():
-            raise excs.Error('Cannot update a snapshot')
-        rows = list(rows)
+        from pixeltable.catalog import Catalog
 
-        row_updates: list[dict[Column, exprs.Expr]] = []
-        pk_col_names = {c.name for c in self._tbl_version.get().primary_key_columns()}
+        with Catalog.get().begin_xact(tbl_id=self._id, for_write=True):
+            if self._tbl_version_path.is_snapshot():
+                raise excs.Error('Cannot update a snapshot')
+            rows = list(rows)
 
-        # pseudo-column _rowid: contains the rowid of the row to update and can be used instead of the primary key
-        has_rowid = _ROWID_COLUMN_NAME in rows[0]
-        rowids: list[tuple[int, ...]] = []
-        if len(pk_col_names) == 0 and not has_rowid:
-            raise excs.Error('Table must have primary key for batch update')
+            row_updates: list[dict[Column, exprs.Expr]] = []
+            pk_col_names = {c.name for c in self._tbl_version.get().primary_key_columns()}
 
-        for row_spec in rows:
-            col_vals = self._tbl_version.get()._validate_update_spec(
-                row_spec, allow_pk=not has_rowid, allow_exprs=False, allow_media=False
-            )
-            if has_rowid:
-                # we expect the _rowid column to be present for each row
-                assert _ROWID_COLUMN_NAME in row_spec
-                rowids.append(row_spec[_ROWID_COLUMN_NAME])
-            else:
-                col_names = {col.name for col in col_vals}
-                if any(pk_col_name not in col_names for pk_col_name in pk_col_names):
-                    missing_cols = pk_col_names - {col.name for col in col_vals}
-                    raise excs.Error(f'Primary key columns ({", ".join(missing_cols)}) missing in {row_spec}')
-            row_updates.append(col_vals)
+            # pseudo-column _rowid: contains the rowid of the row to update and can be used instead of the primary key
+            has_rowid = _ROWID_COLUMN_NAME in rows[0]
+            rowids: list[tuple[int, ...]] = []
+            if len(pk_col_names) == 0 and not has_rowid:
+                raise excs.Error('Table must have primary key for batch update')
+
+            for row_spec in rows:
+                col_vals = self._tbl_version.get()._validate_update_spec(
+                    row_spec, allow_pk=not has_rowid, allow_exprs=False, allow_media=False
+                )
+                if has_rowid:
+                    # we expect the _rowid column to be present for each row
+                    assert _ROWID_COLUMN_NAME in row_spec
+                    rowids.append(row_spec[_ROWID_COLUMN_NAME])
+                else:
+                    col_names = {col.name for col in col_vals}
+                    if any(pk_col_name not in col_names for pk_col_name in pk_col_names):
+                        missing_cols = pk_col_names - {col.name for col in col_vals}
+                        raise excs.Error(f'Primary key columns ({", ".join(missing_cols)}) missing in {row_spec}')
+                row_updates.append(col_vals)
 
-        with Env.get().begin_xact():
             status = self._tbl_version.get().batch_update(
                 row_updates,
                 rowids,
@@ -1397,10 +1435,14 @@ class Table(SchemaObject):
         .. warning::
             This operation is irreversible.
         """
-        if self._tbl_version_path.is_snapshot():
-            raise excs.Error('Cannot revert a snapshot')
-        with Env.get().begin_xact():
+        from pixeltable.catalog import Catalog
+
+        with Catalog.get().begin_xact(tbl_id=self._id, for_write=True):
+            if self._tbl_version_path.is_snapshot():
+                raise excs.Error('Cannot revert a snapshot')
             self._tbl_version.get().revert()
+            # remove cached md in order to force a reload on the next operation
+            self.__tbl_version_path.clear_cached_md()
 
     @property
     def external_stores(self) -> list[str]:
@@ -1410,12 +1452,16 @@ class Table(SchemaObject):
         """
         Links the specified `ExternalStore` to this table.
         """
-        if self._tbl_version.get().is_snapshot:
-            raise excs.Error(f'Table `{self._name}` is a snapshot, so it cannot be linked to an external store.')
-        if store.name in self.external_stores:
-            raise excs.Error(f'Table `{self._name}` already has an external store with that name: {store.name}')
-        _logger.info(f'Linking external store `{store.name}` to table `{self._name}`')
-        with Env.get().begin_xact():
+        from pixeltable.catalog import Catalog
+
+        with Catalog.get().begin_xact(tbl_id=self._id, for_write=True):
+            if self._tbl_version.get().is_snapshot:
+                raise excs.Error(f'Table `{self._name}` is a snapshot, so it cannot be linked to an external store.')
+            if store.name in self.external_stores:
+                raise excs.Error(f'Table `{self._name}` already has an external store with that name: {store.name}')
+            _logger.info(f'Linking external store `{store.name}` to table `{self._name}`')
+
+            store.link(self._tbl_version.get())  # might call tbl_version.add_columns()
             self._tbl_version.get().link_external_store(store)
             env.Env.get().console_logger.info(f'Linked external store `{store.name}` to table `{self._name}`.')
 
@@ -1437,24 +1483,32 @@ class Table(SchemaObject):
             delete_external_data (bool): If `True`, then the external data store will also be deleted. WARNING: This
                 is a destructive operation that will delete data outside Pixeltable, and cannot be undone.
         """
-        self._check_is_dropped()
-        all_stores = self.external_stores
-
-        if stores is None:
-            stores = all_stores
-        elif isinstance(stores, str):
-            stores = [stores]
-
-        # Validation
-        if not ignore_errors:
-            for store in stores:
-                if store not in all_stores:
-                    raise excs.Error(f'Table `{self._name}` has no external store with that name: {store}')
-
-        with Env.get().begin_xact():
-            for store in stores:
-                self._tbl_version.get().unlink_external_store(store, delete_external_data=delete_external_data)
-                env.Env.get().console_logger.info(f'Unlinked external store from table `{self._name}`: {store}')
+        from pixeltable.catalog import Catalog
+
+        with Catalog.get().begin_xact(tbl_id=self._id, for_write=True):
+            self._check_is_dropped()
+            all_stores = self.external_stores
+
+            if stores is None:
+                stores = all_stores
+            elif isinstance(stores, str):
+                stores = [stores]
+
+            # Validation
+            if not ignore_errors:
+                for store_name in stores:
+                    if store_name not in all_stores:
+                        raise excs.Error(f'Table `{self._name}` has no external store with that name: {store_name}')
+
+            for store_name in stores:
+                store = self._tbl_version.get().external_stores[store_name]
+                # get hold of the store's debug string before deleting it
+                store_str = str(store)
+                store.unlink(self._tbl_version.get())  # might call tbl_version.drop_columns()
+                self._tbl_version.get().unlink_external_store(store)
+                if delete_external_data and isinstance(store, pxt.io.external_store.Project):
+                    store.delete()
+                env.Env.get().console_logger.info(f'Unlinked external store from table `{self._name}`: {store_str}')
 
     def sync(
         self, stores: Optional[str | list[str]] = None, *, export_data: bool = True, import_data: bool = True
@@ -1468,20 +1522,22 @@ class Table(SchemaObject):
             export_data: If `True`, data from this table will be exported to the external stores during synchronization.
             import_data: If `True`, data from the external stores will be imported to this table during synchronization.
         """
-        self._check_is_dropped()
-        all_stores = self.external_stores
+        from pixeltable.catalog import Catalog
+
+        with Catalog.get().begin_xact(tbl_id=self._id, for_write=True):
+            self._check_is_dropped()
+            all_stores = self.external_stores
 
-        if stores is None:
-            stores = all_stores
-        elif isinstance(stores, str):
-            stores = [stores]
+            if stores is None:
+                stores = all_stores
+            elif isinstance(stores, str):
+                stores = [stores]
 
-        for store in stores:
-            if store not in all_stores:
-                raise excs.Error(f'Table `{self._name}` has no external store with that name: {store}')
+            for store in stores:
+                if store not in all_stores:
+                    raise excs.Error(f'Table `{self._name}` has no external store with that name: {store}')
 
-        sync_status = pxt.io.SyncStatus.empty()
-        with Env.get().begin_xact():
+            sync_status = pxt.io.SyncStatus.empty()
             for store in stores:
                 store_obj = self._tbl_version.get().external_stores[store]
                 store_sync_status = store_obj.sync(self, export_data=export_data, import_data=import_data)