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
..		03-May-2022	-
admin/	H	02-Apr-2021	-	5,960	4,241
apiv1/	H	02-Apr-2021	-	2,630	1,916
internal/	H	02-Apr-2021	-	2,722	2,191
spannertest/	H	02-Apr-2021	-	6,220	4,977
spansql/	H	02-Apr-2021	-	5,529	4,301
CHANGES.md	H A D	02-Apr-2021	22.2 KiB	370	300
README.md	H A D	02-Apr-2021	934	35	29
batch.go	H A D	02-Apr-2021	11.6 KiB	380	269
batch_test.go	H A D	02-Apr-2021	4.1 KiB	171	135
big_pdml_test.go	H A D	02-Apr-2021	1.7 KiB	61	34
client.go	H A D	02-Apr-2021	18.4 KiB	551	353
client_benchmarks_test.go	H A D	02-Apr-2021	12.2 KiB	419	344
client_test.go	H A D	02-Apr-2021	83.2 KiB	2,596	2,297
cmp_test.go	H A D	02-Apr-2021	1.8 KiB	61	39
doc.go	H A D	02-Apr-2021	12 KiB	363	2
emulator_test.sh	H A D	02-Apr-2021	1.5 KiB	47	19
errors.go	H A D	02-Apr-2021	6.3 KiB	204	123
errors112.go	H A D	02-Apr-2021	1.2 KiB	34	8
errors113.go	H A D	02-Apr-2021	1.2 KiB	34	8
errors_test.go	H A D	02-Apr-2021	4.3 KiB	104	79
examples_test.go	H A D	02-Apr-2021	19.7 KiB	770	603
go.mod	H A D	02-Apr-2021	439	17	14
go.sum	H A D	02-Apr-2021	45.7 KiB	466	465
go_mod_tidy_hack.go	H A D	02-Apr-2021	918	23	2
integration_test.go	H A D	02-Apr-2021	108.8 KiB	3,568	3,056
key.go	H A D	02-Apr-2021	12.7 KiB	436	216
key_test.go	H A D	02-Apr-2021	12.4 KiB	489	456
mutation.go	H A D	02-Apr-2021	14 KiB	435	219
mutation_test.go	H A D	02-Apr-2021	17.2 KiB	621	564
oc_test.go	H A D	02-Apr-2021	7.7 KiB	288	234
pdml.go	H A D	02-Apr-2021	4.6 KiB	126	79
pdml_test.go	H A D	02-Apr-2021	5 KiB	169	134
protoutils.go	H A D	02-Apr-2021	3.2 KiB	123	79
read.go	H A D	02-Apr-2021	25.7 KiB	798	507
read_test.go	H A D	02-Apr-2021	50.1 KiB	1,789	1,554
retry.go	H A D	02-Apr-2021	4.6 KiB	155	102
retry_test.go	H A D	02-Apr-2021	2.9 KiB	91	68
row.go	H A D	02-Apr-2021	10.3 KiB	309	162
row_test.go	H A D	02-Apr-2021	48.3 KiB	1,767	1,583
session.go	H A D	02-Apr-2021	54.5 KiB	1,718	1,142
session_test.go	H A D	02-Apr-2021	61 KiB	1,979	1,518
sessionclient.go	H A D	02-Apr-2021	11.1 KiB	308	205
sessionclient_test.go	H A D	02-Apr-2021	14.3 KiB	452	381
statement.go	H A D	02-Apr-2021	2.9 KiB	94	52
statement_test.go	H A D	02-Apr-2021	7.2 KiB	207	168
stats.go	H A D	02-Apr-2021	5.4 KiB	170	106
timestampbound.go	H A D	02-Apr-2021	8.8 KiB	243	107
timestampbound_test.go	H A D	02-Apr-2021	5.9 KiB	207	169
transaction.go	H A D	02-Apr-2021	42.6 KiB	1,320	853
transaction_test.go	H A D	02-Apr-2021	20.7 KiB	680	551
value.go	H A D	02-Apr-2021	80.8 KiB	3,134	2,709
value_benchmarks_test.go	H A D	02-Apr-2021	5.7 KiB	233	197
value_test.go	H A D	02-Apr-2021	92.5 KiB	2,586	2,344