> ## Documentation Index
> Fetch the complete documentation index at: https://docs.omni.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Offloading schemas

> Improve model performance by deferring the load of large or infrequently used schemas – like dbt virtual schemas – until they’re needed.

When your data model includes many schemas – or a few very large ones – it can slow down performance. Offloading, or *lazy loading*, helps by deferring the loading of schema metadata until you need it.

This approach is especially useful when working with dbt virtual schemas or other large, infrequently accessed schemas. Offloading keeps your model lean and responsive while still allowing full access to schema metadata on demand.

<Note>
  While offloaded schemas won't be visible in the model IDE or workbook, they're still easily accessible. Refer to the [Accessing offloaded schemas](#accessing-offloaded-schemas-in-workbooks) section for more information.
</Note>

## Specifying offloaded schemas

<Note>
  **Connection Admin** permissions are required to modify connection settings.
</Note>

<Steps>
  <Step title="Open the connection details">
    1. Navigate to **Settings > Connections**.
    2. Click a connection.
    3. Locate the **Offloaded schemas** setting in the connection settings.
  </Step>

  <Step title="Add the schemas">
    In the **Offloaded schemas** setting, use a **comma-separated list** to add the names of the schemas you want to offload. The values in this field:

    * **Can use wildcard syntax**, for example `dbt_*`.
    * **Are case-sensitive**, meaning the schema name you enter must exactly match the name of the schema in the database. For example, `blob_schema` must match a `blob_schema` in the database.

    <Tip>
      If the schema is in a database other than the connection default, you need to:

      1. **Include the database in the connection's Other databases setting**. This name varies by database type. For example, this setting is named **Include Other Data Catalogs** for an Amazon Athena connection.
      2. **Specify the database when adding the schema to Offloaded Schemas**. For example, `NON_DEFAULT_DATABASE.OFFLOADED_SCHEMA`.
    </Tip>
  </Step>

  <Step title="Save & apply the changes">
    1. When finished, click **Update and Test connection**.
    2. Trigger a [**schema refresh**](/modeling/develop/schema-refreshes) to apply the changes to your Omni model.
  </Step>

  <Step title="Confirm the changes">
    While the changes may not be visible in the connection's shared models, you can verify that the application was successful using the model IDE:

    1. Click **Develop** in the left navigation panel.

    2. Click one of the connection's models to open it in the model IDE.

    3. In the **Shared** layer of the model, click the link next to **Parent** at the bottom of the page. This opens the schema model.

           <img src="https://mintcdn.com/omni-e7402367/XZwrvFN-b2pRXANo/connect-data/images/model-ide-parent.png?fit=max&auto=format&n=XZwrvFN-b2pRXANo&q=85&s=f790e1e0c33b8e6ad488b64813807bcd" alt="Highlighted Parent section in the model IDE" width="1080" height="633" data-path="connect-data/images/model-ide-parent.png" />

    4. In this view, change the **Browse mode** to **Model** by using the dropdown near the top left corner of the page:

           <img src="https://mintcdn.com/omni-e7402367/XZwrvFN-b2pRXANo/connect-data/images/model-ide-browse-mode.png?fit=max&auto=format&n=XZwrvFN-b2pRXANo&q=85&s=399e95e5d2295fbdfa40e0160147332a" alt="Browse selector in the model IDE, set to Model" width="1078" height="631" data-path="connect-data/images/model-ide-browse-mode.png" />

    5. The offloaded schemas should **not** be visible in the **Schemas** section.
  </Step>
</Steps>

## Accessing offloaded schemas in workbooks

Once set up successfully, offloaded schemas will not display in the **All Views & Fields** view of the workbook's field browser, but you can still access them when needed.

To access offloaded schemas in the workbook, click the **Schema** button in the **All views & fields** view. For example, we offloaded the `offloaded_schema`, which is visible in the **Schema** dropdown:

<img src="https://mintcdn.com/omni-e7402367/XZwrvFN-b2pRXANo/connect-data/images/schema-picker-offloaded-schema.png?fit=max&auto=format&n=XZwrvFN-b2pRXANo&q=85&s=bdc43d4138f4b31c44c6cf9d9829c9f7" alt="Workbook schema picker showing included and offloaded schemas" width="450" height="327" data-path="connect-data/images/schema-picker-offloaded-schema.png" />

Select the schema, at which point Omni will activate and load it.
