Documentation ¶
Index ¶
- Constants
- Variables
- func Append(buf *bytes.Buffer, node SQLNode)
- func Backtick(in string) string
- func CreateSlice(i interface{}) []interface{}
- func IsMap(arg interface{}) bool
- func IsSlice(i interface{}) bool
- func IsStructOrPtrToStruct(arg interface{}) bool
- func RegisterQuoteNames(dbType DBType, names []string)
- func SingleQuote(s string) string
- func SliceLen(i interface{}) int
- func String(node SQLNode) string
- func Walk(visit Visit, nodes ...SQLNode) error
- type AliasedExpr
- type AliasedTableExpr
- type AndExpr
- type BinaryExpr
- type BindMode
- type BoolVal
- type CaseExpr
- type ColIdent
- func (node ColIdent) CompliantName() string
- func (node ColIdent) Equal(in ColIdent) bool
- func (node ColIdent) EqualString(str string) bool
- func (node ColIdent) Format(buf *TrackedBuffer)
- func (node ColIdent) IsEmpty() bool
- func (node ColIdent) Lowered() string
- func (node ColIdent) MarshalJSON() ([]byte, error)
- func (node ColIdent) String() string
- func (node *ColIdent) UnmarshalJSON(b []byte) error
- func (node ColIdent) WalkSubtree(visit Visit) error
- type ColName
- type ColTuple
- type CollateExpr
- type ColumnDef
- type ColumnOption
- type ColumnOptionType
- type Columns
- type Comments
- type ComparisonExpr
- type CompatibleLimit
- type Constraint
- type ConstraintType
- type ConvertConfig
- type ConvertExpr
- type ConvertOption
- type ConvertResult
- type ConvertType
- type ConvertUsingExpr
- type CreateTable
- type DBType
- type DDL
- type Default
- type Delete
- type DoubleQuoteIdQuoter
- type Encodable
- type ExistsExpr
- type Expr
- type Exprs
- type ForceTableAsMode
- type FuncExpr
- type GroupBy
- type GroupConcatExpr
- type IWhere
- type IdQuoter
- type InPlaceholder
- type IndexHints
- type Insert
- type InsertRows
- type InsertValues
- type IntervalExpr
- type IsExpr
- type JoinTableExpr
- type KeywordQuoter
- type Limit
- type ListArg
- type MatchExpr
- type MySQLIdQuoter
- type Nextval
- type NotExpr
- type NullVal
- type OnDup
- type OrExpr
- type Order
- type OrderBy
- type OtherAdmin
- type OtherRead
- type Paging
- type ParenExpr
- type ParenSelect
- type ParenTableExpr
- type ParsedQuery
- type PlaceholderFormatter
- type PrefixPlaceholderFormatter
- type QuestionPlaceholderFormatter
- type RangeCond
- type RowFormatType
- type SQLNode
- type SQLVal
- type Select
- func (node *Select) AddHaving(expr Expr)
- func (node *Select) AddOrder(order *Order)
- func (node *Select) AddWhere(expr Expr)
- func (node *Select) Format(buf *TrackedBuffer)
- func (node *Select) GetWhere() *Where
- func (node *Select) SetLimit(limit *Limit)
- func (node *Select) SetLimitSQLNode(limit SQLNode)
- func (node *Select) SetWhere(w *Where)
- func (node *Select) WalkSubtree(visit Visit) error
- type SelectExpr
- type SelectExprs
- type SelectStatement
- type Set
- type Show
- type SimpleTableExpr
- type StarExpr
- type Statement
- type Subquery
- type TableExpr
- type TableExprs
- type TableIdent
- func (node TableIdent) CompliantName() string
- func (node TableIdent) Format(buf *TrackedBuffer)
- func (node TableIdent) IsEmpty() bool
- func (node TableIdent) MarshalJSON() ([]byte, error)
- func (node TableIdent) String() string
- func (node *TableIdent) UnmarshalJSON(b []byte) error
- func (node TableIdent) WalkSubtree(visit Visit) error
- type TableName
- type TableNames
- type TableOption
- type TableOptionType
- type Tokenizer
- type TrackedBuffer
- type TruncateTable
- type TupleEqualityList
- type UnaryExpr
- type Union
- type Update
- type UpdateExpr
- type UpdateExprs
- type Use
- type ValTuple
- type ValType
- type Values
- type ValuesFuncExpr
- type Visit
- type When
- type Where
Constants ¶
const ( DistinctStr = "distinct " StraightJoinHint = "straight_join " )
Select.Distinct
const ( ForUpdateStr = " for update" )
Select.Lock
const ( SQLCacheStr = "sql_cache " SQLNoCacheStr = "sql_no_cache " )
Select.Cache
const ( UnionStr = "union" UnionAllStr = "union all" UnionDistinctStr = "union distinct" )
Union.Type
const ( InsertStr = "insert" ReplaceStr = "replace" )
DDL strings.
const ( CreateStr = "create" AlterStr = "alter" DropStr = "drop" RenameStr = "rename" )
DDL strings.
const ( ShowDatabasesStr = "databases" ShowKeyspacesStr = "vitess_keyspaces" ShowShardsStr = "vitess_shards" ShowTablesStr = "tables" ShowVSchemaTablesStr = "vschema_tables" ShowUnsupportedStr = "unsupported" )
The frollowing constants represent SHOW statements.
const ( JoinStr = "join" StraightJoinStr = "straight_join" LeftJoinStr = "left join" RightJoinStr = "right join" NaturalJoinStr = "natural join" NaturalLeftJoinStr = "natural left join" NaturalRightJoinStr = "natural right join" )
JoinTableExpr.Join
const ( UseStr = "use " IgnoreStr = "ignore " ForceStr = "force " )
Index hints.
const ( WhereStr string = "where" HavingStr string = "having" )
const ( EqualStr = "=" LessThanStr = "<" GreaterThanStr = ">" LessEqualStr = "<=" GreaterEqualStr = ">=" NotEqualStr = "!=" NullSafeEqualStr = "<=>" InStr = "in" NotInStr = "not in" LikeStr = "like" NotLikeStr = "not like" RegexpStr = "regexp" NotRegexpStr = "not regexp" JSONExtractOp = "->" JSONUnquoteExtractOp = "->>" )
ComparisonExpr.Operator
const ( BetweenStr = "between" NotBetweenStr = "not between" )
RangeCond.Operator
const ( IsNullStr = "is null" IsNotNullStr = "is not null" IsTrueStr = "is true" IsNotTrueStr = "is not true" IsFalseStr = "is false" IsNotFalseStr = "is not false" )
IsExpr.Operator
const ( StrVal = ValType(iota) IntVal FloatVal HexNum HexVal ValArg )
These are the possible Valtype values. HexNum represents a 0x... value. It cannot be treated as a simple value because it can be interpreted differently depending on the context.
const ( BitAndStr = "&" BitOrStr = "|" BitXorStr = "^" PlusStr = "+" MinusStr = "-" MultStr = "*" DivStr = "/" IntDivStr = "div" ModStr = "%" ShiftLeftStr = "<<" ShiftRightStr = ">>" )
BinaryExpr.Operator
const ( UPlusStr = "+" UMinusStr = "-" TildaStr = "~" BangStr = "!" BinaryStr = "binary " )
UnaryExpr.Operator
const ( BooleanModeStr = " in boolean mode" NaturalLanguageModeStr = " in natural language mode" NaturalLanguageModeWithQueryExpansionStr = " in natural language mode with query expansion" QueryExpansionStr = " with query expansion" )
MatchExpr.Option
const ( AscScr = "asc" DescScr = "desc" )
Order.Direction
const AGAINST = 57474
const ALL = 57361
const ALTER = 57432
const ANALYZE = 57435
const AND = 57405
const AS = 57363
const ASC = 57365
const BETWEEN = 57407
const BINARY = 57427
const BOOLEAN = 57475
const BY = 57357
const CASE = 57408
const CAST = 57470
const CHARACTER = 57458
const COLLATE = 57426
const COMMENT = 57400
const CONVERT = 57469
const CREATE = 57431
const CROSS = 57387
const CURRENT_DATE = 57461
const CURRENT_TIME = 57462
const CURRENT_TIMESTAMP = 57459
const (
CharacterSetStr = " character set"
)
this string is "character set" and this comment is required
const CreateCountingQuery = -1
const DATABASE = 57460
const DATABASES = 57452
const DATE = 57447
const DEFAULT = 57370
const DELETE = 57351
const DESC = 57366
const DESCRIBE = 57445
const DISTINCT = 57362
const DIV = 57423
const DROP = 57433
const DUPLICATE = 57368
const ELSE = 57411
const END = 57412
const ESCAPE = 57448
const EXISTS = 57364
const EXPANSION = 57479
const EXPLAIN = 57446
const FALSE = 57403
const FLOAT = 57396
const FOR = 57360
const FORCE = 57390
const FROM = 57352
const GE = 57414
const GROUP = 57354
const GROUP_CONCAT = 57471
const HAVING = 57355
const HEX = 57393
const HEXNUM = 57397
const ID = 57392
const IF = 57441
const IGNORE = 57440
const IN = 57420
const INDEX = 57437
const INNER = 57385
const INSERT = 57349
const INTEGER = 57457
const INTEGRAL = 57395
const INTERVAL = 57428
const INTO = 57367
const IS = 57417
const JOIN = 57381
const JSON_EXTRACT_OP = 57429
const JSON_UNQUOTE_EXTRACT_OP = 57430
const KEY = 57369
const LANGUAGE = 57476
const LAST_INSERT_ID = 57374
const LE = 57413
const LEFT = 57383
const LEX_ERROR = 57346
const LIKE = 57418
const LIMIT = 57358
const LIST_ARG = 57399
const LOCALTIME = 57463
const LOCALTIMESTAMP = 57464
const LOCK = 57372
const MATCH = 57473
const MOD = 57424
const MODE = 57378
const NATURAL = 57388
const NE = 57415
const NEXT = 57375
const NOT = 57406
const NULL = 57401
const NULL_SAFE_EQUAL = 57416
const OFFSET = 57359
const ON = 57391
const OPTIMIZE = 57450
const OR = 57404
const ORDER = 57356
const OUTER = 57386
const QUERY = 57478
const REGEXP = 57419
const RENAME = 57434
const REPAIR = 57449
const REPLACE = 57468
const RIGHT = 57384
const SELECT = 57348
const SEPARATOR = 57472
const SET = 57371
const SHARE = 57377
const SHIFT_LEFT = 57421
const SHIFT_RIGHT = 57422
const SHOW = 57444
const SQL_CACHE = 57380
const SQL_NO_CACHE = 57379
const STRAIGHT_JOIN = 57382
const STRING = 57394
const TABLE = 57436
const TABLES = 57453
const THEN = 57410
const TO = 57439
const TRUE = 57402
const TRUNCATE = 57451
const UNARY = 57425
const UNION = 57347
const UNIQUE = 57442
const UNUSED = 57480
const UPDATE = 57350
const USE = 57389
const USING = 57443
const UTC_DATE = 57465
const UTC_TIME = 57466
const UTC_TIMESTAMP = 57467
const VALUE = 57376
const VALUES = 57373
const VALUE_ARG = 57398
const VIEW = 57438
const VITESS_KEYSPACES = 57454
const VITESS_SHARDS = 57455
const VSCHEMA_TABLES = 57456
const WHEN = 57409
const WHERE = 57353
const WITH = 57477
Variables ¶
var Aggregates = map[string]bool{ "avg": true, "bit_and": true, "bit_or": true, "bit_xor": true, "count": true, "group_concat": true, "max": true, "min": true, "std": true, "stddev_pop": true, "stddev_samp": true, "stddev": true, "sum": true, "var_pop": true, "var_samp": true, "variance": true, }
Aggregates is a map of all aggregate functions.
var ErrSyntax = errors.New("syntax not supported")
var ErrUnsupportedDBType = errors.New("unsupported database type")
Functions ¶
func CreateSlice ¶
func CreateSlice(i interface{}) []interface{}
func IsStructOrPtrToStruct ¶
func IsStructOrPtrToStruct(arg interface{}) bool
func RegisterQuoteNames ¶
RegisterQuoteNames 根据数据库类型 dbType,注册 需要添加双引号的字段名称
func SingleQuote ¶
SingleQuote returns a single-quoted Go string literal representing s. But, nothing else escapes.
Types ¶
type AliasedExpr ¶
AliasedExpr defines an aliased SELECT expression.
func (*AliasedExpr) Format ¶
func (node *AliasedExpr) Format(buf *TrackedBuffer)
Format formats the node.
func (*AliasedExpr) WalkSubtree ¶
func (node *AliasedExpr) WalkSubtree(visit Visit) error
WalkSubtree walks the nodes of the subtree.
type AliasedTableExpr ¶
type AliasedTableExpr struct { Expr SimpleTableExpr As TableIdent Hints *IndexHints }
AliasedTableExpr represents a table expression coupled with an optional alias or index hint. If As is empty, no alias was used.
func (*AliasedTableExpr) Format ¶
func (node *AliasedTableExpr) Format(buf *TrackedBuffer)
Format formats the node.
func (*AliasedTableExpr) WalkSubtree ¶
func (node *AliasedTableExpr) WalkSubtree(visit Visit) error
WalkSubtree walks the nodes of the subtree.
type AndExpr ¶
type AndExpr struct {
Left, Right Expr
}
AndExpr represents an AND expression.
func (*AndExpr) WalkSubtree ¶
WalkSubtree walks the nodes of the subtree.
type BinaryExpr ¶
BinaryExpr represents a binary value expression.
func (*BinaryExpr) Format ¶
func (node *BinaryExpr) Format(buf *TrackedBuffer)
Format formats the node.
func (*BinaryExpr) WalkSubtree ¶
func (node *BinaryExpr) WalkSubtree(visit Visit) error
WalkSubtree walks the nodes of the subtree.
type BoolVal ¶
type BoolVal bool
BoolVal is true or false.
func (BoolVal) WalkSubtree ¶
WalkSubtree walks the nodes of the subtree.
type CaseExpr ¶
CaseExpr represents a CASE expression.
func (*CaseExpr) WalkSubtree ¶
WalkSubtree walks the nodes of the subtree.
type ColIdent ¶
type ColIdent struct {
// contains filtered or unexported fields
}
ColIdent is a case insensitive SQL identifier. It will be escaped with backquotes if necessary.
func (ColIdent) CompliantName ¶
CompliantName returns a compliant id name that can be used for a bind var.
func (ColIdent) EqualString ¶
EqualString performs a case-insensitive compare with str.
func (ColIdent) Lowered ¶
Lowered returns a lower-cased column name. This function should generally be used only for optimizing comparisons.
func (ColIdent) MarshalJSON ¶
MarshalJSON marshals into JSON.
func (ColIdent) String ¶
String returns the unescaped column name. It must not be used for SQL generation. Use sqlparser.String instead. The Stringer conformance is for usage in templates.
func (*ColIdent) UnmarshalJSON ¶
UnmarshalJSON unmarshals from JSON.
func (ColIdent) WalkSubtree ¶
WalkSubtree walks the nodes of the subtree.
type ColName ¶
type ColName struct { // Metadata is not populated by the parser. // It's a placeholder for analyzers to store // additional data, typically info about which // table or column this node references. Metadata interface{} Name ColIdent Qualifier TableName }
ColName represents a column name.
func (*ColName) WalkSubtree ¶
WalkSubtree walks the nodes of the subtree.
type ColTuple ¶
type ColTuple interface { Expr // contains filtered or unexported methods }
ColTuple represents a list of column values. It can be ValTuple, Subquery, ListArg.
type CollateExpr ¶
CollateExpr represents dynamic collate operator.
func (*CollateExpr) Format ¶
func (node *CollateExpr) Format(buf *TrackedBuffer)
Format formats the node.
func (*CollateExpr) WalkSubtree ¶
func (node *CollateExpr) WalkSubtree(visit Visit) error
WalkSubtree walks the nodes of the subtree.
type ColumnDef ¶
type ColumnDef struct { Name string Type string // Elems is the element list for enum and set type. Elems []string Options []*ColumnOption }
type ColumnOption ¶
type ColumnOption struct { Type ColumnOptionType Value string }
ColumnOption is used for parsing column constraint info from SQL.
func (*ColumnOption) String ¶
func (o *ColumnOption) String() string
type ColumnOptionType ¶
type ColumnOptionType int
ColumnOptionType is the type for ColumnOption.
const ( ColumnOptionNoOption ColumnOptionType = iota ColumnOptionPrimaryKey ColumnOptionNotNull ColumnOptionAutoIncrement ColumnOptionDefaultValue ColumnOptionUniqKey ColumnOptionNull ColumnOptionOnUpdate // For Timestamp and Datetime only. ColumnOptionFulltext ColumnOptionComment ColumnOptionGenerated ColumnOptionReference )
func (ColumnOptionType) String ¶
func (o ColumnOptionType) String() string
type Columns ¶
type Columns []ColIdent
Columns represents an insert column list.
func (Columns) FindColumn ¶
FindColumn finds a column in the column list, returning the index if it exists or -1 otherwise
func (Columns) WalkSubtree ¶
WalkSubtree walks the nodes of the subtree.
type Comments ¶
type Comments [][]byte
Comments represents a list of comments.
func (Comments) WalkSubtree ¶
WalkSubtree walks the nodes of the subtree.
type ComparisonExpr ¶
ComparisonExpr represents a two-value comparison expression.
func (*ComparisonExpr) Format ¶
func (node *ComparisonExpr) Format(buf *TrackedBuffer)
Format formats the node.
func (*ComparisonExpr) WalkSubtree ¶
func (node *ComparisonExpr) WalkSubtree(visit Visit) error
WalkSubtree walks the nodes of the subtree.
type CompatibleLimit ¶
CompatibleLimit represents a LIMIT clause.
func (*CompatibleLimit) Format ¶
func (n *CompatibleLimit) Format(buf *TrackedBuffer)
Format formats the node.
type Constraint ¶
type Constraint struct { Type ConstraintType Name string // Used for PRIMARY KEY, UNIQUE, ...... Keys []ColIdent }
Constraint is constraint for table definition.
func (Constraint) String ¶
func (node Constraint) String() string
type ConstraintType ¶
type ConstraintType int
const ( ConstraintNoConstraint ConstraintType = iota ConstraintPrimaryKey ConstraintKey ConstraintIndex ConstraintUniq ConstraintUniqKey ConstraintUniqIndex ConstraintForeignKey ConstraintFulltext )
func (ConstraintType) String ¶
func (t ConstraintType) String() string
type ConvertConfig ¶
type ConvertExpr ¶
type ConvertExpr struct { Expr Expr Type *ConvertType }
ConvertExpr represents a call to CONVERT(expr, type) or it's equivalent CAST(expr AS type). Both are rewritten to the former.
func (*ConvertExpr) Format ¶
func (node *ConvertExpr) Format(buf *TrackedBuffer)
Format formats the node.
func (*ConvertExpr) WalkSubtree ¶
func (node *ConvertExpr) WalkSubtree(visit Visit) error
WalkSubtree walks the nodes of the subtree.
type ConvertOption ¶
type ConvertOption func(*ConvertConfig)
func WithAutoIncrement ¶
func WithAutoIncrement(v string) ConvertOption
func WithLimit ¶
func WithLimit(v int) ConvertOption
func WithPaging ¶
func WithPaging(v *Paging) ConvertOption
type ConvertResult ¶
type ConvertResult struct { ExtraArgs []interface{} CountingQuery string ScanValues []interface{} VarPoses []int // []var pos) BindMode BindMode VarNames []string InPlaceholder *InPlaceholder Placeholders int ConvertQuery func() string SwapArgs func(args []interface{}) }
func (ConvertResult) IsInPlaceholders ¶
func (r ConvertResult) IsInPlaceholders() bool
func (*ConvertResult) PickArgs ¶
func (r *ConvertResult) PickArgs(args []interface{}) (q string, bindArgs []interface{})
func (ConvertResult) ResetInVars ¶
func (r ConvertResult) ResetInVars(varsNum int)
type ConvertType ¶
ConvertType represents the type in call to CONVERT(expr, type)
func (*ConvertType) Format ¶
func (node *ConvertType) Format(buf *TrackedBuffer)
Format formats the node.
func (*ConvertType) WalkSubtree ¶
func (node *ConvertType) WalkSubtree(visit Visit) error
WalkSubtree walks the nodes of the subtree.
type ConvertUsingExpr ¶
ConvertUsingExpr represents a call to CONVERT(expr USING charset).
func (*ConvertUsingExpr) Format ¶
func (node *ConvertUsingExpr) Format(buf *TrackedBuffer)
Format formats the node.
func (*ConvertUsingExpr) WalkSubtree ¶
func (node *ConvertUsingExpr) WalkSubtree(visit Visit) error
WalkSubtree walks the nodes of the subtree.
type CreateTable ¶
type CreateTable struct { *DDL Columns []*ColumnDef Constraints []*Constraint Options []*TableOption }
func (*CreateTable) Format ¶
func (t *CreateTable) Format(buf *TrackedBuffer)
type DBType ¶
type DBType string
const ( Mysql DBType = "mysql" Sqlite3 DBType = "sqlite3" Dm DBType = "dm" // dm数据库 Gbase DBType = "gbase" // 南大通用 Clickhouse DBType = "clickhouse" Postgresql DBType = "postgresql" Kingbase DBType = "kingbase" // 金仓 Shentong DBType = "shentong" // 神通 Mssql DBType = "mssql" // sqlserver 2012+ Oracle DBType = "oracle" // oracle 12c+ )
func (DBType) Convert ¶
func (t DBType) Convert(query string, options ...ConvertOption) (*ConvertResult, error)
Convert converts query to target db type. 1. adjust the SQL variable symbols by different type, such as ?,? $1,$2. 1. quote table name, field names.
type DDL ¶
DDL represents a CREATE, ALTER, DROP or RENAME statement. Table is set for AlterStr, DropStr, RenameStr. NewName is set for AlterStr, CreateStr, RenameStr.
func (*DDL) WalkSubtree ¶
WalkSubtree walks the nodes of the subtree.
type Default ¶
type Default struct{}
Default represents a DEFAULT expression.
func (*Default) WalkSubtree ¶
WalkSubtree walks the nodes of the subtree.
type Delete ¶
type Delete struct { Comments Comments Targets TableNames TableExprs TableExprs Where *Where OrderBy OrderBy Limit *Limit }
Delete represents a DELETE statement.
func (*Delete) WalkSubtree ¶
WalkSubtree walks the nodes of the subtree.
type DoubleQuoteIdQuoter ¶
type DoubleQuoteIdQuoter struct{}
func (DoubleQuoteIdQuoter) Quote ¶
func (kq DoubleQuoteIdQuoter) Quote(s string) string
type ExistsExpr ¶
type ExistsExpr struct {
Subquery *Subquery
}
ExistsExpr represents an EXISTS expression.
func (*ExistsExpr) Format ¶
func (node *ExistsExpr) Format(buf *TrackedBuffer)
Format formats the node.
func (*ExistsExpr) WalkSubtree ¶
func (node *ExistsExpr) WalkSubtree(visit Visit) error
WalkSubtree walks the nodes of the subtree.
type Expr ¶
type Expr interface { SQLNode // contains filtered or unexported methods }
Expr represents an expression.
type Exprs ¶
type Exprs []Expr
Exprs represents a list of value expressions. It's not a valid expression because it's not parenthesized.
func (Exprs) WalkSubtree ¶
WalkSubtree walks the nodes of the subtree.
type ForceTableAsMode ¶
type ForceTableAsMode int
ForceTableAsMode 强制在生成表别名时的选项
const ( // ForceTableAsDefault 与原始语句保持相同 e.g. 原始: select 1 from dual d, 格式化: select 1 from dual d ForceTableAsDefault ForceTableAsMode = iota // ForceTableAsKeep 强制保留 e.g. 原始: select 1 from dual d, 格式化: select 1 from dual as d ForceTableAsKeep // ForceTableAsNone 强制不保留 e.g. 原始: select 1 from dual as d, 格式化: select 1 from dual d ForceTableAsNone )
type FuncExpr ¶
type FuncExpr struct { Qualifier TableIdent Name ColIdent Distinct bool Exprs SelectExprs }
FuncExpr represents a function call.
func (*FuncExpr) IsAggregate ¶
IsAggregate returns true if the function is an aggregate.
func (*FuncExpr) WalkSubtree ¶
WalkSubtree walks the nodes of the subtree.
type GroupBy ¶
type GroupBy []Expr
GroupBy represents a GROUP BY clause.
func (GroupBy) WalkSubtree ¶
WalkSubtree walks the nodes of the subtree.
type GroupConcatExpr ¶
type GroupConcatExpr struct { Distinct string Exprs SelectExprs OrderBy OrderBy Separator string }
GroupConcatExpr represents a call to GROUP_CONCAT
func (*GroupConcatExpr) Format ¶
func (node *GroupConcatExpr) Format(buf *TrackedBuffer)
Format formats the node
func (*GroupConcatExpr) WalkSubtree ¶
func (node *GroupConcatExpr) WalkSubtree(visit Visit) error
WalkSubtree walks the nodes of the subtree.
type InPlaceholder ¶
type InPlaceholder struct { Expr *ComparisonExpr Num int }
func ParseInPlaceholder ¶
func ParseInPlaceholder(node SQLNode) *InPlaceholder
type IndexHints ¶
IndexHints represents a list of index hints.
func (*IndexHints) Format ¶
func (node *IndexHints) Format(buf *TrackedBuffer)
Format formats the node.
func (*IndexHints) WalkSubtree ¶
func (node *IndexHints) WalkSubtree(visit Visit) error
WalkSubtree walks the nodes of the subtree.
type Insert ¶
type Insert struct { Action string Comments Comments Ignore string Table TableName Columns Columns Rows InsertRows OnDup OnDup }
Insert represents an INSERT or REPLACE statement. Per the MySQL docs, http://dev.mysql.com/doc/refman/5.7/en/replace.html Replace is the counterpart to `INSERT IGNORE`, and works exactly like a normal INSERT except if the row exists. In that case it first deletes the row and re-inserts with new values. For that reason we keep it as an Insert struct. Replaces are currently disallowed in sharded schemas because of the implications the deletion part may have on vindexes.
func (*Insert) WalkSubtree ¶
WalkSubtree walks the nodes of the subtree.
type InsertRows ¶
type InsertRows interface { SQLNode // contains filtered or unexported methods }
InsertRows represents the rows for an INSERT statement.
type InsertValues ¶
InsertValues is a custom SQL encoder for the values of an insert statement.
func (InsertValues) EncodeSQL ¶
func (iv InsertValues) EncodeSQL(buf *bytes.Buffer)
EncodeSQL performs the SQL encoding for InsertValues.
type IntervalExpr ¶
IntervalExpr represents a date-time INTERVAL expression.
func (*IntervalExpr) Format ¶
func (node *IntervalExpr) Format(buf *TrackedBuffer)
Format formats the node.
func (*IntervalExpr) WalkSubtree ¶
func (node *IntervalExpr) WalkSubtree(visit Visit) error
WalkSubtree walks the nodes of the subtree.
type IsExpr ¶
IsExpr represents an IS ... or an IS NOT ... expression.
func (*IsExpr) WalkSubtree ¶
WalkSubtree walks the nodes of the subtree.
type JoinTableExpr ¶
JoinTableExpr represents a TableExpr that's a JOIN operation.
func (*JoinTableExpr) Format ¶
func (node *JoinTableExpr) Format(buf *TrackedBuffer)
Format formats the node.
func (*JoinTableExpr) WalkSubtree ¶
func (node *JoinTableExpr) WalkSubtree(visit Visit) error
WalkSubtree walks the nodes of the subtree.
type KeywordQuoter ¶
func (KeywordQuoter) Quote ¶
func (kq KeywordQuoter) Quote(s string) string
type Limit ¶
type Limit struct {
Offset, Rowcount Expr
}
Limit represents a LIMIT clause.
func (*Limit) WalkSubtree ¶
WalkSubtree walks the nodes of the subtree.
type ListArg ¶
type ListArg []byte
ListArg represents a named list argument.
func (ListArg) WalkSubtree ¶
WalkSubtree walks the nodes of the subtree.
type MatchExpr ¶
type MatchExpr struct { Columns SelectExprs Expr Expr Option string }
MatchExpr represents a call to the MATCH function
func (*MatchExpr) Format ¶
func (node *MatchExpr) Format(buf *TrackedBuffer)
Format formats the node
func (*MatchExpr) WalkSubtree ¶
WalkSubtree walks the nodes of the subtree.
type MySQLIdQuoter ¶
type MySQLIdQuoter struct{}
func (MySQLIdQuoter) Quote ¶
func (kq MySQLIdQuoter) Quote(s string) string
type Nextval ¶
type Nextval struct {
Expr Expr
}
Nextval defines the NEXT VALUE expression.
func (Nextval) WalkSubtree ¶
WalkSubtree walks the nodes of the subtree.
type NotExpr ¶
type NotExpr struct {
Expr Expr
}
NotExpr represents a NOT expression.
func (*NotExpr) WalkSubtree ¶
WalkSubtree walks the nodes of the subtree.
type NullVal ¶
type NullVal struct{}
NullVal represents a NULL value.
func (*NullVal) WalkSubtree ¶
WalkSubtree walks the nodes of the subtree.
type OnDup ¶
type OnDup UpdateExprs
OnDup represents an ON DUPLICATE KEY clause.
func (OnDup) WalkSubtree ¶
WalkSubtree walks the nodes of the subtree.
type OrExpr ¶
type OrExpr struct {
Left, Right Expr
}
OrExpr represents an OR expression.
func (*OrExpr) WalkSubtree ¶
WalkSubtree walks the nodes of the subtree.
type Order ¶
Order represents an ordering expression.
func (*Order) WalkSubtree ¶
WalkSubtree walks the nodes of the subtree.
type OrderBy ¶
type OrderBy []*Order
OrderBy represents an ORDER By clause.
func (OrderBy) WalkSubtree ¶
WalkSubtree walks the nodes of the subtree.
type OtherAdmin ¶
type OtherAdmin struct{}
OtherAdmin represents a misc statement that relies on ADMIN privileges, such as REPAIR, OPTIMIZE, or TRUNCATE statement. It should be used only as an indicator. It does not contain the full AST for the statement.
func (*OtherAdmin) Format ¶
func (node *OtherAdmin) Format(buf *TrackedBuffer)
Format formats the node.
func (*OtherAdmin) WalkSubtree ¶
func (node *OtherAdmin) WalkSubtree(visit Visit) error
WalkSubtree walks the nodes of the subtree.
type OtherRead ¶
type OtherRead struct{}
OtherRead represents a DESCRIBE, or EXPLAIN statement. It should be used only as an indicator. It does not contain the full AST for the statement.
func (*OtherRead) Format ¶
func (node *OtherRead) Format(buf *TrackedBuffer)
Format formats the node.
func (*OtherRead) WalkSubtree ¶
WalkSubtree walks the nodes of the subtree.
type Paging ¶
type Paging struct { PageSeq int // Current page number, starting from 1 PageSize int // How many items per page, 20 items by default RowsCount int // Total number of data PageCount int // How many pages FirstPage bool // Is it the first page HasPrev bool // Whether there is a previous page HasNext bool // Is there a next page LastPage bool // Is it the last page }
Paging is pagination object.
func (*Paging) SetRowsCount ¶
SetRowsCount Set the total number of rows, calculate other values.
type ParenExpr ¶
type ParenExpr struct {
Expr Expr
}
ParenExpr represents a parenthesized boolean expression.
func (*ParenExpr) Format ¶
func (node *ParenExpr) Format(buf *TrackedBuffer)
Format formats the node.
func (*ParenExpr) WalkSubtree ¶
WalkSubtree walks the nodes of the subtree.
type ParenSelect ¶
type ParenSelect struct {
Select SelectStatement
}
ParenSelect is a parenthesized SELECT statement.
func (*ParenSelect) AddOrder ¶
func (node *ParenSelect) AddOrder(order *Order)
AddOrder adds an order by element
func (*ParenSelect) Format ¶
func (node *ParenSelect) Format(buf *TrackedBuffer)
Format formats the node.
func (*ParenSelect) SetLimit ¶
func (node *ParenSelect) SetLimit(limit *Limit)
SetLimit sets the limit clause
func (*ParenSelect) WalkSubtree ¶
func (node *ParenSelect) WalkSubtree(visit Visit) error
WalkSubtree walks the nodes of the subtree.
type ParenTableExpr ¶
type ParenTableExpr struct {
Exprs TableExprs
}
ParenTableExpr represents a parenthesized list of TableExpr.
func (*ParenTableExpr) Format ¶
func (node *ParenTableExpr) Format(buf *TrackedBuffer)
Format formats the node.
func (*ParenTableExpr) WalkSubtree ¶
func (node *ParenTableExpr) WalkSubtree(visit Visit) error
WalkSubtree walks the nodes of the subtree.
type ParsedQuery ¶
type ParsedQuery struct { Query string // contains filtered or unexported fields }
ParsedQuery represents a parsed query where bind locations are precompued for fast substitutions.
func BuildParsedQuery ¶
func BuildParsedQuery(in string, vars ...interface{}) *ParsedQuery
BuildParsedQuery builds a ParsedQuery from the input.
func GenerateParsedQuery ¶
func GenerateParsedQuery(node SQLNode) *ParsedQuery
GenerateParsedQuery returns a ParsedQuery of the ast.
type PlaceholderFormatter ¶
type PlaceholderFormatter interface { FormatPlaceholder() string ResetPlaceholder() }
type PrefixPlaceholderFormatter ¶
func (*PrefixPlaceholderFormatter) FormatPlaceholder ¶
func (p *PrefixPlaceholderFormatter) FormatPlaceholder() string
func (*PrefixPlaceholderFormatter) ResetPlaceholder ¶
func (p *PrefixPlaceholderFormatter) ResetPlaceholder()
type QuestionPlaceholderFormatter ¶
type QuestionPlaceholderFormatter struct{}
func (QuestionPlaceholderFormatter) FormatPlaceholder ¶
func (QuestionPlaceholderFormatter) FormatPlaceholder() string
func (QuestionPlaceholderFormatter) ResetPlaceholder ¶
func (QuestionPlaceholderFormatter) ResetPlaceholder()
type RangeCond ¶
RangeCond represents a BETWEEN or a NOT BETWEEN expression.
func (*RangeCond) Format ¶
func (node *RangeCond) Format(buf *TrackedBuffer)
Format formats the node.
func (*RangeCond) WalkSubtree ¶
WalkSubtree walks the nodes of the subtree.
type RowFormatType ¶
type RowFormatType uint64
RowFormatType is the type for RowFormat
const ( RowFormatDefault RowFormatType = iota + 1 RowFormatDynamic RowFormatFixed RowFormatCompressed RowFormatRedundant RowFormatCompact )
RowFormat types
func (RowFormatType) String ¶
func (r RowFormatType) String() string
type SQLNode ¶
type SQLNode interface { Format(buf *TrackedBuffer) // WalkSubtree calls visit on all underlying nodes // of the subtree, but not the current one. Walking // must be interrupted if visit returns an error. WalkSubtree(visit Visit) error }
SQLNode defines the interface for all nodes generated by the parser.
type SQLVal ¶
SQLVal represents a single value.
func (*SQLVal) WalkSubtree ¶
WalkSubtree walks the nodes of the subtree.
type Select ¶
type Select struct { Cache string Comments Comments Distinct string Hints string SelectExprs SelectExprs From TableExprs Where *Where GroupBy GroupBy Having *Where OrderBy OrderBy Limit *Limit LimitSQLNode SQLNode Lock string }
Select represents a SELECT statement.
func (*Select) AddHaving ¶
AddHaving adds the boolean expression to the HAVING clause as an AND condition. If the expression is an OR clause, it parenthesizes it. Currently, the OR operator is the only one that's lower precedence than AND.
func (*Select) AddWhere ¶
AddWhere adds the boolean expression to the WHERE clause as an AND condition. If the expression is an OR clause, it parenthesizes it. Currently, the OR operator is the only one that's lower precedence than AND.
func (*Select) SetLimitSQLNode ¶
SetLimitSQLNode sets the limit clause.
func (*Select) WalkSubtree ¶
WalkSubtree walks the nodes of the subtree.
type SelectExpr ¶
type SelectExpr interface { SQLNode // contains filtered or unexported methods }
SelectExpr represents a SELECT expression.
type SelectExprs ¶
type SelectExprs []SelectExpr
SelectExprs represents SELECT expressions.
func (SelectExprs) Format ¶
func (node SelectExprs) Format(buf *TrackedBuffer)
Format formats the node.
func (SelectExprs) WalkSubtree ¶
func (node SelectExprs) WalkSubtree(visit Visit) error
WalkSubtree walks the nodes of the subtree.
type SelectStatement ¶
type SelectStatement interface { AddOrder(*Order) SetLimit(*Limit) SQLNode // contains filtered or unexported methods }
SelectStatement any SELECT statement.
type Set ¶
type Set struct { Comments Comments Exprs UpdateExprs }
Set represents a SET statement.
func (*Set) WalkSubtree ¶
WalkSubtree walks the nodes of the subtree.
type Show ¶
Show represents a show statement.
func (*Show) WalkSubtree ¶
WalkSubtree walks the nodes of the subtree.
type SimpleTableExpr ¶
type SimpleTableExpr interface { SQLNode // contains filtered or unexported methods }
SimpleTableExpr represents a simple table expression.
type StarExpr ¶
type StarExpr struct {
TableName TableName
}
StarExpr defines a '*' or 'table.*' expression.
func (*StarExpr) WalkSubtree ¶
WalkSubtree walks the nodes of the subtree.
type Statement ¶
type Statement interface { SQLNode // contains filtered or unexported methods }
Statement represents a statement.
type Subquery ¶
type Subquery struct {
Select SelectStatement
}
Subquery represents a subquery.
func (*Subquery) WalkSubtree ¶
WalkSubtree walks the nodes of the subtree.
type TableExpr ¶
type TableExpr interface { SQLNode // contains filtered or unexported methods }
TableExpr represents a table expression.
type TableExprs ¶
type TableExprs []TableExpr
TableExprs represents a list of table expressions.
func (TableExprs) Format ¶
func (node TableExprs) Format(buf *TrackedBuffer)
Format formats the node.
func (TableExprs) WalkSubtree ¶
func (node TableExprs) WalkSubtree(visit Visit) error
WalkSubtree walks the nodes of the subtree.
type TableIdent ¶
type TableIdent struct {
// contains filtered or unexported fields
}
TableIdent is a case sensitive SQL identifier. It will be escaped with backquotes if necessary.
func NewTableIdent ¶
func NewTableIdent(str string) TableIdent
NewTableIdent creates a new TableIdent.
func NewTableIdentAs ¶
func NewTableIdentAs(str string) TableIdent
NewTableIdentAs creates a new TableIdent.
func (TableIdent) CompliantName ¶
func (node TableIdent) CompliantName() string
CompliantName returns a compliant id name that can be used for a bind var.
func (TableIdent) Format ¶
func (node TableIdent) Format(buf *TrackedBuffer)
Format formats the node.
func (TableIdent) IsEmpty ¶
func (node TableIdent) IsEmpty() bool
IsEmpty returns true if TabIdent is empty.
func (TableIdent) MarshalJSON ¶
func (node TableIdent) MarshalJSON() ([]byte, error)
MarshalJSON marshals into JSON.
func (TableIdent) String ¶
func (node TableIdent) String() string
String returns the unescaped table name. It must not be used for SQL generation. Use sqlparser.String instead. The Stringer conformance is for usage in templates.
func (*TableIdent) UnmarshalJSON ¶
func (node *TableIdent) UnmarshalJSON(b []byte) error
UnmarshalJSON unmarshals from JSON.
func (TableIdent) WalkSubtree ¶
func (node TableIdent) WalkSubtree(visit Visit) error
WalkSubtree walks the nodes of the subtree.
type TableName ¶
type TableName struct {
Name, Qualifier TableIdent
}
TableName represents a table name. Qualifier, if specified, represents a database or keyspace. TableName is a value struct whose fields are case sensitive. This means two TableName vars can be compared for equality and a TableName can also be used as key in a map.
func (TableName) ToViewName ¶
ToViewName returns a TableName acceptable for use as a VIEW. VIEW names are always lowercase, so ToViewName lowercasese the name. Databases are case-sensitive so Qualifier is left untouched.
func (TableName) WalkSubtree ¶
WalkSubtree walks the nodes of the subtree.
type TableNames ¶
type TableNames []TableName
TableNames is a list of TableName.
func (TableNames) Format ¶
func (node TableNames) Format(buf *TrackedBuffer)
Format formats the node.
func (TableNames) WalkSubtree ¶
func (node TableNames) WalkSubtree(visit Visit) error
WalkSubtree walks the nodes of the subtree.
type TableOption ¶
type TableOption struct { Type TableOptionType StrValue string UintValue uint64 }
func (*TableOption) String ¶
func (o *TableOption) String() string
type TableOptionType ¶
type TableOptionType int
const ( TableOptionNone TableOptionType = iota TableOptionEngine TableOptionCharset TableOptionCollate TableOptionAutoIncrement TableOptionComment TableOptionAvgRowLength TableOptionCheckSum TableOptionCompression TableOptionConnection TableOptionPassword TableOptionKeyBlockSize TableOptionMaxRows TableOptionMinRows TableOptionDelayKeyWrite TableOptionRowFormat TableOptionStatsPersistent TableOptionShardRowID TableOptionPackKeys )
TableOption types.
func (TableOptionType) String ¶
func (t TableOptionType) String() string
type Tokenizer ¶
type Tokenizer struct { InStream *strings.Reader AllowComments bool ForceEOF bool Position int LastError string ParseTree Statement // contains filtered or unexported fields }
Tokenizer is the struct used to generate SQL tokens for the parser.
func NewStringTokenizer ¶
NewStringTokenizer creates a new Tokenizer for the sql string.
type TrackedBuffer ¶
type TrackedBuffer struct { IdQuoter PlaceholderFormatter ForceTableAs ForceTableAsMode *bytes.Buffer // contains filtered or unexported fields }
TrackedBuffer is used to rebuild a query from the ast. bindLocations keeps track of locations in the buffer that use bind variables for efficient future substitutions. nodeFormatter is the formatting function the buffer will use to format a node. By default(nil), it's FormatNode. But you can supply a different formatting function if you want to generate a query that's different from the default.
func NewTrackedBuffer ¶
func NewTrackedBuffer(nodeFormatter func(buf *TrackedBuffer, node SQLNode)) *TrackedBuffer
NewTrackedBuffer creates a new TrackedBuffer.
func (*TrackedBuffer) HasBindVars ¶
func (buf *TrackedBuffer) HasBindVars() bool
HasBindVars returns true if the parsed query uses bind vars.
func (*TrackedBuffer) Myprintf ¶
func (buf *TrackedBuffer) Myprintf(format string, values ...interface{})
Myprintf mimics fmt.Fprintf(buf, ...), but limited to Node(%v), Node.Value(%s) and string(%s). It also allows a %a for a value argument, in which case it adds tracking info for future substitutions.
The name must be something other than the usual Printf() to avoid "go vet" warnings due to our custom format specifiers.
func (*TrackedBuffer) ParsedQuery ¶
func (buf *TrackedBuffer) ParsedQuery() *ParsedQuery
ParsedQuery returns a ParsedQuery that contains bind locations for easy substitution.
func (*TrackedBuffer) WriteArg ¶
func (buf *TrackedBuffer) WriteArg(arg string)
WriteArg writes a value argument into the buffer along with tracking information for future substitutions. arg must contain the ":" or "::" prefix.
func (*TrackedBuffer) WriteNode ¶
func (buf *TrackedBuffer) WriteNode(node SQLNode) *TrackedBuffer
WriteNode function, initiates the writing of a single SQLNode tree by passing through to Myprintf with a default format string
type TruncateTable ¶
type TruncateTable struct {
Table TableName
}
func (*TruncateTable) Format ¶
func (node *TruncateTable) Format(buf *TrackedBuffer)
Format formats the node.
func (*TruncateTable) WalkSubtree ¶
func (node *TruncateTable) WalkSubtree(visit Visit) error
WalkSubtree walks the nodes of the subtree.
type TupleEqualityList ¶
TupleEqualityList is for generating equality constraints for tables that have composite primary keys.
func (*TupleEqualityList) EncodeSQL ¶
func (tpl *TupleEqualityList) EncodeSQL(buf *bytes.Buffer)
EncodeSQL generates the where clause constraints for the tuple equality.
type UnaryExpr ¶
UnaryExpr represents a unary value expression.
func (*UnaryExpr) Format ¶
func (node *UnaryExpr) Format(buf *TrackedBuffer)
Format formats the node.
func (*UnaryExpr) WalkSubtree ¶
WalkSubtree walks the nodes of the subtree.
type Union ¶
type Union struct { Type string Left, Right SelectStatement OrderBy OrderBy Limit *Limit Lock string }
Union represents a UNION statement.
func (*Union) WalkSubtree ¶
WalkSubtree walks the nodes of the subtree.
type Update ¶
type Update struct { Comments Comments TableExprs TableExprs Exprs UpdateExprs Where *Where OrderBy OrderBy Limit *Limit }
Update represents an UPDATE statement.
func (*Update) WalkSubtree ¶
WalkSubtree walks the nodes of the subtree.
type UpdateExpr ¶
UpdateExpr represents an update expression.
func (*UpdateExpr) Format ¶
func (node *UpdateExpr) Format(buf *TrackedBuffer)
Format formats the node.
func (*UpdateExpr) WalkSubtree ¶
func (node *UpdateExpr) WalkSubtree(visit Visit) error
WalkSubtree walks the nodes of the subtree.
type UpdateExprs ¶
type UpdateExprs []*UpdateExpr
UpdateExprs represents a list of update expressions.
func (UpdateExprs) Format ¶
func (node UpdateExprs) Format(buf *TrackedBuffer)
Format formats the node.
func (UpdateExprs) WalkSubtree ¶
func (node UpdateExprs) WalkSubtree(visit Visit) error
WalkSubtree walks the nodes of the subtree.
type Use ¶
type Use struct {
DBName TableIdent
}
Use represents a use statement.
func (*Use) WalkSubtree ¶
WalkSubtree walks the nodes of the subtree.
type ValTuple ¶
type ValTuple Exprs
ValTuple represents a tuple of actual values.
func (ValTuple) WalkSubtree ¶
WalkSubtree walks the nodes of the subtree.
type Values ¶
type Values []ValTuple
Values represents a VALUES clause.
func (Values) WalkSubtree ¶
WalkSubtree walks the nodes of the subtree.
type ValuesFuncExpr ¶
ValuesFuncExpr represents a function call.
func (*ValuesFuncExpr) Format ¶
func (node *ValuesFuncExpr) Format(buf *TrackedBuffer)
Format formats the node.
func (*ValuesFuncExpr) WalkSubtree ¶
func (node *ValuesFuncExpr) WalkSubtree(visit Visit) error
WalkSubtree walks the nodes of the subtree.
type Visit ¶
Visit defines the signature of a function that can be used to visit all nodes of a parse tree.
type When ¶
When represents a WHEN sub-expression.
func (*When) WalkSubtree ¶
WalkSubtree walks the nodes of the subtree.