sqlds

Sep 6, 2023

Changes in this version

+ type Macro struct

+ Args []string

+ Name string

+ type QueryArgSetter interface

+ SetQueryArgs func(ctx context.Context, headers http.Header) []interface{}

Jun 7, 2023

Changes in this version

type DriverSettings

+ Errors bool

May 8, 2023

Changes in this version

+ var HeaderKey = "grafana-http-headers"

type DriverSettings

+ ForwardHeaders bool

Mar 23, 2023

Changes in this version

+ type ResponseMutator interface

+ MutateResponse func(ctx context.Context, res data.Frames) (data.Frames, error)

Mar 6, 2023

Changes in this version

+ type QueryMutator interface

+ MutateQuery func(ctx context.Context, req backend.DataQuery) (context.Context, backend.DataQuery)

Jan 9, 2023

Changes in this version

type FormatQueryOption

+ const FormatOptionTrace

Dec 13, 2022

Changes in this version

type DriverSettings

+ RetryOn []string

Nov 29, 2022

Changes in this version

type DriverSettings

+ Pause int

Nov 10, 2022

Changes in this version

type DriverSettings

+ Retries int

Oct 7, 2022

Changes in this version

+ const MockDataFolder

+ func CreateMockData(table string, folder string, csvData string) error

+ func CreateMockTable(table string, folder string) error

+ type SQLMock struct

+ func (h *SQLMock) Connect(config backend.DataSourceInstanceSettings, msg json.RawMessage) (*sql.DB, error)

+ func (h *SQLMock) Converters() []sqlutil.Converter

+ func (h *SQLMock) Macros() Macros

+ func (h *SQLMock) Settings(config backend.DataSourceInstanceSettings) DriverSettings

Sep 26, 2022

Changes in this version

type SQLDatasource

+ func (ds *SQLDatasource) GetDBFromQuery(q *Query, datasourceUID string) (*sql.DB, error)

Sep 23, 2022

Changes in this version

+ var ErrorMissingDBConnection = errors.New("unable to get default db connection")

+ var ErrorMissingMultipleConnectionsConfig = errors.New("received connection arguments but the feature is not enabled")

+ func QueryDB(ctx context.Context, db Connection, converters []sqlutil.Converter, ...) (data.Frames, error)

+ type SQLDatasource struct

+ CustomRoutes map[string]func(http.ResponseWriter, *http.Request)

+ EnableMultipleConnections bool

+ func (ds *SQLDatasource) CheckHealth(ctx context.Context, req *backend.CheckHealthRequest) (*backend.CheckHealthResult, error)

+ func (ds *SQLDatasource) Dispose()

+ func (ds *SQLDatasource) DriverSettings() DriverSettings

+ func (ds *SQLDatasource) NewDatasource(settings backend.DataSourceInstanceSettings) (instancemgmt.Instance, error)

+ func (ds *SQLDatasource) QueryData(ctx context.Context, req *backend.QueryDataRequest) (*backend.QueryDataResponse, error)

Feb 10, 2022

Changes in this version

+ func Interpolate(driver Driver, query *Query) (string, error)

Nov 2, 2021

Changes in this version

+ var ErrorWrongOptions = errors.New("error reading query options")

type Options

+ func ParseOptions(rawOptions json.RawMessage) (Options, error)

Oct 22, 2021

Changes in this version

+ var MissingDBConnection = errors.New("unable to get default db connection")

+ var MissingMultipleConnectionsConfig = errors.New("received connection arguments but the feature is not enabled")

type Query

+ DatasourceID int64

Oct 15, 2021

Changes in this version

+ type Options map[string]string

Sep 17, 2021

Changes in this version

type Macros

+ var DefaultMacros Macros = Macros{ ... }

Sep 8, 2021

Changes in this version

type FormatQueryOption

+ const FormatOptionLogs

Aug 30, 2021

Changes in this version

+ type Connection interface

+ Close func() error

+ Ping func() error

+ PingContext func(ctx context.Context) error

+ QueryContext func(ctx context.Context, query string, args ...interface{}) (*sql.Rows, error)

Aug 25, 2021

Changes in this version

+ var ErrorBadArgumentCount = errors.New("unexpected number of arguments")

+ var ErrorBadDatasource = errors.New("type assertion to datasource failed")

+ var ErrorJSON = errors.New("error unmarshaling query JSON the Query Model")

+ var ErrorNoResults = errors.New("no results returned from query")

+ var ErrorNotImplemented = errors.New("not implemented")

+ var ErrorQuery = errors.New("error querying the database")

+ var ErrorTimeout = errors.New("query timeout exceeded")

+ func NewDatasource(c Driver) *sqldatasource

+ type Completable interface

+ Columns func(ctx context.Context, table string) ([]string, error)

+ Schemas func(ctx context.Context) ([]string, error)

+ Tables func(ctx context.Context, schema string) ([]string, error)

+ type Driver interface

+ Connect func(backend.DataSourceInstanceSettings, json.RawMessage) (*sql.DB, error)

+ Converters func() []sqlutil.Converter

+ Macros func() Macros

+ Settings func(backend.DataSourceInstanceSettings) DriverSettings

+ type DriverSettings struct

+ FillMode *data.FillMissing

+ Timeout time.Duration

+ type FormatQueryOption uint32

+ const FormatOptionTable

+ const FormatOptionTimeSeries

+ type MacroFunc func(*Query, []string) (string, error)

+ type Macros map[string]MacroFunc

+ type Query struct

+ Column string

+ ConnectionArgs json.RawMessage

+ FillMissing *data.FillMissing

+ Format FormatQueryOption

+ Interval time.Duration

+ MaxDataPoints int64

+ RawSQL string

+ RefID string

+ Schema string

+ Table string

+ TimeRange backend.TimeRange

+ func GetQuery(query backend.DataQuery) (*Query, error)

+ func (q *Query) WithSQL(query string) *Query

+ type Response struct

+ func NewResponse(res *backend.QueryDataResponse) *Response

+ func (r *Response) Response() *backend.QueryDataResponse

+ func (r *Response) Set(refID string, res backend.DataResponse)