Skip to content

Story 17.3 — Single-cluster quickstart MD twins (JDBC + ADBC + Arrow Flight SQL) — elasticsql#145

Draft
fupelaqu wants to merge 3 commits into
release-r1from
feature/17.3
Draft

Story 17.3 — Single-cluster quickstart MD twins (JDBC + ADBC + Arrow Flight SQL) — elasticsql#145
fupelaqu wants to merge 3 commits into
release-r1from
feature/17.3

Conversation

@fupelaqu

Copy link
Copy Markdown
Contributor

Epic 17 (R1 Documentation & Marketing), Layer 1. Closes #144.

The elasticsql MD-mirror half of the single-cluster quickstarts (dual-docs sync; canonical MDX lives in softclient4es-web). The MD twin mapping is asymmetric (Architecture Decision A1): ADBC + Flight SQL twins already existed (augmented); JDBC had no twin → created (A1 default — symmetry + the hard dual-docs constraint, NOT the web-only carve-out).

Files

  • UPDATE documentation/client/adbc_driver.md — Your first JOIN, Version compatibility, Licensing & self-selection, honest-gap, Going further (telemetry HOCON/-D/env, no ?telemetry=).
  • UPDATE documentation/client/arrow_flight_sql.md — sidecar-vs-federation, Your first JOIN, in-process-ADBC pointer, version/licensing/honest-gap/Going further.
  • NEW documentation/client/jdbc.md — full mirror of the augmented web JDBC page (# JDBC Driver H1); ?telemetry=false URL opt-out.
  • UPDATE documentation/client/README.md nav — JDBC / ADBC / Arrow Flight SQL order.

Notes for reviewers

  • All JOIN SQL transcribed verbatim from JdbcIntegrationSpec.scala (jdbc_join_emp/jdbc_join_dept; :799-838 fixture, :1126-1129 PS) — re-verified against source.
  • Driver-JAR versions ship as the grep-able placeholder <R1_DRIVER_VERSION> (stale 0.1.5 / <version> removed); resolved at R1 release time.
  • Forward cross-links to 17.1 ../sql/joins.md, 17.2 federation_operator_guide.md, 17.6 ../sql/known_limitations.md are not on release-r1 → carry <!-- pending --> markers. client/telemetry.md IS live → linked directly. Launch gate (17.8): strip pending markers on sibling merge.
  • Sibling PR: web (canonical MDX) — SOFTNETWORK-APP/softclient4es-web Fix painless scripts #21 (draft).

🤖 Generated with Claude Code

… SQL (Story 17.3)

The elasticsql MD-mirror half of the single-cluster quickstarts (dual-docs
sync; canonical MDX lives in softclient4es-web). Twin mapping is asymmetric
(A1): ADBC + Flight SQL twins existed (augmented); JDBC had no twin -> created.

- UPDATE client/adbc_driver.md: Your first JOIN, Version compatibility,
  Licensing & self-selection, honest-gap, Going further (telemetry HOCON/-D/env,
  no ?telemetry=).
- UPDATE client/arrow_flight_sql.md: sidecar-vs-federation, Your first JOIN,
  in-process-ADBC pointer, version/licensing/honest-gap/Going further.
- NEW client/jdbc.md: full mirror of the augmented web JDBC page (# JDBC Driver
  H1); ?telemetry=false URL opt-out.
- UPDATE client/README.md nav: JDBC / ADBC / Arrow Flight SQL order.

All JOIN SQL transcribed verbatim from JdbcIntegrationSpec.scala
(jdbc_join_emp/jdbc_join_dept). Driver-JAR versions ship as the grep-able
placeholder <R1_DRIVER_VERSION> (stale 0.1.5 / <version> removed). Forward
cross-links to 17.1/17.2/17.6 carry pending markers; telemetry.md is live.

Closed Issue #144

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
fupelaqu and others added 2 commits June 25, 2026 12:20
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
… rename R1, remove story refs

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
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