---
name: "UR::Context::AutoUnloadPool"
section: "3pm"
platform: "linux"
package: "libur-perl"
version: "0.470+ds-3"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/UR::Context::AutoUnloadPool"
---

# UR::Context::AutoUnloadPool(3pm)

Automatically unload objects when scope ends

## NAME

UR::Context::AutoUnloadPool - Automatically unload objects when scope ends

## SYNOPSIS

```
  my $not_unloaded = Some::Class->get(...);
  do {
    my $guard = UR::Context::AutoUnloadPool->create();
    my $object = Some::Class->get(...);  # load an object from the database
    ...                                  # load more things
  };  # $guard goes out of scope - unloads objects
```

## DESCRIPTION

UR Objects retrieved from the database normally live in the object cache for the life of the program.  When a UR::Context::AutoUnloadPool is instantiated, it tracks every object loaded during its life.  The Pool's destructor calls **unload()** on those objects.

Changed objects and objects loaded before before the Pool is created will not get unloaded.

## METHODS

- create

  ```
    my $guard = UR::Context::AutoUnloadPool->create();
  ```

  Creates a Pool object.  All UR Objects loaded from the database during this object's lifetime will get unloaded when the Pool goes out of scope.

- delete

  ```
    $guard->delete();
  ```

  Invalidates the Pool object.  No objects are unloaded.  When the Pool later goes out of scope, no objects will be unloaded.

## SEE ALSO

UR::Object, UR::Context