Skip to content

feat(tool/cloud-gemini-data-analytics-query): support Spanner Graph graphIds #4420

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
lcjin-del wants to merge 1 commit into
base: main
Choose a base branch
from
+212 −129
Open

feat(tool/cloud-gemini-data-analytics-query): support Spanner Graph graphIds #4420

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
28 changes: 28 additions & 0 deletions docs/en/integrations/cloudgda/tools/cloud-gda-query.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -140,9 +140,37 @@ configuration error.
| databaseTableReferences | list of object | false | all | Restricts the query to these tables, with optional schema. Each entry takes `tableId` (required) and `schema`. Richer alternative to `tableIds`. |
| priority | string | false | `spannerReference` | Spanner request priority: `LOW`, `MEDIUM`, or `HIGH`. Unsupported values are ignored. |
| requestTag | string | false | `spannerReference` | Tag attached to all Spanner queries, for identifying and monitoring traffic from this tool. |
| graphIds | list of string | false | `spannerReference` | [Spanner Graph](https://cloud.google.com/spanner/docs/graph/overview) property graphs to query. When set, the API generates GQL queries over these graphs. GoogleSQL-dialect databases only. See [Spanner Graph](#spanner-graph). |

## Advanced Usage

### Spanner Graph

To query [Spanner Graph](https://cloud.google.com/spanner/docs/graph/overview)
data, list the property graphs in `graphIds`. The API then generates GQL
(`GRAPH <graph> MATCH ...`) queries over those graphs.

```yaml
kind: tool
name: my-gda-graph-query-tool
type: cloud-gemini-data-analytics-query
source: my-gda-source
description: "Answer questions about the financial transactions graph."
location: ${your_database_location}
context:
datasourceReferences:
spannerReference:
databaseReference:
projectId: "${your_project_id}"
instanceId: "${your_instance_id}"
databaseId: "${your_database_name}"
engine: "GOOGLE_SQL"
graphIds: ["${your_property_graph_name}"]
generationOptions:
generateQueryResult: true
generateNaturalLanguageAnswer: true
```

### Parameterized Secure Views (PSV)

Parameterized Secure Views (PSV) provide a robust mechanism for Row-Level Access Control (RLAC). A PSV is a view defined on a base table that requires mandatory parameters at query time, users cannot read from the view without supplying the defined parameters, and direct access to the underlying base tables is revoked.
Expand Down
86 changes: 42 additions & 44 deletions go.mod
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,19 +6,19 @@ replace github.com/apache/thrift => github.com/apache/thrift v0.23.0

require (
cloud.google.com/go/alloydbconn v1.18.4
cloud.google.com/go/bigquery v1.77.0
cloud.google.com/go/bigquery v1.85.0
cloud.google.com/go/bigtable v1.50.0
cloud.google.com/go/cloudsqlconn v1.22.0
cloud.google.com/go/datacatalog v1.32.0
cloud.google.com/go/dataplex v1.35.0
cloud.google.com/go/dataproc/v2 v2.23.0
cloud.google.com/go/dataproc/v2 v2.26.0
cloud.google.com/go/firestore v1.22.0
cloud.google.com/go/geminidataanalytics v1.5.0
cloud.google.com/go/logging v1.18.0
cloud.google.com/go/longrunning v1.2.0
cloud.google.com/go/monitoring v1.29.0
cloud.google.com/go/geminidataanalytics v1.8.0
cloud.google.com/go/logging v1.20.0
cloud.google.com/go/longrunning v1.3.0
cloud.google.com/go/monitoring v1.30.0
cloud.google.com/go/resourcemanager v1.15.0
cloud.google.com/go/spanner v1.95.1
cloud.google.com/go/spanner v1.96.1
cloud.google.com/go/storage v1.62.3
cloud.google.com/go/trace v1.16.0
github.com/ClickHouse/clickhouse-go/v2 v2.46.0
Expand Down Expand Up @@ -48,7 +48,7 @@ require (
github.com/golang-jwt/jwt/v5 v5.3.1
github.com/google/go-cmp v0.7.0
github.com/google/uuid v1.6.0
github.com/googleapis/gax-go/v2 v2.23.0
github.com/googleapis/gax-go/v2 v2.27.0
github.com/jackc/pgx/v5 v5.10.0
github.com/jmoiron/sqlx v1.4.0
github.com/looker-open-source/sdk-codegen/go v0.26.10
Expand All @@ -72,22 +72,22 @@ require (
github.com/yugabyte/pgx/v5 v5.5.3-yb-5
go.mongodb.org/mongo-driver/v2 v2.7.0
go.opentelemetry.io/contrib/propagators/autoprop v0.69.0
go.opentelemetry.io/otel v1.45.0
go.opentelemetry.io/otel v1.47.0
go.opentelemetry.io/otel/exporters/otlp/otlpmetric/otlpmetrichttp v1.45.0
go.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracehttp v1.45.0
go.opentelemetry.io/otel/metric v1.45.0
go.opentelemetry.io/otel/sdk v1.45.0
go.opentelemetry.io/otel/sdk/metric v1.45.0
go.opentelemetry.io/otel/trace v1.45.0
golang.org/x/mod v0.41.0
golang.org/x/oauth2 v0.36.0
golang.org/x/sync v0.23.0
google.golang.org/api v0.287.1
go.opentelemetry.io/otel/metric v1.47.0
go.opentelemetry.io/otel/sdk v1.47.0
go.opentelemetry.io/otel/sdk/metric v1.47.0
go.opentelemetry.io/otel/trace v1.47.0
golang.org/x/mod v0.42.0
golang.org/x/oauth2 v0.37.0
golang.org/x/sync v0.24.0
google.golang.org/api v0.304.0
google.golang.org/genai v1.61.0
google.golang.org/genproto v0.0.0-20260519071638-aa98bba5eb94
google.golang.org/genproto/googleapis/api v0.0.0-20260803160001-6ac0973c030d
google.golang.org/grpc v1.83.2
google.golang.org/protobuf v1.36.11
google.golang.org/genproto v0.0.0-20261012220534-4341edf3f941
google.golang.org/genproto/googleapis/api v0.0.0-20261012220534-4341edf3f941
google.golang.org/grpc v1.84.0
google.golang.org/protobuf v1.36.12
modernc.org/sqlite v1.52.0
)

Expand All @@ -97,10 +97,10 @@ require (
cel.dev/expr v0.25.2 // indirect
cloud.google.com/go v0.123.0 // indirect
cloud.google.com/go/alloydb v1.26.0 // indirect
cloud.google.com/go/auth v0.20.0 // indirect
cloud.google.com/go/auth/oauth2adapt v0.2.8 // indirect
cloud.google.com/go/compute/metadata v0.9.0 // indirect
cloud.google.com/go/iam v1.11.0 // indirect
cloud.google.com/go/auth v0.24.1-0.20261001053825-dbc26066f70a // indirect
cloud.google.com/go/auth/oauth2adapt v0.3.0 // indirect
cloud.google.com/go/compute/metadata v0.10.0 // indirect
cloud.google.com/go/iam v1.14.0 // indirect
dario.cat/mergo v1.0.2 // indirect
filippo.io/edwards25519 v1.2.0 // indirect
github.com/99designs/go-keychain v0.0.0-20191008050251-8e49817e8af4 // indirect
Expand All @@ -112,7 +112,7 @@ require (
github.com/BurntSushi/toml v1.6.0 // indirect
github.com/ClickHouse/ch-go v0.71.0 // indirect
github.com/GoogleCloudPlatform/grpc-gcp-go/grpcgcp v1.6.0 // indirect
github.com/GoogleCloudPlatform/opentelemetry-operations-go/detectors/gcp v1.33.0 // indirect
github.com/GoogleCloudPlatform/opentelemetry-operations-go/detectors/gcp v1.34.0 // indirect
github.com/GoogleCloudPlatform/opentelemetry-operations-go/internal/resourcemapping v0.57.0 // indirect
github.com/Microsoft/go-winio v0.6.2 // indirect
github.com/PuerkitoBio/goquery v1.10.3 // indirect
Expand Down Expand Up @@ -159,7 +159,6 @@ require (
github.com/couchbaselabs/gocbconnstr/v2 v2.0.0 // indirect
github.com/cpuguy83/dockercfg v0.3.2 // indirect
github.com/danieljoos/wincred v1.2.2 // indirect
github.com/davecgh/go-spew v1.1.2-0.20180830191138-d8f796af33cc // indirect
github.com/distribution/reference v0.6.0 // indirect
github.com/docker/go-connections v0.6.0 // indirect
github.com/docker/go-units v0.5.0 // indirect
Expand All @@ -169,7 +168,7 @@ require (
github.com/envoyproxy/go-control-plane/envoy v1.37.0 // indirect
github.com/envoyproxy/protoc-gen-validate v1.3.3 // indirect
github.com/fatih/color v1.15.0 // indirect
github.com/felixge/httpsnoop v1.0.4 // indirect
github.com/felixge/httpsnoop v1.1.0 // indirect
github.com/gabriel-vasile/mimetype v1.4.13 // indirect
github.com/go-faster/city v1.0.1 // indirect
github.com/go-faster/errors v0.7.1 // indirect
Expand All @@ -190,8 +189,8 @@ require (
github.com/golang/groupcache v0.0.0-20241129210726-2c02b8208cf8 // indirect
github.com/golang/snappy v1.0.0 // indirect
github.com/google/flatbuffers v25.2.10+incompatible // indirect
github.com/google/s2a-go v0.1.9 // indirect
github.com/googleapis/enterprise-certificate-proxy v0.3.17 // indirect
github.com/google/s2a-go v0.1.11 // indirect
github.com/googleapis/enterprise-certificate-proxy v0.3.23 // indirect
github.com/gorilla/websocket v1.5.3 // indirect
github.com/grpc-ecosystem/grpc-gateway/v2 v2.29.0 // indirect
github.com/gsterjov/go-libsecret v0.0.0-20161001094733-a6f4afe4910c // indirect
Expand Down Expand Up @@ -242,15 +241,14 @@ require (
github.com/pierrec/lz4/v4 v4.1.25 // indirect
github.com/pkg/browser v0.0.0-20240102092130-5ac0b6a4141c // indirect
github.com/planetscale/vtprotobuf v0.6.1-0.20240319094008-0393e58bdf10 // indirect
github.com/pmezard/go-difflib v1.0.1-0.20181226105442-5d4384ee4fb2 // indirect
github.com/power-devops/perfstat v0.0.0-20240221224432-82ca36839d55 // indirect
github.com/remyoudompheng/bigfft v0.0.0-20230129092748-24d4a6f8daec // indirect
github.com/segmentio/asm v1.2.1 // indirect
github.com/shirou/gopsutil/v4 v4.26.5 // indirect
github.com/shopspring/decimal v1.4.0 // indirect
github.com/sirupsen/logrus v1.9.4 // indirect
github.com/spiffe/go-spiffe/v2 v2.7.0 // indirect
github.com/stretchr/testify v1.11.1 // indirect
github.com/spiffe/go-spiffe/v2 v2.8.1 // indirect
github.com/stretchr/testify v1.12.1 // indirect
github.com/tidwall/gjson v1.17.1 // indirect
github.com/tidwall/match v1.1.1 // indirect
github.com/tidwall/pretty v1.2.0 // indirect
Expand All @@ -273,25 +271,25 @@ require (
go.opentelemetry.io/contrib/propagators/jaeger v1.44.0 // indirect
go.opentelemetry.io/contrib/propagators/ot v1.44.0 // indirect
go.opentelemetry.io/otel/exporters/otlp/otlptrace v1.45.0 // indirect
go.opentelemetry.io/otel/log v1.47.0 // indirect
go.opentelemetry.io/proto/otlp v1.11.0 // indirect
go.uber.org/atomic v1.11.0 // indirect
go.uber.org/multierr v1.11.0 // indirect
go.uber.org/zap v1.27.1 // indirect
go.yaml.in/yaml/v3 v3.0.4 // indirect
golang.org/x/crypto v0.57.0 // indirect
go.yaml.in/yaml/v3 v3.0.5 // indirect
golang.org/x/crypto v0.58.0 // indirect
golang.org/x/exp v0.0.0-20251023183803-a4bb9ffd2546 // indirect
golang.org/x/net v0.60.0 // indirect
golang.org/x/sys v0.48.0 // indirect
golang.org/x/telemetry v0.0.0-20260811182544-a038080d80e5 // indirect
golang.org/x/term v0.46.0 // indirect
golang.org/x/text v0.42.0 // indirect
golang.org/x/time v0.15.0 // indirect
golang.org/x/tools v0.49.0 // indirect
golang.org/x/net v0.61.0 // indirect
golang.org/x/sys v0.49.0 // indirect
golang.org/x/telemetry v0.0.0-20260924152758-ed294f943157 // indirect
golang.org/x/term v0.47.0 // indirect
golang.org/x/text v0.43.0 // indirect
golang.org/x/time v0.16.0 // indirect
golang.org/x/tools v0.51.0 // indirect
golang.org/x/xerrors v0.0.0-20240903120638-7835f813f4da // indirect
google.golang.org/genproto/googleapis/rpc v0.0.0-20260803160001-6ac0973c030d // indirect
google.golang.org/genproto/googleapis/rpc v0.0.0-20261012220534-4341edf3f941 // indirect
gopkg.in/inf.v0 v0.9.1 // indirect
gopkg.in/ini.v1 v1.67.0 // indirect
gopkg.in/yaml.v3 v3.0.1 // indirect
modernc.org/libc v1.72.3 // indirect
modernc.org/mathutil v1.7.1 // indirect
modernc.org/memory v1.11.0 // indirect
Expand Down
Loading
Loading