tiledbsoma.SOMATileDBContext.replace

SOMATileDBContext.replace(*, tiledb_config: dict[str, str | float | None] | None = None, tiledb_ctx: Any | None = None, timestamp: int | datetime | Literal['__unset__'] | None = '__unset__', threadpool: ThreadPoolExecutor | Literal['__unset__'] | None = '__unset__') → Self

Create a copy of the context, merging changes.

Parameters:

  • tiledb_config – A dictionary of parameters representing tiledb.Config(). To remove a parameter from the existing config, provide None as the value.

  • tiledb_ctx – A TileDB Context to pull the configuration options from.

  • timestamp – A timestamp to replace the current timestamp with. Explicitly passing None will remove the timestamp. For details, see the description of timestamp in __init__().

  • threadpool – A threadpool to replace the current threadpool with.

Lifecycle

Maturing.

Examples

>>> context.replace(timestamp=1_512_658_800_000)  # UNIX millis
>>> new_region_context = context.replace(
...     tiledb_config={"vfs.s3.region": "us-east-2"})
>>> back_to_default_context = new_region_context.replace(
...     tiledb_config={"vfs.s3.region": None})