Google Git
Sign in
apache / cassandra-gocql-driver / refs/tags/go1.1
tag835716d46782ed3688c2e24a484f1ff15b20514e
taggerChristoph Hack <christoph@tux21b.org>Wed Jul 16 10:39:06 2014 +0200
object162ac032e491df376b4727d9d434a78ddd0f1266 
tagged last go1.1 compatible version
commit162ac032e491df376b4727d9d434a78ddd0f1266[log] [tgz]
authorBen Hood <0x6e6562@gmail.com>Tue Jul 15 09:13:41 2014 +0100
committerBen Hood <0x6e6562@gmail.com>Tue Jul 15 09:13:41 2014 +0100
treeefad1db58156360e1b1a99bb4dc02ccdf0de577c
parent20ba163d1ee6e2123dcf311a774c499ca3624fa1 [diff]
parentd0d29fe034d600c0a98a7ebd06cddd5a81089d6f [diff]
Merge pull request #194 from phillipCouto/cass1.2-fails

Added skip statements for tests using batchs when proto = 1
tree: efad1db58156360e1b1a99bb4dc02ccdf0de577c
  1. website/
  2. .gitignore
  3. .travis.yml
  4. AUTHORS
  5. cass1batch_test.go
  6. cassandra_test.go
  7. cluster.go
  8. compressor.go
  9. conn.go
  10. conn_go11.go
  11. conn_go12.go
  12. conn_test.go
  13. connectionpool.go
  14. CONTRIBUTING.md
  15. doc.go
  16. errors.go
  17. errors_test.go
  18. frame.go
  19. helpers.go
  20. integration.sh
  21. LICENSE
  22. marshal.go
  23. marshal_test.go
  24. policies.go
  25. README.md
  26. session.go
  27. topology.go
  28. uuid.go
  29. uuid_test.go
README.md

gocql

Build Status GoDoc

Package Status: Alpha

Package gocql implements a fast and robust Cassandra client for the Go programming language.

Project Website: http://gocql.github.io/
API documentation: http://godoc.org/github.com/gocql/gocql
Discussions: https://groups.google.com/forum/#!forum/gocql

Installation

go get github.com/gocql/gocql

Features

  • Modern Cassandra client for Cassandra 1.2 and 2.0
  • Automatic type conversations between Cassandra and Go
    • Support for all common types including sets, lists and maps
    • Custom types can implement a Marshaler and Unmarshaler interface
    • Strict type conversations without any loss of precision
    • Built-In support for UUIDs (version 1 and 4)
  • Support for logged, unlogged and counter batches
  • Cluster management
    • Automatic reconnect on connection failures with exponential falloff
    • Round robin distribution of queries to different hosts
    • Round robin distribution of queries to different connections on a host
    • Each connection can execute up to 128 concurrent queries
    • Optional automatic discovery of nodes
  • Iteration over paged results with configurable page size
  • Optional frame compression (using snappy)
  • Automatic query preparation
  • Support for query tracing

Please visit the Roadmap page to see what is on the horizion.

Important Default Keyspace Changes

gocql no longer supports executing “use ” statements to simplfy the library. The user still has the ability to define the default keyspace for connections but now the keyspace can only be defined before a session is created. Queries can still access keyspaces by indicating the keyspace in the query:

SELECT * FROM example2.table;

Example of correct usage:

	cluster := gocql.NewCluster("192.168.1.1", "192.168.1.2", "192.168.1.3")
	cluster.Keyspace = "example"
	...
	session, err := cluster.CreateSession()

Example of incorrect usage:

	cluster := gocql.NewCluster("192.168.1.1", "192.168.1.2", "192.168.1.3")
	cluster.Keyspace = "example"
	...
	session, err := cluster.CreateSession()

	if err = session.Query("use example2").Exec(); err != nil {
		log.Fatal(err)
	}

This will result in an err being returned from the session.Query line as the user is trying to execute a “use” statement.

Example

package main

import (
	"fmt"
	"log"

	"github.com/gocql/gocql"
)

func main() {
	// connect to the cluster
	cluster := gocql.NewCluster("192.168.1.1", "192.168.1.2", "192.168.1.3")
	cluster.Keyspace = "example"
	cluster.Consistency = gocql.Quorum
	session, _ := cluster.CreateSession()
	defer session.Close()

	// insert a tweet
	if err := session.Query(`INSERT INTO tweet (timeline, id, text) VALUES (?, ?, ?)`,
		"me", gocql.TimeUUID(), "hello world").Exec(); err != nil {
		log.Fatal(err)
	}

	var id gocql.UUID
	var text string

	// select a single tweet
	if err := session.Query(`SELECT id, text FROM tweet WHERE timeline = ? LIMIT 1`,
		"me").Consistency(gocql.One).Scan(&id, &text); err != nil {
		log.Fatal(err)
	}
	fmt.Println("Tweet:", id, text)

	// list all tweets
	iter := session.Query(`SELECT id, text FROM tweet WHERE timeline = ?`, "me").Iter()
	for iter.Scan(&id, &text) {
		fmt.Println("Tweet:", id, text)
	}
	if err := iter.Close(); err != nil {
		log.Fatal(err)
	}
}

Other Projects

  • cqlc generates gocql compliant code from your Cassandra schema so that you can write type safe CQL statements in Go with a natural query syntax.
  • gocqldriver is the predecessor of gocql based on Go‘s “database/sql” package. This project isn’t maintained anymore, because Cassandra wasn't a good fit for the traditional “database/sql” API. Use this package instead.

License

Copyright (c) 2012-2014 The gocql Authors. All rights reserved. Use of this source code is governed by a BSD-style license that can be found in the LICENSE file.