Files
lancedb/docs/web/enterprise/gpu-refresh-execution.mdx
T
Jack YeandClaude Sonnet 5 de95ed3f6d docs: overhaul curation, feature engineering, security and deployment guides (#4748)
A broad documentation pass across the areas LanceDB Enterprise and
Embedded
diverge on most:

**Data Curation** -- GPU Function execution, Slurm scheduling (and what
Slurm is, for readers new to it), blob late materialization as its own
page, joins, aggregation/profiling, sampling, near-duplicate detection,
chunking, distributed shuffle, and IVF-partition clustering.

**Feature Engineering** -- computed columns and materialized views,
restructured to lead with the Function-based path and show the SQL form
side by side with Python throughout; a single Auto Refresh page instead
of
duplicating scheduling details on every refresh page; adaptive
execution;
checkpointing; GPU and Slurm placement for refresh workers; a Training
Cache page for the PyTorch data loader's automatic cache benefit.

**Security & Governance** -- an Audit Log reference (schema, access,
grants), Secrets promoted to an ordinary catalog object with their own
SQL
DDL and a vending/rotation guide, and privilege-table fixes verified
against the authorization source.

**Deployment & Maintenance** -- Horizontal Scaling and OpenTelemetry
moved
into a real Deployment area; Automated Cleanup folded into Intelligent
Auto-Maintenance (every other maintenance decision already lived there);
RTE Compaction and Advanced Conflict Resolution documented in depth.

**Landing page** -- the Enterprise feature comparison table reorganized
(several redundant or stale rows removed, several new areas added), and
the
"why Enterprise" bullets replaced with ones tied to a concrete page
(Performance, Scale, Fault tolerance, Multicloud deployment, Simplify
operations) instead of vague promises.

Plus a full pass addressing lancedb-gatekeeper's review: a real
test-safety
bug (a quickstart test could silently overwrite and delete a
deployment's
own `frames` table), a fabricated SQL statement with no backing
implementation, an actual dedup-guarantee bug in `take_row_ids`, and
dozens
of documentation-accuracy fixes verified against source rather than
taken
on faith -- each either fixed, or left with an explicit note on why it
needs a feature or deployment owner's sign-off instead of being guessed
at.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

https://claude.ai/code/session_018PXMCbRH6i5w47TsjeEUMT

---------

Co-authored-by: Claude Sonnet 5 <noreply@anthropic.com>
2026-11-03 16:17:24 -08:00

58 lines
2.6 KiB
Plaintext

---
title: "GPU Refresh Execution"
sidebarTitle: "GPU Refresh Execution"
description: "A computed column or materialized view filled by a GPU Function schedules its refresh workers the same way GPU Function execution does in Data Curation."
icon: microchip
keywords: ["gpu", "gpu class", "scheduling", "refresh", "computed column", "function"]
availability:
embedded: unavailable
enterprise: available
---
A [computed column](/feature-engineering/add-computed-column) or
[materialized view](/feature-engineering/materialized-views) filled by a
registered [Function](/curation/create-function) with `gpu=True` refreshes
through the exact same placement path as
[GPU Function execution](/curation/gpu-function-execution) in Data
Curation -- refreshing a column is not a separate scheduling code path
from calling the Function directly, just a different caller.
```mermaid
flowchart LR
F["Function registered with<br/>gpu=True, gpu_class"] --> A{"Who requests<br/>a worker?"}
A -->|"You, directly"| D["Data Curation:<br/>GPU Function execution"]
A -->|"A refresh job"| R["Feature Engineering:<br/>computed column / MV refresh"]
D --> P["Same GPU-class placement,<br/>same capacity-wait behavior"]
R --> P
```
The Function's `gpu_class` (or the deployment's `default`) resolves to the
same node selector, tolerations and resource name either way, and a
refresh that needs more GPU capacity than is currently free waits the
same way a direct call would -- see
[Waiting for capacity](/curation/gpu-function-execution#capacity) for that
behavior in full. [Adaptive Execution](/enterprise/adaptive-execution)'s
resource-consumption-based sizing applies here too: a refresh's GPU
utilization is measured and fed back into sizing the *next* part the same
way CPU and memory are.
A single refresh can also override the Function's registered placement for
that run -- see
[Configure workers and resources](/feature-engineering/refresh-column#resources)
for the `gpu_class`/`gpu_count` options on `refresh_column_async` and the
equivalent SQL `WITH (...)` clause.
## What to read next {#next}
<CardGroup cols={2}>
<Card title="GPU Function Execution" icon="microchip" href="/curation/gpu-function-execution">
The full placement and capacity-wait mechanism this page reuses.
</Card>
<Card title="Adaptive Execution" icon="gauge-high" href="/enterprise/adaptive-execution">
How a refresh's resource class, part size and worker count adjust themselves.
</Card>
<Card title="Configure workers and resources" icon="sliders" href="/feature-engineering/refresh-column#resources">
Override GPU class and count for one refresh call.
</Card>
</CardGroup>