Skip to main content
A database change goes through three stages: Plan, Review, and Deploy.

Create a Plan

  1. Open the project you created in Step 3, then go to CI/CD > Plans and click + New Plan.
  2. Select the database you transferred in Step 3 and click Confirm.
  3. Write a CREATE TABLE statement, or use Schema Editor to design one visually:
  4. Click Create. Bytebase checks the statement automatically.
  5. Click Ready for Review to submit the plan.
Plan with built-in checks passed
A fresh workspace has no SQL review policy configured, so only built-in checks run and pass. Configure a SQL Review Policy and this stage will surface warnings or errors automatically instead.

Review

Review stage showing Skipped, no approval required
This stage shows Skipped — a fresh workspace has no Custom Approval rule configured, so no one needs to approve. Add one and an issue will wait here for approval instead.

Deploy

  1. Click Run to deploy, or configure automatic rollout in environment settings.
  2. Issue marked Deployed when complete.
Deployed issue with all stages complete Every change is recorded — open the database and check its Changelog tab. See Changelog for the full detail. Pro and Enterprise plans unlock Audit Log, which records who did each step of this quick start.

Seed a Row for Step 5

The same Plan → Review → Deploy flow works for data, not just schema — create another plan with an INSERT statement:

Review and Approval on a Configured Workspace

Both gates passed straight through above, because a fresh workspace has no review policy and no approval rule. Here is the same change with both in place — review raises a warning, and an approver signs off before rollout: