Skip to content

Cookbook fixes from v2.0-rc.5 validation#401

Open
phillipleblanc wants to merge 2 commits into
trunkfrom
rc5-validation-fixes
Open

Cookbook fixes from v2.0-rc.5 validation#401
phillipleblanc wants to merge 2 commits into
trunkfrom
rc5-validation-fixes

Conversation

@phillipleblanc
Copy link
Copy Markdown
Contributor

Summary

Two-commit cleanup of cookbook recipes against the v2.0-rc.5 build:

  • PostgreSQL Accelerator (postgres/accelerator/)
    • Note up front that the engine is an Enterprise feature in Spice v2.0; community builds reject engine: postgres at dataset init.
    • Add the now-required spiceai_region connector parameter to the Step 5 yaml snippet and to the bundled spicepod.yaml template. Without it the runtime fails with Missing required parameter: region.
  • Hybrid Search (search/) — rename fused_score to _fused_score in every example so they match the v2.0 RRF UDTF output. Adds a callout near the top pointing v1.x users at the legacy column name.
  • TLS (tls/) — add a macOS-specific chmod 600 postgres.key section. Without it, Postgres 18 refuses to start with FATAL: private key file ... has group or world access.
  • DynamoDB Streams (dynamodb/streams/) — refresh the bootstrap log sample to match the current runtime log lines.
  • mTLS (mtls/) — fix the no-client-cert response sample; the runtime returns plain text client certificate required, not JSON.
  • DuckLake (catalogs/ducklake/) — spell out the failure mode when DuckDB CLI is older than v1.5.2 (catalog metadata version 0.3 vs required 1.0).
  • Snowflake DML (snowflake/dml/) — add a snowflake-connector-python one-liner as an alternate to the worksheet UI for Step 1, including the dash-vs-dot account-identifier gotcha.

Test plan

  • postgres/accelerator/ — exercised end-to-end on rc.5: spice run registers taxi_trips with acceleration (postgres, 10s refresh), loads 2,964,624 rows in 62s, README sample queries succeed in both spice sql and direct psql.
  • search/ — column rename verified against the rc.5 build; full recipe blocked on Hybrid Search: rrf(text_search, vector_search) crashes with UdtfExec::maintains_input_order assertion spiceai#10951 (needs join_key workaround).
  • tls/, mtls/, dynamodb/streams/, catalogs/ducklake/, snowflake/dml/ — README-only text changes; no behavior change to validate.

…ai_region

- Add an upfront note that the PostgreSQL Data Accelerator is Enterprise-only
  in Spice v2.0; community builds reject engine: postgres at dataset init.
- Add the now-required `spiceai_region` connector parameter to the Step 5
  spicepod.yaml example and to the bundled spicepod.yaml template. Without it
  the spice.ai connector fails with "Missing required parameter: region".
- search/: rename `fused_score` -> `_fused_score` in every example to
  match the v2.0 RRF UDTF output. Add a callout near the top of the
  README pointing v1.x users at the legacy column name.
- tls/: add a macOS section for `chmod 600 postgres.key`. Without it,
  Postgres 18 refuses to start with "FATAL: private key file ... has
  group or world access".
- dynamodb/streams/: refresh the bootstrap log sample to match the
  current runtime log lines (No existing lag found / initialization
  complete).
- mtls/: fix the no-client-cert response sample; the runtime now
  returns plain text `client certificate required`, not JSON.
- catalogs/ducklake/: spell out the failure mode when DuckDB CLI is
  older than v1.5.2 (catalog metadata version 0.3 vs required 1.0).
- snowflake/dml/: add a snowflake-connector-python one-liner as an
  alternate to the worksheet UI for Step 1, including the
  dash-vs-dot account-identifier gotcha.
@phillipleblanc phillipleblanc self-assigned this May 22, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant