mirror of
https://github.com/lancedb/lancedb.git
synced 2026-10-13 07:12:27 +00:00
Move the public website pages into `docs/web` beside the SDK, with
shared navigation and executable example sources in `docs/web-tests`.
The combined website is assembled by
[lancedb/docs#355](https://github.com/lancedb/docs/pull/355), with six
Enterprise replacements from
[lancedb/sophon#7681](https://github.com/lancedb/sophon/pull/7681).
This includes Function guidance, runnable Quickstarts, regenerated
snippets, production contact/demo fixes, the legacy SQL route, and the
LeRobot redirect. LeRobot remains attributed to Geneva; all 34 Geneva
pages remain in the docs repository until Function officially launches.
Materialized-view guidance follows the full rebuild refresh introduced
by #4373: local refresh writes the complete result, has no `full`
argument, supports `source_version`, and no longer requires stable row
IDs. Deployment SQL refresh options and stable-ID setup are qualified by
version/configuration. Function input guidance distinguishes ordinary
stored columns from computed inputs supported by newer deployments.
**Validation:** independently accepted local checks include 95 Python
tests (real Enterprise excluded), eight TypeScript tests, Rust
Quickstart, snippet parity, typos, deterministic assembly, Mint
validation and links/anchors/redirects. The combined baseline retains
all 181 production routes and 17 legacy redirects. Examples ran locally
against source-built Python SDK 0.40.0b13; existing GitHub workflows do
not run `docs/web-tests`. New main at `069b2f7d` is 0.41.0b0 and adds
computed Function inputs; that SDK was not exercised by the accepted
tests. Latest prose corrections receive focused site validation.
**Merge/rollout:** merge this and #7681 before #355's combined CI, which
reads producer `main`. This is migration infrastructure: section
overlays, source-owned skills and automatic versioned paired releases
remain follow-ups. The current manual publisher is transitional. Hosted
validation, a supported SDK/Enterprise release pair and a real
Enterprise walkthrough remain pending.
Production Mintlify watches `lancedb/docs:deploy-freeze`, directory
`docs`; preserve that source through review. The separate SDK GitHub
Pages reference workflow rebuilds on main merges.
**Updated-head CI (9a50f8db):**
[Typos](https://github.com/lancedb/lancedb/actions/runs/37654185443/job/112904990558),
[PR
title](https://github.com/lancedb/lancedb/actions/runs/37654179507/job/112904974595)
and
[Aikido](https://app.aikido.dev/featurebranch/scan/215386145?groupId=74229)
pass. Critical findings in the example lockfiles were patched: all Sharp
copies use 0.35.5, protobufjs 7.6.6, tar 7.5.22, quinn-proto 0.11.19,
zerovec 0.11.8 and zerovec-derive 0.11.6. The SDK's product dependencies
are unchanged. The revised lockfiles pass eight TypeScript examples,
HuggingFace decode/resize/crop/rescale/normalize plus AVIF roundtrip,
and Rust Quickstart. Aikido passing does not mean every advisory is
cleared; npm still reports 29 high and five moderate advisories in the
example dependency graph. No scanner bypass or suppression was added.
The Function prose correction passes combined/standalone Mint,
deterministic assembly, routes and assets. The revised 325-file site
checksum is
`175bec06864abb400dd292e667ba93448c0479b8359fd7bf6146afabf9040647`. This
PR remains open for independent review; further merges are on hold.
---------
Co-authored-by: Brendan Clement <brendan.clement@lancedb.com>
96 lines
3.5 KiB
Rust
96 lines
3.5 KiB
Rust
// SPDX-License-Identifier: Apache-2.0
|
|
// SPDX-FileCopyrightText: Copyright The LanceDB Authors
|
|
|
|
use std::{iter::once, sync::Arc};
|
|
|
|
use arrow_array::{RecordBatch, RecordBatchIterator, StringArray};
|
|
use arrow_schema::{DataType, Field, Schema};
|
|
use futures::StreamExt;
|
|
use lancedb::{
|
|
arrow::IntoArrow,
|
|
connect,
|
|
embeddings::{
|
|
sentence_transformers::SentenceTransformersEmbeddings, EmbeddingDefinition,
|
|
EmbeddingFunction,
|
|
},
|
|
query::{ExecutableQuery, QueryBase},
|
|
Result,
|
|
};
|
|
|
|
#[tokio::main]
|
|
async fn main() -> Result<()> {
|
|
let tempdir = tempfile::tempdir().unwrap();
|
|
let tempdir = tempdir.path().to_str().unwrap();
|
|
let embedding = SentenceTransformersEmbeddings::builder().build()?;
|
|
let embedding = Arc::new(embedding);
|
|
let db = connect(tempdir).execute().await?;
|
|
db.embedding_registry()
|
|
.register("sentence-transformers", embedding.clone())?;
|
|
|
|
let table = db
|
|
.create_table("vectors", make_data())
|
|
.add_embedding(EmbeddingDefinition::new(
|
|
"facts",
|
|
"sentence-transformers",
|
|
Some("embeddings"),
|
|
))?
|
|
.execute()
|
|
.await?;
|
|
|
|
let query = Arc::new(StringArray::from_iter_values(once(
|
|
"How many bones are in the human body?",
|
|
)));
|
|
let query_vector = embedding.compute_query_embeddings(query)?;
|
|
let mut results = table
|
|
.vector_search(query_vector)?
|
|
.limit(1)
|
|
.execute()
|
|
.await?;
|
|
|
|
let rb = results.next().await.unwrap()?;
|
|
let out = rb
|
|
.column_by_name("facts")
|
|
.unwrap()
|
|
.as_any()
|
|
.downcast_ref::<StringArray>()
|
|
.unwrap();
|
|
let text = out.iter().next().unwrap().unwrap();
|
|
println!("Answer: {}", text);
|
|
Ok(())
|
|
}
|
|
|
|
fn make_data() -> impl IntoArrow {
|
|
let schema = Schema::new(vec![Field::new("facts", DataType::Utf8, false)]);
|
|
|
|
let facts = StringArray::from_iter_values(vec![
|
|
"Albert Einstein was a theoretical physicist.",
|
|
"The capital of France is Paris.",
|
|
"The Great Wall of China is one of the Seven Wonders of the World.",
|
|
"Python is a popular programming language.",
|
|
"Mount Everest is the highest mountain in the world.",
|
|
"Leonardo da Vinci painted the Mona Lisa.",
|
|
"Shakespeare wrote Hamlet.",
|
|
"The human body has 206 bones.",
|
|
"The speed of light is approximately 299,792 kilometers per second.",
|
|
"Water boils at 100 degrees Celsius.",
|
|
"The Earth orbits the Sun.",
|
|
"The Pyramids of Giza are located in Egypt.",
|
|
"Coffee is one of the most popular beverages in the world.",
|
|
"Tokyo is the capital city of Japan.",
|
|
"Photosynthesis is the process by which plants make their food.",
|
|
"The Pacific Ocean is the largest ocean on Earth.",
|
|
"Mozart was a prolific composer of classical music.",
|
|
"The Internet is a global network of computers.",
|
|
"Basketball is a sport played with a ball and a hoop.",
|
|
"The first computer virus was created in 1983.",
|
|
"Artificial neural networks are inspired by the human brain.",
|
|
"Deep learning is a subset of machine learning.",
|
|
"IBM's Watson won Jeopardy! in 2011.",
|
|
"The first computer programmer was Ada Lovelace.",
|
|
"The first chatbot was ELIZA, created in the 1960s.",
|
|
]);
|
|
let schema = Arc::new(schema);
|
|
let rb = RecordBatch::try_new(schema.clone(), vec![Arc::new(facts)]).unwrap();
|
|
Box::new(RecordBatchIterator::new(vec![Ok(rb)], schema))
|
|
}
|