Skip to main content

Data Sampling

Overview​

Mantra can read distinct values from select columns when generating queries, on an opt-in basis. After opting in, up to 50,000 distinct values are ingested to the Context Hub - improving query accuracy, filter suggestions, and overall answer relevance in Mantra Chat.

This page is accessed through System Management in the Mantra interface.

What Happens After Saving​

Saving column selections allows a scheduled, background data sample crawler to make selected columns' values available to Mantra Chat.

After saving, allow up to 24 hours for the crawler to complete and for the new samples to be reflected in Mantra Chat.

Accessing Data Sampling​

  1. Click the user icon in the bottom-left corner of Mantra
  2. Select System Management
  3. Navigate to the Data Sampling tab

Feature Access​

The manage_data_samples permission is required to manage column opt in. Users with this permission can only select data to which their user has access (see Data Authorization).

Finding Tables​

The page lists all tables accessible to you. Use the controls at the top to narrow the list.

ControlBehavior
SearchSearches table names server-side. Press Enter to trigger.
Data SourceFilters to a specific connected data source.
SchemaFilters to a specific schema.

Tables with unsaved changes are moved to the top of the list so in-progress work stays visible.

Opting in​

Each row shows the table name, schema, data source, and the number of sampled columns. Click any row to expand it and configure that table's column sampling.

Selecting Columns​

Expand the table to view its columns that can be sampled. Use the toggle on each column to opt in or out (default: opt-out).

Notes on eligibility:

  • Columns of type DATE, TIMESTAMP, BOOLEAN, and BIT are not eligible and do not appear in the list.
  • Use the Filter columns input within the expanded row to search columns by name or description before selecting.

Bulk Actions​

  • Select All - Opt in for the full selected table.
  • Deselect All - Opt out for the full selected table.
tip

Changes are saved per table, and unsaved changes are lost if you close the page.