docs(motherduck): name 0.182.0 as the last DuckDB 1.5 release; state dlt's whole-table Arrow reads

The MotherDuck connection error no longer repeats its help text in the message, the dlt note
says only whole-table Arrow reads fail, and the local lambda replay test is an expected failure
until the polyglot wheel that writes DuckDB lambdas as LAMBDA x : body is published.

Author: kvlonge

src/sqlbuild/.agents/skills/sqlbuild/references/docs/concepts/adapters/duckdb.md

@@ -31,8 +31,8 @@ these before upgrading:
 - Integer division `//` and modulo `%` by zero raise an error instead of returning `NULL`. Wrap
   the expression in `TRY(...)` to get `NULL`.
 
-dlt's dataset read API (reading a loaded table back as a dataframe or Arrow table) calls DuckDB
-methods that DuckDB 2.0 removed, so those reads fail. Loading data with dlt is not affected.
+dlt's dataset read API calls a DuckDB method that DuckDB 2.0 removed when it reads a loaded table
+back as one whole Arrow table, so that read fails. Dataframe and chunked Arrow reads still work. Loading data with dlt is not affected.
 
 ## Connection config
 

src/sqlbuild/.agents/skills/sqlbuild/references/docs/concepts/adapters/motherduck.md

@@ -12,9 +12,8 @@ MotherDuck uses DuckDB's built-in `md:` connection support. No extra installatio
 
 SQLBuild requires DuckDB 2.0, and MotherDuck does not support DuckDB 2.0 yet: its extension
 supports DuckDB up to 1.5.6 and refuses to load on 2.0. Connecting reports
-`MotherDuck does not support DuckDB 2.0.0 yet`. If you use MotherDuck, stay on the last SQLBuild
-release that supports DuckDB 1.5, as listed in the changelog, until MotherDuck supports
-DuckDB 2.0.
+`MotherDuck does not support DuckDB 2.0.0 yet`. If you use MotherDuck, stay on SQLBuild 0.182.0,
+the last release that supports DuckDB 1.5, until MotherDuck supports DuckDB 2.0.
 
 ## Connection config
 

src/sqlbuild/adapters/motherduck/classes/motherduck_adapter.py

@@ -163,10 +163,7 @@ def connect(self, config: dict[str, Any]) -> Any:
             if MOTHERDUCK_UNSUPPORTED_DUCKDB_MARKER not in str(error):
                 raise
             raise AdapterUserError(
-                message=(
-                    f"MotherDuck does not support DuckDB {duckdb.__version__} yet. "
-                    f"{MOTHERDUCK_UNSUPPORTED_DUCKDB_HELP}"
-                ),
+                message=f"MotherDuck does not support DuckDB {duckdb.__version__} yet.",
                 help=MOTHERDUCK_UNSUPPORTED_DUCKDB_HELP,
             ) from error
 

src/sqlbuild/adapters/motherduck/constants.py

@@ -5,6 +5,6 @@
 URI_ADDITIONAL_PARAMETER_SEPARATOR: str = "&"
 MOTHERDUCK_UNSUPPORTED_DUCKDB_MARKER: str = "is not yet supported by MotherDuck"
 MOTHERDUCK_UNSUPPORTED_DUCKDB_HELP: str = (
-    "This SQLBuild release requires DuckDB 2.0. To use MotherDuck, stay on the last SQLBuild "
-    "release that supports DuckDB 1.5 until MotherDuck supports DuckDB 2.0."
+    "This SQLBuild release requires DuckDB 2.0. To use MotherDuck, stay on SQLBuild 0.182.0, "
+    "the last release that supports DuckDB 1.5, until MotherDuck supports DuckDB 2.0."
 )

tests/e2e/src/sqlbuild/cli/commands/main/scenario/test_local_lambda.py

@@ -17,6 +17,10 @@
 from tests.e2e.src.sqlbuild.cli.commands.shared.helpers import prepare_inline_project, run_sqb
 
 
+@pytest.mark.xfail(
+    strict=True,
+    reason="needs the polyglot-sql-chio wheel that writes DuckDB lambdas as LAMBDA x : body",
+)
 @pytest.mark.parametrize(
     "test_case",
     [

website/src/content/docs/docs/concepts/adapters/duckdb.mdx

@@ -28,8 +28,8 @@ these before upgrading:
 - Integer division `//` and modulo `%` by zero raise an error instead of returning `NULL`. Wrap
   the expression in `TRY(...)` to get `NULL`.
 
-dlt's dataset read API (reading a loaded table back as a dataframe or Arrow table) calls DuckDB
-methods that DuckDB 2.0 removed, so those reads fail. Loading data with dlt is not affected.
+dlt's dataset read API calls a DuckDB method that DuckDB 2.0 removed when it reads a loaded table
+back as one whole Arrow table, so that read fails. Dataframe and chunked Arrow reads still work. Loading data with dlt is not affected.
 
 ## Connection config
 

website/src/content/docs/docs/concepts/adapters/motherduck.mdx

@@ -9,9 +9,8 @@ MotherDuck uses DuckDB's built-in `md:` connection support. No extra installatio
 
 SQLBuild requires DuckDB 2.0, and MotherDuck does not support DuckDB 2.0 yet: its extension
 supports DuckDB up to 1.5.6 and refuses to load on 2.0. Connecting reports
-`MotherDuck does not support DuckDB 2.0.0 yet`. If you use MotherDuck, stay on the last SQLBuild
-release that supports DuckDB 1.5, as listed in the changelog, until MotherDuck supports
-DuckDB 2.0.
+`MotherDuck does not support DuckDB 2.0.0 yet`. If you use MotherDuck, stay on SQLBuild 0.182.0,
+the last release that supports DuckDB 1.5, until MotherDuck supports DuckDB 2.0.
 
 ## Connection config