influxdata / influxdata/docs-v2

Specific DSN settings for FlightSQL clients

Open
#4,784 0 comments 0 reactions 0 assignees View on GitHub
InfluxDB v3
Dominant language
JavaScript
Stars
82
Forks
326
Avg merge
1d 1h
Merged PRs (30d)
82

Description

Paul, [via Slack ](https://influxdata.slack.com/archives/CDBJ35NBV/p1678461872443299)

> Our own cloud documentation should include the information for what specific DSN settings FlightSQL clients should have.

From the thread:

The README https://github.com/srebhan/arrow/tree/driver/go/arrow/flight/flightsql/driver#influxdata-iox has a section for "connecting to IOx". FlightSQL doesn't include a spec for pointing to a given database or bucket or schema or namespace or whatever the underlying database uses as it's unit of organization.
So the DSN must include a parameter to specify which bucket we're querying. That's also in the slack thread linked above.
That syntax is only for cloud MT. In cloud CST, we should move to namespace as that's what we'll be using in v3.

The current Cloud2 FlightSQL implementation already supports token (which resolves the org) and bucket-name. However IIRC this ain't backed directly by IOx but queryrouterd.
Now if we look directly at IOx this depends on the method:
do_get uses an "opaque" ticket (which is protobuf), that contains the SQL text and namespace
to get a ticket you call get_flight_info . That one indeed accepts a gRPC "header" (sometimes also called metadata) called iox-namespace-name
That's not standard though which is a bit sad (the headers are "application-defined"). There's upstream discussion though if that should be added to the FlightSQL standard in a more streamlined way, see https://lists.apache.org/thread/fd6r1n7vt91sg2c7fr35wcrsqz6x4645

##### Relevant URLs
- _Provide relevant URLs (issues, community threads, existing doc pages, etc.)_

Contributor guide

No contributing guide indexed for this repository

Research direction

Start with the linked Arrow FlightSQL README section on connecting to IOx and review the Slack context referenced in the issue. Document the correct DSN settings for Cloud MT and Cloud CST, including bucket or namespace selection, and verify that the guidance matches the current client behavior.

Written by the indexing model from the issue text.

Assessment

Tech stack
sql
Domain
databases, documentation
Issue type
Documentation
Difficulty
4/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.