feat: SQL query with named parameters

[alespour]

Closes #55

Proposed Changes

This PR add supports for named parameters in the query API
QueryWithParameters(context.Context, string, QueryParameters, ...QueryOption)

client.QueryWithParameters(ctx,
    "SELECT a, b, c FROM my_table WHERE id = $id AND name = $name",
    influxdb3.QueryParameters{
      "id", 1,
      "name", "test",
    }
)

Breaking changes

Changed existing Query* and Write* methods from

Query(context.Context, string)
QueryWithOptions(context.Context, string, *QueryOptions)

Write(context.Context, []byte)
WriteWithOptions(context.Context, *WriteOptions, []byte)
WriteData(context.Context, ...*interface{})
WriteDataWithOptions(context.Context, *WriteOptions, ...*interface{})
WritePoints(context.Context, ...*Points)
WritePointsWithOptions(context.Context, *WriteOptions, ...*Points)

to

Query(context.Context, string, ...QueryOption)

Write(context.Context, []byte, ...WriteOption)
WriteData(context.Context, []*interface{}, ...WriteOption)
WritePoints(context.Context, []*Points, ...WriteOption)

where available options are

QueryOption:

• WithDatabase
• WithQueryType

WriteOption:

• WithDatabase
• WithPrecision
• WithGzipThreshold
• WithDefaultTags

Example:

client.Write(ctx,
    []byte("my_table,name=miracle,id=1 a=0,b=1,c-2 1706284020"),
    influxdb3.WithPrecision(lineprotocol.Second)
)

client.Query(ctx,
    "SELECT a, b, c FROM my_table WHERE id = 1 AND name = miracle",
    influxdb3.WithDatabase("db-miracles"))
)

Checklist

• CHANGELOG.md updated
• Rebased/mergeable
• A test has been added if appropriate
• Tests pass
• Commit messages are conventional
• Sign CLA (if not already signed)

[codecov]

Codecov Report

Attention: Patch coverage is 92.59259% with 6 lines in your changes are missing coverage. Please review.

Project coverage is 83.09%. Comparing base (a9da0b1) to head (f6916ef).

Files	Patch %	Lines
influxdb3/write.go	83.33%	4 Missing and 1 partial ⚠️
influxdb3/query.go	92.30%	1 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##             main      #56      +/-   ##
==========================================
- Coverage   83.31%   83.09%   -0.22%     
==========================================
  Files          11       12       +1     
  Lines         935      994      +59     
==========================================
+ Hits          779      826      +47     
- Misses        128      138      +10     
- Partials       28       30       +2     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

[karel-rehor]

I think the Deprecation message could be more precise. e.g. "Deprecated: use Query with variadic QueryOption options". The deprecated method itself has a similar argument with a pointer to QueryOptions. At first glance it can be a bit confusing.

[bednar]

The message is updated.

[karel-rehor]

Here too maybe the message could be more specific. e.g. "Deprecated: use WritePoints with variadic WriteOption options"

[bednar]

The message is updated.

[karel-rehor]

Tried new features and some old in ad hoc tests here https://github.com/bonitoo-io/influxdb3-client-tests/tree/main/go-client/release-0.6.0.

While these covered the core of the golden path, nothing unexpected occurred and results look sound.

Nit pick:
As mentioned at points in review, the message on deprecated methods can be a bit confusing at first glance. Perhaps it could be improved by being more specific.

For example.

• current: "Deprecated: use Query with WithQueryOptions option"
• suggested: "Deprecated: use Query with variadic QueryOptions option"

[bednar]

Tried new features and some old in ad hoc tests here https://github.com/bonitoo-io/influxdb3-client-tests/tree/main/go-client/release-0.6.0.

While these covered the core of the golden path, nothing unexpected occurred and results look sound.

Nit pick: As mentioned at points in review, the message on deprecated methods can be a bit confusing at first glance. Perhaps it could be improved by being more specific.

For example.

• current: "Deprecated: use Query with WithQueryOptions option"
• suggested: "Deprecated: use Query with variadic QueryOptions option"

The messages are updated.