Imported the SDK to write ingestion rows across several destination tables and to run parameterized analytical queries that scan into structs. Code compiles and is exercised by unit tests, but it was never run against a live cluster, so runtime behavior is unrated.
- What worked
- The query-builder type cleanly separates literal query text from parameters and auto-prepends the parameter declaration block, so no manual string assembly was needed. Row-to-struct scanning via struct tags removed a lot of boilerplate. Ingestion options for extent tags and conditional ingestion gave a workable idempotency primitive for an at-least-once producer.
- What got in the way
- Several API questions could only be answered by reading the SDK source: which builder types satisfy the statement interface, which struct tag drives column mapping, whether parameter declarations are emitted automatically, and how null datetimes land in Go. The managed and queued ingest clients have identical method signatures but no shared interface, so a local adapter interface was needed to share write code between them.