pixeldrain/gocqlx
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 1 Wiki Activity

qb.BatchBuilder: Remove deprecated flag and add comments on its limitation and warning

Browse Source
This commit is contained in:
xiang.wang
2020-06-02 11:31:46 +08:00
committed by Michal Jan Matczuk
parent d76ea6c678
commit 1083dcf024
1 changed files with 7 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

7
qb/batch.go
View File

@@ -23,6 +23,13 @@ type BatchBuilder struct {
} }
// Batch returns a new BatchBuilder. // Batch returns a new BatchBuilder.
// BatchBuilder encapsulates batch cqls as one ordinary gocql.Query for convenience.
// Below are the limitations of encapsulating batch cqls based on gocql.Query instead of gocql.Batch:
// * gocql.Batch has some more batch specific check, such as BatchSize(65535).
// * gocql.Batch use BatchObserver instead of QueryObserver.
// * gocql.Batch has cancelBatch call back.
// * gocql.Batch prepares the included statements separately, which is more efficient.
// In contrast, gocqlx.qb.BatchBuilder, which is based on gocql.Query, prepares the whole batch statements as one ordinary query.
// //
// Deprecated: Please use gocql.Session.NewBatch() instead. // Deprecated: Please use gocql.Session.NewBatch() instead.
func Batch() *BatchBuilder { func Batch() *BatchBuilder {