cloud.google.com/go/spanner

## Cloud Spanner [![Go Reference](https://pkg.go.dev/badge/cloud.google.com/go/spanner.svg)](https://pkg.go.dev/cloud.google.com/go/spanner)

- [About Cloud Spanner](https://cloud.google.com/spanner/)
- [API documentation](https://cloud.google.com/spanner/docs)
- [Go client documentation](https://pkg.go.dev/cloud.google.com/go/spanner)

### Example Usage

First create a `spanner.Client` to use throughout your application:

[snip]:# (spanner-1)
```go
client, err := spanner.NewClient(ctx, "projects/P/instances/I/databases/D")
if err != nil {
	log.Fatal(err)
}
```

[snip]:# (spanner-2)
```go
// Simple Reads And Writes
_, err = client.Apply(ctx, []*spanner.Mutation{
	spanner.Insert("Users",
		[]string{"name", "email"},
		[]interface{}{"alice", "a@example.com"})})
if err != nil {
	log.Fatal(err)
}
row, err := client.Single().ReadRow(ctx, "Users",
	spanner.Key{"alice"}, []string{"email"})
if err != nil {
	log.Fatal(err)
}
```
Name		Date	Size	#Lines	LOC
..		02-Sep-2021	-
admin/	H	02-Sep-2021	-	6,372	4,460
apiv1/	H	02-Sep-2021	-	2,796	2,011
internal/	H	02-Sep-2021	-	2,725	2,193
spannertest/	H	02-Sep-2021	-	6,368	5,117
spansql/	H	02-Sep-2021	-	6,219	4,914
CHANGES.md	H A D	02-Sep-2021	29.7 KiB	462	347
README.md	H A D	02-Sep-2021	933	34	29
batch.go	H A D	02-Sep-2021	13 KiB	400	279
batch_test.go	H A D	02-Sep-2021	4.2 KiB	173	137
big_pdml_test.go	H A D	02-Sep-2021	1.7 KiB	62	34
client.go	H A D	02-Sep-2021	19.1 KiB	571	366
client_benchmarks_test.go	H A D	02-Sep-2021	12.2 KiB	419	344
client_test.go	H A D	02-Sep-2021	92.2 KiB	2,846	2,507
cmp_test.go	H A D	02-Sep-2021	2 KiB	67	45
doc.go	H A D	02-Sep-2021	12 KiB	363	2
emulator_test.sh	H A D	02-Sep-2021	1.5 KiB	47	19
errors.go	H A D	02-Sep-2021	6.3 KiB	204	123
errors112.go	H A D	02-Sep-2021	1.2 KiB	35	8
errors113.go	H A D	02-Sep-2021	1.2 KiB	35	8
errors_test.go	H A D	02-Sep-2021	4.3 KiB	104	79
examples_test.go	H A D	02-Sep-2021	19.7 KiB	770	603
go.mod	H A D	02-Sep-2021	439	17	14
go.sum	H A D	02-Sep-2021	52.4 KiB	536	535
go_mod_tidy_hack.go	H A D	02-Sep-2021	937	24	2
integration_test.go	H A D	02-Sep-2021	112.5 KiB	3,661	3,136
key.go	H A D	02-Sep-2021	12.7 KiB	436	216
key_test.go	H A D	02-Sep-2021	12.4 KiB	489	456
mutation.go	H A D	02-Sep-2021	14 KiB	435	219
mutation_test.go	H A D	02-Sep-2021	17.2 KiB	621	564
oc_test.go	H A D	02-Sep-2021	7.7 KiB	288	234
pdml.go	H A D	02-Sep-2021	4.6 KiB	126	79
pdml_test.go	H A D	02-Sep-2021	5.4 KiB	181	144
protoutils.go	H A D	02-Sep-2021	3.3 KiB	127	82
read.go	H A D	02-Sep-2021	25.7 KiB	798	507
read_test.go	H A D	02-Sep-2021	49.9 KiB	1,784	1,551
retry.go	H A D	02-Sep-2021	4.6 KiB	155	102
retry_test.go	H A D	02-Sep-2021	2.9 KiB	91	68
row.go	H A D	02-Sep-2021	10.5 KiB	316	165
row_test.go	H A D	02-Sep-2021	49.2 KiB	1,793	1,605
session.go	H A D	02-Sep-2021	55.1 KiB	1,727	1,142
session_test.go	H A D	02-Sep-2021	61.3 KiB	1,990	1,527
sessionclient.go	H A D	02-Sep-2021	11.1 KiB	308	205
sessionclient_test.go	H A D	02-Sep-2021	14.3 KiB	452	381
statement.go	H A D	02-Sep-2021	2.6 KiB	84	43
statement_test.go	H A D	02-Sep-2021	6.9 KiB	196	158
stats.go	H A D	02-Sep-2021	5.4 KiB	170	106
timestampbound.go	H A D	02-Sep-2021	8.8 KiB	243	107
timestampbound_test.go	H A D	02-Sep-2021	5.9 KiB	207	169
transaction.go	H A D	02-Sep-2021	43.4 KiB	1,335	861
transaction_test.go	H A D	02-Sep-2021	20.7 KiB	680	551
value.go	H A D	02-Sep-2021	88.3 KiB	3,425	2,959
value_benchmarks_test.go	H A D	02-Sep-2021	5.7 KiB	233	197
value_test.go	H A D	02-Sep-2021	101.5 KiB	2,743	2,481