Add analyze support for GoogleSQL via zetajones

Wire the GoogleSQL (zetajones) engine into sqlc's native static analysis so
`sqlc analyze --dialect googlesql` infers result columns and parameters from a
schema, mirroring the existing PostgreSQL, MySQL, and SQLite support.

Changes:
- Add the `googlesql` engine constant and register its parser, catalog, and
  selector in the compiler.
- Accept `googlesql` as an `analyze` dialect and document it (and the
  previously-undocumented `parse` dialect).
- Keep named parameters in their native `@name` form when rewriting, since
  GoogleSQL supports named parameters (Spanner requires them), and quote
  identifiers with backticks during star expansion.
- Include a statement's leading comment in its reported location so the
  `-- name:` annotation is captured; this also fixes name extraction for
  `sqlc parse --dialect googlesql`.
- Initialize the list fields the compiler walks unconditionally
  (ReturningList, INSERT ... VALUES TargetList, UPDATE FromClause), fixing
  nil-pointer panics when analyzing INSERT/UPDATE/DELETE statements.

Add end-to-end coverage for basic SELECT analysis and for INSERT/UPDATE/DELETE
(including THEN RETURN).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01CmGTScco7g1CNc5LjPSJVd

Author: claude

docs/howto/analyze.md

@@ -18,8 +18,8 @@ provided. The schema is always read from the `--schema` file.
 
 ## Flags
 
-- `--dialect`, `-d` - The SQL dialect to use. One of `postgresql`, `mysql`, or
-  `sqlite`. Required.
+- `--dialect`, `-d` - The SQL dialect to use. One of `postgresql`, `mysql`,
+  `sqlite`, or `googlesql`. Required.
 - `--schema`, `-s` - Path to the schema (DDL) file. Required.
 - `--ast` - Include each statement's AST in the output. Defaults to `false`.
 

docs/howto/parse.md

@@ -20,7 +20,7 @@ provided.
 ## Flags
 
 - `--dialect`, `-d` - The SQL dialect to use. One of `postgresql`, `mysql`,
-  `sqlite`, or `clickhouse`. Required.
+  `sqlite`, `clickhouse`, or `googlesql`. Required.
 
 ## Examples
 

internal/cmd/analyze.go

@@ -37,6 +37,9 @@ Examples:
   # Analyze a SQLite query
   sqlc analyze --dialect sqlite --schema schema.sql query.sql
 
+  # Analyze a GoogleSQL (BigQuery, Spanner) query
+  sqlc analyze --dialect googlesql --schema schema.sql query.sql
+
   # Analyze a query piped via stdin
   echo "-- name: GetAuthor :one
   SELECT * FROM authors WHERE id = $1;" | sqlc analyze --dialect postgresql --schema schema.sql
@@ -50,7 +53,7 @@ Examples:
 				return err
 			}
 			if dialect == "" {
-				return fmt.Errorf("--dialect flag is required (postgresql, mysql, or sqlite)")
+				return fmt.Errorf("--dialect flag is required (postgresql, mysql, sqlite, or googlesql)")
 			}
 
 			schemaPath, err := cmd.Flags().GetString("schema")
@@ -107,8 +110,10 @@ Examples:
 				engine = config.EngineMySQL
 			case "sqlite":
 				engine = config.EngineSQLite
+			case "googlesql":
+				engine = config.EngineGoogleSQL
 			default:
-				return fmt.Errorf("unsupported dialect: %s (use postgresql, mysql, or sqlite)", dialect)
+				return fmt.Errorf("unsupported dialect: %s (use postgresql, mysql, sqlite, or googlesql)", dialect)
 			}
 
 			sql := config.SQL{
@@ -150,7 +155,7 @@ Examples:
 			return nil
 		},
 	}
-	cmd.Flags().StringP("dialect", "d", "", "SQL dialect to use (postgresql, mysql, or sqlite)")
+	cmd.Flags().StringP("dialect", "d", "", "SQL dialect to use (postgresql, mysql, sqlite, or googlesql)")
 	cmd.Flags().StringP("schema", "s", "", "path to the schema file")
 	cmd.Flags().BoolP("ast", "", false, "include the statement AST in the output")
 	return cmd

internal/compiler/engine.go

@@ -8,6 +8,7 @@ import (
 	"github.com/sqlc-dev/sqlc/internal/config"
 	"github.com/sqlc-dev/sqlc/internal/dbmanager"
 	"github.com/sqlc-dev/sqlc/internal/engine/dolphin"
+	"github.com/sqlc-dev/sqlc/internal/engine/googlesql"
 	"github.com/sqlc-dev/sqlc/internal/engine/postgresql"
 	pganalyze "github.com/sqlc-dev/sqlc/internal/engine/postgresql/analyzer"
 	"github.com/sqlc-dev/sqlc/internal/engine/sqlite"
@@ -82,6 +83,10 @@ func NewCompiler(conf config.SQL, combo config.CombinedSettings, parserOpts opts
 		c.parser = dolphin.NewParser()
 		c.catalog = dolphin.NewCatalog()
 		c.selector = newDefaultSelector()
+	case config.EngineGoogleSQL:
+		c.parser = googlesql.NewParser()
+		c.catalog = googlesql.NewCatalog()
+		c.selector = newDefaultSelector()
 	case config.EnginePostgreSQL:
 		parser := postgresql.NewParser()
 		c.parser = parser

internal/compiler/expand.go

@@ -71,7 +71,7 @@ func (c *Compiler) quoteIdent(ident string) string {
 
 func (c *Compiler) quote(x string) string {
 	switch c.conf.Engine {
-	case config.EngineMySQL:
+	case config.EngineMySQL, config.EngineGoogleSQL:
 		return "`" + x + "`"
 	default:
 		return "\"" + x + "\""

internal/config/config.go

@@ -54,6 +54,7 @@ const (
 	EngineMySQL      Engine = "mysql"
 	EnginePostgreSQL Engine = "postgresql"
 	EngineSQLite     Engine = "sqlite"
+	EngineGoogleSQL  Engine = "googlesql"
 )
 
 type Config struct {

internal/endtoend/testdata/analyze_basic/googlesql/exec.json

@@ -0,0 +1,5 @@
+{
+  "command": "analyze",
+  "args": ["--dialect", "googlesql", "--schema", "schema.sql", "query.sql"],
+  "contexts": ["base"]
+}

internal/endtoend/testdata/analyze_basic/googlesql/query.sql

@@ -0,0 +1,2 @@
+-- name: GetUser :one
+SELECT id, name FROM users WHERE id = @id;

internal/endtoend/testdata/analyze_basic/googlesql/schema.sql

@@ -0,0 +1,5 @@
+CREATE TABLE users (
+  id   INT64  NOT NULL,
+  name STRING NOT NULL,
+  bio  STRING,
+) PRIMARY KEY (id);

internal/endtoend/testdata/analyze_basic/googlesql/stdout.txt

@@ -0,0 +1,34 @@
+[
+  {
+    "name": "GetUser",
+    "cmd": ":one",
+    "columns": [
+      {
+        "name": "id",
+        "data_type": "int64",
+        "not_null": true,
+        "is_array": false,
+        "table": "users"
+      },
+      {
+        "name": "name",
+        "data_type": "string",
+        "not_null": true,
+        "is_array": false,
+        "table": "users"
+      }
+    ],
+    "params": [
+      {
+        "number": 1,
+        "column": {
+          "name": "id",
+          "data_type": "int64",
+          "not_null": true,
+          "is_array": false,
+          "table": "users"
+        }
+      }
+    ]
+  }
+]