1## Cloud Spanner [![GoDoc](https://godoc.org/cloud.google.com/go/spanner?status.svg)](https://godoc.org/cloud.google.com/go/spanner)
2
3- [About Cloud Spanner](https://cloud.google.com/spanner/)
4- [API documentation](https://cloud.google.com/spanner/docs)
5- [Go client documentation](https://godoc.org/cloud.google.com/go/spanner)
6
7### Example Usage
8
9First create a `spanner.Client` to use throughout your application:
10
11[snip]:# (spanner-1)
12```go
13client, err := spanner.NewClient(ctx, "projects/P/instances/I/databases/D")
14if err != nil {
15	log.Fatal(err)
16}
17```
18
19[snip]:# (spanner-2)
20```go
21// Simple Reads And Writes
22_, err = client.Apply(ctx, []*spanner.Mutation{
23	spanner.Insert("Users",
24		[]string{"name", "email"},
25		[]interface{}{"alice", "a@example.com"})})
26if err != nil {
27	log.Fatal(err)
28}
29row, err := client.Single().ReadRow(ctx, "Users",
30	spanner.Key{"alice"}, []string{"email"})
31if err != nil {
32	log.Fatal(err)
33}
34```