{"id":19420112,"url":"https://github.com/einride/spanner-aip-go","last_synced_at":"2026-03-02T12:01:07.680Z","repository":{"id":36977579,"uuid":"326995747","full_name":"einride/spanner-aip-go","owner":"einride","description":"Go SDK for implementing Spanner persistance for resource-oriented APIs.","archived":false,"fork":false,"pushed_at":"2025-04-17T06:30:55.000Z","size":886,"stargazers_count":9,"open_issues_count":0,"forks_count":2,"subscribers_count":7,"default_branch":"master","last_synced_at":"2025-04-17T21:03:35.437Z","etag":null,"topics":["aip","cloud-spanner","go","golang","grpc","spanner"],"latest_commit_sha":null,"homepage":"https://pkg.go.dev/go.einride.tech/aip-spanner","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/einride.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-01-05T12:43:55.000Z","updated_at":"2025-04-17T06:30:58.000Z","dependencies_parsed_at":"2024-02-06T14:44:07.643Z","dependency_job_id":"e17cc75f-a24a-419f-929b-de40f920c91b","html_url":"https://github.com/einride/spanner-aip-go","commit_stats":null,"previous_names":[],"tags_count":83,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/einride%2Fspanner-aip-go","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/einride%2Fspanner-aip-go/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/einride%2Fspanner-aip-go/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/einride%2Fspanner-aip-go/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/einride","download_url":"https://codeload.github.com/einride/spanner-aip-go/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250643489,"owners_count":21464185,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["aip","cloud-spanner","go","golang","grpc","spanner"],"created_at":"2024-11-10T13:21:10.395Z","updated_at":"2026-01-16T19:42:20.493Z","avatar_url":"https://github.com/einride.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Spanner AIP Go\n\n[![PkgGoDev](https://pkg.go.dev/badge/go.einride.tech/spanner-aip)](https://pkg.go.dev/go.einride.tech/spanner-aip)\n[![GoReportCard](https://goreportcard.com/badge/go.einride.tech/spanner-aip)](https://goreportcard.com/report/go.einride.tech/spanner-aip)\n[![Codecov](https://codecov.io/gh/einride/spanner-aip-go/branch/master/graph/badge.svg)](https://codecov.io/gh/einride/spanner-aip-go)\n\nAdd-on to the [AIP Go SDK](https://github.com/einride/aip-go) for implementing\n[Cloud Spanner](https://cloud.google.com/spanner) persistance for\n[resource-oriented APIs](https://aip.dev).\n\n**Experimental**: This library is under active development and breaking changes\nto config files, APIs and generated code are expected between releases.\n\n## Documentation\n\nSee [https://aip.dev](https://aip.dev) for the full AIP documentation and the\n[Cloud Spanner documentation](https://cloud.google.com/spanner/docs).\n\n## Usage\n\n### Installing\n\n```bash\n$ go get -u go.einride.tech/spanner-aip\n```\n\n### Code generation config\n\nUse a YAML config file to specify the schema to generate code from:\n\n```yaml\ndatabases:\n  - name: music\n    schema:\n      - \"testdata/migrations/music/*.up.sql\"\n    package:\n      name: musicdb\n      path: ./internal/examples/musicdb\n```\n\n### Code generation\n\n```bash\n$ go run go.einride.tech/spanner-aip generate\n```\n\n### Reading data\n\n#### Get\n\n```go\npackage main\n\nimport (\n\t\"context\"\n\n\t\"cloud.google.com/go/spanner\"\n\t\"go.einride.tech/spanner-aip/internal/examples/musicdb\"\n)\n\nfunc main() {\n\tctx := context.Background()\n\tclient, err := spanner.NewClient(\n\t\tctx, \"projects/\u003cPROJECT\u003e/instances/\u003cINSTANCE\u003e/databases/\u003cDATABASE\u003e\",\n\t)\n\tif err != nil {\n\t\tpanic(err) // TODO: Handle error.\n\t}\n\tsinger, err := musicdb.Singers(client.Single()).Get(ctx, musicdb.SingersKey{\n\t\tSingerId: 42,\n\t})\n\tif err != nil {\n\t\tpanic(err) // TODO: Handle error.\n\t}\n\t_ = singer // TODO: Use singer.\n}\n```\n\n#### List\n\n```go\npackage main\n\nimport (\n\t\"context\"\n\n\t\"cloud.google.com/go/spanner\"\n\t\"cloud.google.com/go/spanner/spansql\"\n\t\"go.einride.tech/spanner-aip/internal/examples/musicdb\"\n)\n\nfunc main() {\n\tctx := context.Background()\n\tclient, err := spanner.NewClient(\n\t\tctx, \"projects/\u003cPROJECT\u003e/instances/\u003cINSTANCE\u003e/databases/\u003cDATABASE\u003e\",\n\t)\n\tif err != nil {\n\t\tpanic(err) // TODO: Handle error.\n\t}\n\t// SELECT * FROM Singers\n\t// WHERE LastName = \"Sinatra\"\n\t// ORDER BY FirstName DESC\n\t// LIMIT 5\n\t// OFFSET 10\n\tif err := musicdb.Singers(client.Single()).List(ctx, musicdb.ListQuery{\n\t\tWhere: spansql.ComparisonOp{\n\t\t\tOp:  spansql.Eq,\n\t\t\tLHS: musicdb.Descriptor().Singers().LastName().ColumnID(),\n\t\t\tRHS: spansql.StringLiteral(\"Sinatra\"),\n\t\t},\n\t\tOrder: []spansql.Order{\n\t\t\t{Expr: musicdb.Descriptor().Singers().FirstName().ColumnID(), Desc: true},\n\t\t},\n\t\tLimit:  5,\n\t\tOffset: 10,\n\t}).Do(func(singer *musicdb.SingersRow) error {\n\t\t_ = singer // TODO: Use singer.\n\t\treturn nil\n\t}); err != nil {\n\t\tpanic(err) // TODO: Handle error.\n\t}\n}\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Feinride%2Fspanner-aip-go","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Feinride%2Fspanner-aip-go","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Feinride%2Fspanner-aip-go/lists"}