mirror of
https://github.com/lancedb/lancedb.git
synced 2026-11-20 17:43:58 +00:00
## Summary - Complete the SQL reference: `ATTACH DATABASE`, the `CHANGES` clause, and `dedupe()`/`duplicate_pairs()` (verified against current sophon source; these were recently renamed from `vector_dedup`/`vector_duplicate_pairs`). Fix the blob-column default-projection claim and add the previously undocumented `blob_descriptor()`. - Enrich the gated Functions draft (still `.mintignore`'d, pre-release): chained Functions over blob outputs, GPU-produced blobs, Secrets, multi-input/output binding, `code=[module]` packaging. - Upgrade the materialized-view and computed-column auto-refresh drafts with precise, verified catch-up semantics, and add the missing `ALTER MATERIALIZED VIEW` / `CREATE ... WITH(...)` sections (also gated — the automatic-refresh scheduler is still dev/staging-only). - Thread one running example (video frames → GPU extract/caption → dedup → auto-refreshing materialized view) through Functions, materialized views, and the LeRobotDataset integration guide instead of a separate tutorial. - Rename "LanceDB OSS"/"OSS" to "LanceDB Embedded"/"Embedded" throughout (52 files); activate the existing availability-comparison mechanism on `basics/offerings.mdx` for a full feature-by-feature comparison table.
122 lines
4.4 KiB
Plaintext
122 lines
4.4 KiB
Plaintext
---
|
|
title: "Update rows"
|
|
sidebarTitle: "Update"
|
|
description: "Select existing rows, change values or expressions, and verify the changes."
|
|
icon: pen
|
|
availability:
|
|
embedded: available
|
|
enterprise: available
|
|
---
|
|
|
|
import {
|
|
TsUpdateOperation,
|
|
TsUpdateUsingSql,
|
|
RsUpdateOperation,
|
|
RsUpdateUsingSql,
|
|
} from '/snippets/tables.mdx';
|
|
import {
|
|
PyUpdateOperation as UpdateOperation,
|
|
PyUpdateUsingSql as UpdateUsingSql,
|
|
} from '/snippets/ingestion_examples.mdx';
|
|
|
|
import { PyWriteWorkflow, TsWriteWorkflowBody, TsWriteWorkflowTail, RsWriteWorkflow } from '/snippets/ingestion_examples.mdx';
|
|
|
|
Use `update` to change rows selected by a predicate. Use
|
|
[merge insert](/ingestion/merge-insert) instead when matching an incoming dataset
|
|
against existing keys.
|
|
|
|
## Select the rows to change {#select-rows}
|
|
|
|
Check the predicate with a [filtered query](/search/filtering) before applying
|
|
the update. These examples target the row with `id = 2`. Review the scope
|
|
carefully when omitting a predicate, since that can update the entire table.
|
|
|
|
Each example below starts from Alice with 10 logins and Bob with 20. The
|
|
Python programs create and remove their own temporary database. TypeScript
|
|
and Rust operation blocks use `db`; a complete program is provided below.
|
|
|
|
## Assign a new value {#update-rows}
|
|
|
|
<CodeGroup>
|
|
<CodeBlock filename="Python" language="python" icon="python">
|
|
{UpdateOperation}
|
|
</CodeBlock>
|
|
<CodeBlock filename="TypeScript" language="typescript" icon="square-js">
|
|
{TsUpdateOperation}
|
|
</CodeBlock>
|
|
<CodeBlock filename="Rust" language="rust" icon="rust">
|
|
{RsUpdateOperation}
|
|
</CodeBlock>
|
|
</CodeGroup>
|
|
|
|
The result contains Alice and **Bobby**, with their login counts unchanged.
|
|
The Python `values` and TypeScript `values` arguments take literal values.
|
|
Rust's `column` argument is an expression, so the string value includes SQL quotes.
|
|
|
|
## Calculate a value from the existing row {#update-rows-with-sql-expressions}
|
|
|
|
<CodeGroup>
|
|
<CodeBlock filename="Python" language="python" icon="python">
|
|
{UpdateUsingSql}
|
|
</CodeBlock>
|
|
<CodeBlock filename="TypeScript" language="typescript" icon="square-js">
|
|
{TsUpdateUsingSql}
|
|
</CodeBlock>
|
|
<CodeBlock filename="Rust" language="rust" icon="rust">
|
|
{RsUpdateUsingSql}
|
|
</CodeBlock>
|
|
</CodeGroup>
|
|
|
|
In this separate example, Bob keeps his name and his login count becomes **21**.
|
|
Python's `values_sql` and TypeScript's `valuesSql` accept expressions.
|
|
These SDK expressions work with LanceDB Embedded tables; they do not require an
|
|
Enterprise SQL endpoint. Enterprise also offers [`UPDATE`](/sql/dml/update).
|
|
|
|
## Verify the affected data {#verify}
|
|
|
|
Read the selected rows again and inspect the changed fields. For another
|
|
connection or table handle, account for its
|
|
[read consistency](/tables/consistency) settings.
|
|
|
|
Nested-field updates are not supported by these operations. For schema changes,
|
|
see [schema evolution](/management/table#schema). Treat derived values separately:
|
|
changing an input field is not a guarantee that every stored feature has been
|
|
recomputed. See [Refresh a computed column](/feature-engineering/refresh-column).
|
|
|
|
Updates can change index coverage and query cost. After a large update,
|
|
inspect the workload and follow [index maintenance](/indexing/reindexing)
|
|
guidance for the backend you use.
|
|
|
|
## Complete write workflow {#complete-example}
|
|
|
|
<Accordion title="Complete examples: create, append, update, upsert and delete">
|
|
|
|
Each program creates a temporary local database, performs the five operations,
|
|
prints the result, and removes its temporary data when finished.
|
|
|
|
- **Python:** install `lancedb`, save the code as `ingestion.py`, and run
|
|
`python ingestion.py`.
|
|
- **TypeScript:** install `@lancedb/lancedb`, save the code as `ingestion.mts`,
|
|
and run `node ingestion.mts` with Node.js 22.18 or later.
|
|
- **Rust:** download the [complete Rust project](/static/code/ingestion-rust.zip),
|
|
extract it, and run `cargo run --locked`. It includes `src/main.rs`, the Cargo
|
|
manifest and a lockfile for the example's dependencies. The code is shown below.
|
|
|
|
<CodeGroup>
|
|
<CodeBlock filename="ingestion.py" language="python" icon="python">
|
|
{PyWriteWorkflow}
|
|
</CodeBlock>
|
|
<CodeBlock filename="ingestion.mts" language="typescript" icon="square-js">
|
|
{TsWriteWorkflowBody}
|
|
{TsWriteWorkflowTail}
|
|
</CodeBlock>
|
|
<CodeBlock filename="src/main.rs" language="rust" icon="rust">
|
|
{RsWriteWorkflow}
|
|
</CodeBlock>
|
|
</CodeGroup>
|
|
|
|
After the operations, Alice has 10 logins, Bobby has 21, and Charlie has 6.
|
|
Dana is selected for deletion and is absent from the final result.
|
|
|
|
</Accordion>
|