|
| 1 | +--- |
| 2 | +title: Bytebase 3.17.0 - Apr 9, 2026 |
| 3 | +author: Adela |
| 4 | +updated_at: 2026/04/09 18:00:00 |
| 5 | +description: 'Unified Plan Lifecycle View, High Availability' |
| 6 | + |
| 7 | +--- |
| 8 | + |
| 9 | +import InstallUpgrade from '/snippets/install/install-upgrade.mdx'; |
| 10 | + |
| 11 | +## 🔔 Notable Changes |
| 12 | + |
| 13 | +- **Unified Plan lifecycle view** — Review and rollout now appear in a single Plan detail page, giving developers one place to follow a change from draft to deployment. |
| 14 | + |
| 15 | +- **Remove Pro plan 20-user seat cap** — Pro plan no longer has a user limit. |
| 16 | + |
| 17 | +- **API breaking changes** — Worksheet API moves to project scope (`/v1/projects/{id}/worksheets`), `ListDatabases` now requires workspace ID (`/v1/workspaces/{id}/databases`), `branding_logo` moves from workspace profile setting to workspace message, `GRANT_REQUEST` issue type renamed to `ROLE_GRANT`, and `UpdateSubscription` API replaced by `UploadLicense`. See [Change Details](<#api-breaking-changes>). |
| 18 | + |
| 19 | +- **CEL filter syntax change** — Substring-search filters now use `contains()` instead of `matches()` across plan, database, instance, project, group, user, service account, workload identity, query history, access grant, and database metadata table filters. See [Change Details](<#cel-filter-syntax-change>). |
| 20 | + |
| 21 | +- **Classification setting API breaking changes** — Classification description and level description fields removed. Classification level type changes from string to number. |
| 22 | + |
| 23 | +- **Terraform provider** — Migrate for 3.17.0 API breaking changes. Support get, create, update, and list identity provider. |
| 24 | + |
| 25 | +## 🚀 Features |
| 26 | + |
| 27 | +- **High Availability (HA)** — Support licensed multi-replica deployments backed by a shared external PostgreSQL metadata database. Active replicas are tracked via heartbeats, and background runners coordinate safely across replicas. |
| 28 | + |
| 29 | +- **Page Agent** — Add an in-app AI assistant with tool-calling, threaded resumable conversations, DOM-aware autocomplete, and token usage tracking. |
| 30 | + |
| 31 | +- **Issue Approved webhook event** — Support a new webhook event type for issue approval, with redesigned Slack message format. |
| 32 | + |
| 33 | +- **MCP `query_database` tool** — Add a new MCP tool for executing SQL queries against managed databases with automatic database resolution. |
| 34 | + |
| 35 | +- **CosmosDB** — Support local emulator connection and dynamic data masking for all 13 query feature areas. |
| 36 | + |
| 37 | +## 🎄 Enhancements |
| 38 | + |
| 39 | +- Support executing stored procedures (`CALL` / `EXEC`) in SQL Editor by classifying stored procedure execution as DML. |
| 40 | + |
| 41 | +- Support issue type filter in advanced search (Database Change, Role Grant, Database Export, Access Grant). |
| 42 | + |
| 43 | +- Replace data classification file upload with an inline JSON editor and enhance the data classification editor. |
| 44 | + |
| 45 | +- Redesign masking exemption list page with classification level support. |
| 46 | + |
| 47 | +- Auto-expand sidebar group for the active route. |
| 48 | + |
| 49 | +- Migrate the frontend from Vue to React across all major pages including settings, projects, databases, instances, plans, issues, and audit logs. |
| 50 | + |
| 51 | +- Upgrade SQL parsing engine for PostgreSQL, MySQL, MSSQL, MongoDB, and CosmosDB from ANTLR to omni parser, improving SQL syntax coverage, consistency across SQL review / schema diff / auto-completion, and error message quality. |
| 52 | + |
| 53 | +- Add configurable `--timeout` flag for `bytebase-action` for large SQL checks. |
| 54 | + |
| 55 | +- Expose `--enable-json-logging` flag in the Helm chart for structured log output. |
| 56 | + |
| 57 | + |
| 58 | +## 🐞 Bug Fixes |
| 59 | + |
| 60 | +- Fix false schema diff noise caused by PostgreSQL trigger ordering and CRLF / whitespace normalization. |
| 61 | + |
| 62 | +- Fix automatic rollout not working. |
| 63 | + |
| 64 | +- Fix startup crash from nil licenseService and non-idempotent migration. |
| 65 | + |
| 66 | +- Fix SQL editor metadata sync retry flood. |
| 67 | + |
| 68 | +- Fix OAuth discovery to return usable URLs in self-hosted mode. |
| 69 | + |
| 70 | +- Fix SSO GitHub email fetch. |
| 71 | + |
| 72 | +- Fix stale debounced query reverts in advanced search. |
| 73 | + |
| 74 | +- Fix data export creation to issue-scoped flow and initialize export format correctly. |
| 75 | + |
| 76 | +- Fix gh-ost directives in versioned release workflow. |
| 77 | + |
| 78 | +- Fix various UI issues: dropdown z-index clipping, popover dismiss on label selector interaction, CEL constraint preservation after role deletion, environment dashboard responsive layout, and button label standardization. |
| 79 | + |
| 80 | +- **PostgreSQL** — Fix CRLF line endings causing query truncation in SQL splitter, schema load failure by excluding aggregates from function sync, array subscript handling in column reference normalization, whitespace between LIMIT and FOR UPDATE clause, nested SELECTs in wrapper statements and CTEs for SQL review, and PolarDB `pg_bitmapindex` schema appearing in dumps. |
| 81 | + |
| 82 | +- **MySQL** — Fix unqualified SET columns in prior backup for UPDATE JOIN, missing `multiStatements` param in IAM auth DSN, and role sync for anonymous users. |
| 83 | + |
| 84 | +- **TiDB** — Remove non-transaction statement handling. |
| 85 | + |
| 86 | +- **Oracle** — Strip trailing null bytes from schema definitions. |
| 87 | + |
| 88 | +<InstallUpgrade /> |
| 89 | + |
| 90 | +## 📃 Change Details |
| 91 | + |
| 92 | +### API Breaking Changes |
| 93 | + |
| 94 | +| Change | Before | After | |
| 95 | +| -- | -- | -- | |
| 96 | +| Worksheet API path | `/v1/worksheets` | `/v1/projects/{id}/worksheets` | |
| 97 | +| ListDatabases scope | `/v1/workspaces/-/databases` | `/v1/workspaces/{id}/databases` | |
| 98 | +| Branding logo | `branding_logo` in workspace profile setting | `logo` field on workspace message | |
| 99 | +| Issue type enum | `GRANT_REQUEST` | `ROLE_GRANT` | |
| 100 | +| Subscription API | `PATCH /v1/subscription` | `PATCH /v1/subscription/license` (renamed to `UploadLicense`) | |
| 101 | +| Data source ID | Required explicit `data_source_id` in query API | Auto-resolved server-side; at most one read-only data source per instance (extra read-only data sources removed during migration) | |
| 102 | +| Classification level | `string` type with `description` field | `int` type, `description` removed | |
| 103 | + |
| 104 | +### CEL Filter Syntax Change |
| 105 | + |
| 106 | +Substring-search CEL filters now use `contains()` instead of `matches()`. Affected fields: |
| 107 | + |
| 108 | +| Field | Example Before | Example After | |
| 109 | +| -- | -- | -- | |
| 110 | +| `title` | `title.matches("database migration")` | `title.contains("database migration")` | |
| 111 | +| `name` | `name.matches("employee")` | `name.contains("employee")` | |
| 112 | +| `resource_id` | `resource_id.matches("prod")` | `resource_id.contains("prod")` | |
| 113 | +| `email` | `email.matches("admin")` | `email.contains("admin")` | |
| 114 | +| `host` | `host.matches("10.0")` | `host.contains("10.0")` | |
| 115 | +| `port` | `port.matches("5432")` | `port.contains("5432")` | |
| 116 | +| `statement` | `statement.matches("select")` | `statement.contains("select")` | |
| 117 | +| `query` | `query.matches("insert")` | `query.contains("insert")` | |
| 118 | +| `table` | `table.matches("users")` | `table.contains("users")` | |
| 119 | + |
| 120 | +Applies to: plan, database, instance, project, group, user, service account, workload identity, query history, access grant, and database metadata table filters. |
0 commit comments