> For the complete documentation index, see [llms.txt](https://docs.telm.ai/telmai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.telm.ai/telmai/connect-to-data/configuring-a-data-source.md).

# Asset Settings

Change where an asset's data comes from, how each scan reads it, and how its records are identified.

Each asset has a **Settings** tab where you choose what Telmai scans and how. Open the asset from **Assets** and click **Settings**.

<figure><img src="https://604868671-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkO3-a8YVu1iq1jP__S%2Fuploads%2Fgit-blob-56eec6a054b865e9c122a483be424f97f6aa6485%2Fasset-settings-2026-11-04.png?alt=media" alt="The asset Settings tab with the Source, Scanning and Records sections"><figcaption><p>The Settings tab of an asset.</p></figcaption></figure>

The tab has four sections, **Details**, **Source**, **Scanning** and **Records**, plus **Delete asset** at the bottom. When you change a setting, a bar appears with **Save**. If you leave the tab with unsaved changes, Telmai asks before discarding them.

## Details

The **Asset name** and **Description**.

## Source

Where the asset's data comes from.

* **Connection and path** — the connection the asset uses and where its data lives: a table, a query, or a file path. Click **Change** to point the asset somewhere else.

## Scanning

When the asset is scanned, what each scan reads, and what it keeps.

### Schedule

How often the asset is scanned. Click **Set schedule** (or **Change**) to choose. See [Triggering Scans](https://docs.telm.ai/telmai/connect-to-data/triggering-scans.md#scheduling-scans).

### Each scan reads

| Option           | What it does                                              |
| ---------------- | --------------------------------------------------------- |
| All records      | Reads every row on each scan.                             |
| New records only | Reads only the rows added since the last successful scan. |

For tables and queries, **New records only** needs a timestamp attribute, set under [Records](#records), to find the new rows. For files and Databricks Delta, Telmai detects new data on its own.

### Scan depth

Only shown for database assets that are not part of a group.

| Option            | What it does                                                                                                                                                        |
| ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Data and metadata | Reads the rows and the schema.                                                                                                                                      |
| Metadata only     | Reads the schema, the record count, each attribute's completeness and the table's freshness with queries in your database, without loading the records into Telmai. |

{% hint style="warning" %}
**Metadata only** doesn't load records into Telmai. ID attributes are ignored, **Row quality check** and **Custom metric (Expression)** monitors aren't available, Profiling shows no drilldown values, and the **Historical scan** and **Single scan** options are unavailable.
{% endhint %}

### Rows to scan <a href="#filter-attribute" id="filter-attribute"></a>

By default each scan reads **All rows**. To monitor only a subset, click **Add filter**, then choose an attribute and the values to keep. Telmai scans only the rows whose attribute matches one of those values.

Filters aren't available for assets defined by a custom query. Put the filter in the query instead.

### Sample data

| Option                    | What it does                                                                                 |
| ------------------------- | -------------------------------------------------------------------------------------------- |
| Save sample records       | Keeps sample records from each scan, so people can drill down to the records behind a value. |
| Don't save sample records | Profiling shows no drilldown values for this asset.                                          |

Sample data is locked when the asset is set to scan **Metadata only**, because a metadata-only scan doesn't load records, and on hybrid deployments, where raw values stay in your environment.

New assets save sample records by default. A tenant admin can change the default in **Administration** > **Application settings**. See [Administration](https://docs.telm.ai/telmai/administration.md#application-settings).

## Records

How records are identified and ordered.

### ID attributes <a href="#id-attribute" id="id-attribute"></a>

The attributes that identify each record. ID attributes are optional, but they let Telmai:

* track the uniqueness of records,
* show the IDs of records with anomalous values, and of rows that fail row checks, and
* split good records from bad ones with [data binning](https://docs.telm.ai/telmai/remediation/data-binning.md).

When you choose more than one attribute, Telmai builds each record's ID by joining their values.

### Timestamp attribute <a href="#timestamp-attribute" id="timestamp-attribute"></a>

The attribute that orders records over time, used for freshness, trends, **New records only** scans, and the **Historical scan** and **Single scan** options. Telmai suggests likely candidates.

Not shown for files in cloud storage.

## Delete asset

**Delete asset** deletes the asset and its settings. This can't be undone.
