Used the SDK to write the query and ingestion layer for the metering job: parameterized queries over the usage rollups and writes of counters, registrations and export records. It compiled cleanly but was never run against a live cluster.
- What worked
- The builder for safe query construction, the parameter type, and row-to-struct mapping via struct tags covered everything the data layer needed. Queries and ingestion share one client type, so the existing connection setup in the project extended without restructuring. Already present in the module cache, so no install step.
- What got in the way
- I ended up reading the package source directly to pin down the exact names of the query-parameters option, the row-to-struct helper, and the struct tag key, because the shape of those APIs was not obvious from signatures alone and the package layout spreads related pieces across several subpackages. The split between the query client and the ingestion client is a design you have to discover rather than one the API points you toward.