docs: read Enterprise connection settings from the shared variables

The Enterprise connection examples now read the database URI from
LANCEDB_URI and the endpoint from LANCEDB_HOST_OVERRIDE, with the API
key and region beside them, the convention the rest of the site uses.
Without an endpoint they stop rather than fall back to one. Their tests
check both.

The REST API reference used LANCEDB_URI for the HTTP endpoint and listed
and created tables at routes the server does not serve. It now uses
LANCEDB_HOST_OVERRIDE, lists tables at /v1/table/, creates `words` from
an Arrow IPC stream, and describes it to confirm the write.

docs/web-tests/py/test_connection.py

@@ -4,6 +4,8 @@
 from pathlib import Path
 import shutil
 
+import pytest
+
 
 def test_connection():
     # --8<-- [start:connect]
@@ -29,19 +31,16 @@ async def connect_async_example():
 
 
 def connect_enterprise_quickstart_config():
+    # --8<-- [start:connect_enterprise_quickstart]
+    import os
+
     import lancedb
 
-    # --8<-- [start:connect_enterprise_quickstart]
-    uri = "db://your-database-uri"
-    api_key = "your-api-key"
-    region = "us-east-1"
-    host_override = "https://your-enterprise-endpoint.com"
-
     db = lancedb.connect(
-        uri=uri,
-        api_key=api_key,
-        region=region,
-        host_override=host_override,
+        uri=os.environ["LANCEDB_URI"],  # db://your-database
+        api_key=os.environ["LANCEDB_API_KEY"],
+        region=os.environ.get("LANCEDB_REGION", "us-east-1"),
+        host_override=os.environ["LANCEDB_HOST_OVERRIDE"],  # https://your-endpoint
     )
     # --8<-- [end:connect_enterprise_quickstart]
     return db
@@ -57,17 +56,29 @@ def test_connect_enterprise_quickstart(monkeypatch):
         return object()
 
     monkeypatch.setattr(lancedb, "connect", fake_connect)
+    monkeypatch.setenv("LANCEDB_URI", "db://your-database")
+    monkeypatch.setenv("LANCEDB_API_KEY", "your-api-key")
+    monkeypatch.delenv("LANCEDB_REGION", raising=False)
+    monkeypatch.setenv("LANCEDB_HOST_OVERRIDE", "https://your-endpoint")
 
-    db = connect_enterprise_quickstart_config()
-    assert db is not None
+    assert connect_enterprise_quickstart_config() is not None
     assert captured == {
-        "uri": "db://your-database-uri",
+        "uri": "db://your-database",
         "api_key": "your-api-key",
         "region": "us-east-1",
-        "host_override": "https://your-enterprise-endpoint.com",
+        "host_override": "https://your-endpoint",
     }
 
 
+def test_connect_enterprise_quickstart_requires_an_endpoint(monkeypatch):
+    monkeypatch.setenv("LANCEDB_URI", "db://your-database")
+    monkeypatch.setenv("LANCEDB_API_KEY", "your-api-key")
+    monkeypatch.delenv("LANCEDB_HOST_OVERRIDE", raising=False)
+
+    with pytest.raises(KeyError, match="LANCEDB_HOST_OVERRIDE"):
+        connect_enterprise_quickstart_config()
+
+
 def connect_object_storage_config():
     # --8<-- [start:connect_object_storage]
     import lancedb

docs/web-tests/rs/connection.rs

@@ -23,19 +23,15 @@ async fn main() {
     let _ = connect_object_storage_config();
 }
 
-fn connect_enterprise_quickstart_config() -> (String, String, String, String) {
+fn connect_enterprise_quickstart_config()
+-> Result<(String, String, String, String), std::env::VarError> {
     // --8<-- [start:connect_enterprise_quickstart]
-    let uri = "db://your-database-uri";
-    let api_key = "your-api-key";
-    let region = "us-east-1";
-    let host_override = "https://your-enterprise-endpoint.com";
+    let uri = std::env::var("LANCEDB_URI")?; // db://your-database
+    let api_key = std::env::var("LANCEDB_API_KEY")?;
+    let region = std::env::var("LANCEDB_REGION").unwrap_or_else(|_| "us-east-1".to_string());
+    let host_override = std::env::var("LANCEDB_HOST_OVERRIDE")?; // https://your-endpoint
     // --8<-- [end:connect_enterprise_quickstart]
-    (
-        uri.to_string(),
-        api_key.to_string(),
-        region.to_string(),
-        host_override.to_string(),
-    )
+    Ok((uri, api_key, region, host_override))
 }
 
 fn connect_object_storage_config() -> &'static str {

docs/web-tests/ts/connection.test.ts

@@ -1,6 +1,6 @@
 // SPDX-License-Identifier: Apache-2.0
 // SPDX-FileCopyrightText: Copyright The LanceDB Authors
-import { expect, jest, test } from "@jest/globals";
+import { afterEach, describe, expect, jest, test } from "@jest/globals";
 import * as path from "node:path";
 import { withTempDirectory } from "./util.ts";
 // --8<-- [start:connect]
@@ -22,34 +22,56 @@ test("connect to a local database", async () => {
 
 async function connectEnterpriseQuickstart() {
   // --8<-- [start:connect_enterprise_quickstart]
-  const uri = "db://your-database-uri";
-  const apiKey = "your-api-key";
-  const region = "us-east-1";
-  const hostOverride = "https://your-enterprise-endpoint.com";
+  const setting = (name: string) => {
+    const value = process.env[name];
+    if (!value) throw new Error(`Set ${name}`);
+    return value;
+  };
 
-  const db = await lancedb.connect(uri, {
-    apiKey,
-    region,
-    hostOverride,
+  const db = await lancedb.connect(setting("LANCEDB_URI"), {
+    apiKey: setting("LANCEDB_API_KEY"),
+    region: process.env.LANCEDB_REGION ?? "us-east-1",
+    hostOverride: setting("LANCEDB_HOST_OVERRIDE"),
   });
   // --8<-- [end:connect_enterprise_quickstart]
   return db;
 }
 
-test("enterprise quickstart connect uses placeholder config", async () => {
-  const mockDb = { __mock: true } as unknown as Awaited<
-    ReturnType<typeof lancedb.connect>
-  >;
-  const spy = jest.spyOn(lancedb, "connect").mockResolvedValue(mockDb);
-
-  const db = await connectEnterpriseQuickstart();
-  expect(db).toBe(mockDb);
-  expect(spy).toHaveBeenCalledWith("db://your-database-uri", {
-    apiKey: "your-api-key",
-    region: "us-east-1",
-    hostOverride: "https://your-enterprise-endpoint.com",
+describe("enterprise quickstart connect", () => {
+  const saved = { ...process.env };
+  afterEach(() => {
+    process.env = { ...saved };
+  });
+
+  test("reads the connection from the environment", async () => {
+    const mockDb = { __mock: true } as unknown as Awaited<
+      ReturnType<typeof lancedb.connect>
+    >;
+    const spy = jest.spyOn(lancedb, "connect").mockResolvedValue(mockDb);
+    process.env.LANCEDB_URI = "db://your-database";
+    process.env.LANCEDB_API_KEY = "your-api-key";
+    delete process.env.LANCEDB_REGION;
+    process.env.LANCEDB_HOST_OVERRIDE = "https://your-endpoint";
+
+    const db = await connectEnterpriseQuickstart();
+    expect(db).toBe(mockDb);
+    expect(spy).toHaveBeenCalledWith("db://your-database", {
+      apiKey: "your-api-key",
+      region: "us-east-1",
+      hostOverride: "https://your-endpoint",
+    });
+    spy.mockRestore();
+  });
+
+  test("requires an endpoint", async () => {
+    process.env.LANCEDB_URI = "db://your-database";
+    process.env.LANCEDB_API_KEY = "your-api-key";
+    delete process.env.LANCEDB_HOST_OVERRIDE;
+
+    await expect(connectEnterpriseQuickstart()).rejects.toThrow(
+      "Set LANCEDB_HOST_OVERRIDE",
+    );
   });
-  spy.mockRestore();
 });
 
 // --8<-- [start:connect_object_storage]