Documentation ¶
Overview ¶
The query packages implement Vanadium's query capabilities.
The syncql package is used by clients of a Vanadium component that supports queries. It includes: ResultStream (which is the product of executing a query), the error messages that could be returned from performing a query, and a function to parse an error to get the offset into a query that caused the error. syncql does not include the Exec function as that must be provided by the component that supports queries.
The engine package implements the query engine. A component that supports queries calls the Exec function in this package.
The datasource package contains the interfaces that a Vanadium component must implement in order to use the query engine.
The internal package provides a reference implementation of the queries package. Its sole client is the engine package.
Directories ¶
Path | Synopsis |
---|---|
Package engine defines a Create function which returns an instance of datasource.QueryEngine
|
Package engine defines a Create function which returns an instance of datasource.QueryEngine |
datasource
Package datasource defines the interfaces a system must implement to support querying.
|
Package datasource defines the interfaces a system must implement to support querying. |
internal
Package internal implements Exec, executing SQL-like queries on a given database.
|
Package internal implements Exec, executing SQL-like queries on a given database. |
internal/querychecker
Package querychecker performs a semantic check on an AST produced by the queryparser package.
|
Package querychecker performs a semantic check on an AST produced by the queryparser package. |
internal/queryfunctions
Package queryfunctions describes SyncQL's built-in functions.
|
Package queryfunctions describes SyncQL's built-in functions. |
internal/queryparser
Package queryparser is a parser to parse a simplified select statement (a la SQL) for the Vanadium key value store (a.k.a., syncbase).
|
Package queryparser is a parser to parse a simplified select statement (a la SQL) for the Vanadium key value store (a.k.a., syncbase). |
internal/test
Package query_test contains tests for the query package.
|
Package query_test contains tests for the query package. |
public
Package public defines the QueryEngine interface which is returned from calling v.io/v23/query/engine.Create and PreparedStatement which is returned from the QueryEngine.PrepareStatement function.
|
Package public defines the QueryEngine interface which is returned from calling v.io/v23/query/engine.Create and PreparedStatement which is returned from the QueryEngine.PrepareStatement function. |
Package pattern handles parsing and matching SQL LIKE-style glob patterns.
|
Package pattern handles parsing and matching SQL LIKE-style glob patterns. |
The ResultStream interface is used to iterate over query results.
|
The ResultStream interface is used to iterate over query results. |