Skip to content

docs: update changelog 3.13.0 #977

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

Merged
adela-bytebase merged 3 commits into from
Dec 24, 2025
Merged

docs: update changelog 3.13.0 #977

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
ce9a887
update changelog 3.13.0
adela-bytebase Dec 24, 2025
0ba2f73
Update docs/changelog/bytebase-3-13-0.mdx
adela-bytebase Dec 24, 2025
a39cb9e
update
adela-bytebase Dec 24, 2025
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
26 changes: 14 additions & 12 deletions docs/changelog/bytebase-3-13-0.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,24 +2,26 @@
title: Bytebase 3.13.0 - Dec 18, 2025
author: Adela
updated_at: 2025/12/18 18:00:00
description: 'Support MCP integration'
description: 'Support MCP integration and simplified approval flow configuration'
---

import InstallUpgrade from '/snippets/install/install-upgrade.mdx';

## 🔔 Notable Changes

- **Consolidate DDL and DML changes** so users no longer need to select them explicitly.
- Update SQL review configuration for Terraform: (e.g. [sql_review.tf](https://github.com/bytebase/terraform-provider-bytebase/blob/main/examples/setup/sql_review.tf))
- SQL review rules use typed payload fields (`number_payload`, `string_payload`, `string_array_payload`, `naming_payload`, etc.).
- Generic payload and comment fields are removed.
- Rule level enums from `SQLReviewRuleLevel_WARNING/ERROR` to `SQLReviewRule_WARNING/ERROR`.
- **Consolidate DDL and DML changes** so users no longer need to select them explicitly when initiating New Plan or configuring approval flow.
- **Simplify approval workflows**:
- Approval flows are defined directly using CEL expressions, without intermediate risk definitions.
- Risk evaluation uses system presets.
- Risk level is automatically evaluated using a standardized assessment framework.
- `risk.level` is an optional CEL factor for CHANGE_DATABASE approval flows.
- For non-Terraform, existing approval flows are automatically migrated.
- For Terraform, approval flows are defined via bytebase_setting (settings/WORKSPACE_APPROVAL) using approval_flow.rules.flow, and risk resources are removed.(e.g. [approval_flow.tf](https://github.com/bytebase/terraform-provider-bytebase/blob/main/examples/setup/approval_flow.tf))
- Move rollout policy checkers (**Require issue approval**, **Plan check enforcement**) from environment to project.
- Update SQL review configuration for Terraform: (e.g. [sql_review.tf](https://github.com/bytebase/terraform-provider-bytebase/blob/main/examples/setup/sql_review.tf))
- SQL review rules use typed payload fields (`number_payload`, `string_payload`, `string_array_payload`, `naming_payload`, etc.).
- Generic payload and comment fields are removed.
- Rule level enums migrate from `SQLReviewRuleLevel_WARNING/ERROR` to `SQLReviewRule_WARNING/ERROR`.
- Move rollout policy checkers from environment to project level: **Require issue approval** and **Plan check enforcement**. Project settings are checked if any checker is previously used via automatic migration.
Copy link

Copilot AI Dec 24, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Missing space after "project level:" - there should be a space before the list of checkers begins. The sentence reads awkwardly; consider rephrasing to "Move rollout policy checkers (Require issue approval and Plan check enforcement) from environment to project level. Project settings are checked if any checker was previously used via automatic migration."

Suggested change
- Move rollout policy checkers from environment to project level: **Require issue approval** and **Plan check enforcement**. Project settings are checked if any checker is previously used via automatic migration.
- Move rollout policy checkers (**Require issue approval** and **Plan check enforcement**) from environment to project level. Project settings are checked if any checker was previously used via automatic migration.

Copilot uses AI. Check for mistakes.
- Migrate user identifiers: User references change from `users/{id}` to `users/{email}` in APIs and storage. Audit logs store user emails directly.
- Rename **Masking Exception** to **Masking Exemption**:
- APIs rename `MaskingException` to `MaskingExemption`.
- The action field is removed.
Expand All @@ -29,14 +31,14 @@ import InstallUpgrade from '/snippets/install/install-upgrade.mdx';
- Refine database group permissions:
- Roles with `bb.projects.get` gain `bb.databaseGroups.list/get`.
- Roles with `bb.projects.update` gain `bb.databaseGroups.create/update/delete`.
- Migrate user identifiers: User references change from `users/{id}` to `users/{email}` in APIs and storage. Audit logs store user emails directly.
- For Terraform, please update the permissions of custom roles accordingly.
- Update batch task APIs: The `reason` field is removed from `BatchRunTasks` and `BatchCancelTaskRuns`. `reason` is supported only for skip operations.
- Remove **SchemaTemplate** functionality.
- Remove **Schema Template** functionality.

## 🚀 Features

- Support **MCP integration** under Workspace Integration > MCP.
- Add **Workload Identity** as a dedicated account type for OIDC-based authentication, with **GitHub Actions** support.
- Support [MCP integration](/integrations/mcp).
- Add **Workload Identity** as a dedicated account type for OIDC-based authentication, with [GitHub Actions support](/administration/user-groups/workload-identity/github-actions).
- Support direct messages for **Microsoft Teams**.

## 🎄 Enhancements
Expand Down