Bytebase: Bytebase 是一款聚焦在 Database schema change and version control 的工具

<a href="https://demo.bytebase.com?source=github" target="_blank">🔥 Live Demo</a> •
 <a href="https://bytebase.com/docs/get-started/install/overview" target="_blank">⚙️ Install</a> •
 <a href="https://bytebase.com/docs">📚 Documentation</a> •
 <a href="https://discord.gg/huyw7gRsyA">🙋‍♀️ Get Instant Help</a>

Different database development tasks

Multiple database systems

Unified process

Single tool

🪜
<h1 align="center">Change</h1>

 Want to formalize the database change process but don't know how?

| | |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- |
| Standard Operating Procedure (SOP) Standardize the database schema and data change process across different database systems, small or [large tables](https://www.bytebase.com/docs/change-database/online-schema-migration-for-mysql) and [different tenants](https://www.bytebase.com/docs/batch-change/multi-tenant-change). SQL Review [100+ lint rules](https://www.bytebase.com/docs/sql-review/review-rules) to detect SQL anti-patterns and enforce consistent SQL style in the organization. GitOps [Point-and-click GitHub and GitLab integration](https://www.bytebase.com/docs/vcs-integration/overview) to enable GitOps workflow for changing database. | <img src="https://raw.githubusercontent.com/bytebase/bytebase/main/docs/assets/issue-detail.webp" /> |

🔒
<h1 align="center">Secure</h1>

 Want to avoid data leakage, change outage and detect malicious behavior but don't know how?

| | |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------ |
| Centralize Change, Query and Admin Tasks A single place to perform different tasks on different databases, thus enforce policy and monitor activity accordingly. RBAC [Two-level RBAC model](https://www.bytebase.com/docs/concepts/roles-and-permissions) mapping to the organization wide privileges and application team privileges respectively. Anomaly Center and Audit Logging Capture all database [anomalies](https://www.bytebase.com/docs/anomaly-detection/anomaly-center), user actions and system events and present them in a holistic view. | <img src="https://raw.githubusercontent.com/bytebase/bytebase/main/docs/assets/anomaly-center.webp" /> |

🔮
<h1 align="center">Query</h1>

 Want to control the data access but don't know how?

| | |
| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------- |
| All-in-one SQL Editor Web-based IDE specifically for performing SQL specific tasks. Data Anonymization State-of-the-art [column level anonymization](https://www.bytebase.com/docs/sql-editor/anonymize-data) engine to cover complex situations like subquery, CTE. Database Access Control Organization level policy to centralize the [database access control](https://www.bytebase.com/docs/administration/database-access-control). | <img src="https://raw.githubusercontent.com/bytebase/bytebase/main/docs/assets/sql-editor.webp" /> |

👩‍💼
<h1 align="center">Govern</h1>

 Want to enforce organization policy but don't know how?

| | |
| -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------- |
| Manage Database Resources A single place to manage environments, database instances, database users for application development, with optional [Terraform integration](https://registry.terraform.io/providers/bytebase/bytebase/latest/docs). Policy Enforcement Enforce organization wide SQL Review policy, backup policy and data access policy. SQL Editor Admin mode [CLI like experience](https://www.bytebase.com/docs/sql-editor/admin-mode) without setting up bastion. | <img src="https://raw.githubusercontent.com/bytebase/bytebase/main/docs/assets/sql-review-policy.webp" /> |

# 🖖 Intro

Bytebase is a Database CI/CD solution for the Developers and DBAs. It's the **only database CI/CD project** included by the [CNCF Landscape](https://landscape.cncf.io/?selected=bytebase). The Bytebase family consists of these tools:

- [Bytebase Console](https://bytebase.com/?source=github): A web-based GUI for developers and DBAs to manage the database development lifecycle.
- [Bytebase CLI (bb)](https://www.bytebase.com/docs/cli/overview): The CLI to help developers integrate database changes into the existing CI/CD workflow.
- [Bytebase GitHub App](https://github.com/marketplace/bytebase) and [SQL Review GitHub Action](https://github.com/marketplace/actions/sql-review): The GitHub App and GitHub Action to detect SQL anti-patterns and enforce a consistent SQL style guide during Pull Request.
- [Terraform Bytebase Provider](https://registry.terraform.io/providers/bytebase/bytebase/latest/docs): The Terraform
  provider enables team to manage Bytebase resources via Terraform. A typical setup involves teams using
  Terraform to provision database instances from Cloud vendors, followed by using Bytebase provider to
  prepare those instances ready for application use.

| | Topic |
| --- | :------------------------------------------------------------------ |
| 🏗️ | [Installation](#-installation) |
| 🎮 | [Demo](#-demo) |
| 👩‍🏫 | [Tutorials](#-tutorials) |
| 💎 | [Design Principles](#-design-principles) |
| 🧩 | [Data Model](#-data-model) |
| 🎭 | [Roles](#-roles) |
| 🕊 | [Developing and Contributing](#-developing-and-contributing) |
| 🤺 | [Bytebase vs Alternatives](#-bytebase-vs-alternatives) |

# 🏗️ Installation

### One liner

```bash
# One-liner installation script from latest release
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/bytebase/install/main/install.sh)"

```

- [Build from source](https://www.bytebase.com/docs/get-started/install/build-from-source-code)
- [Docker](https://www.bytebase.com/docs/get-started/install/deploy-with-docker)
- [Kubernetes](https://www.bytebase.com/docs/get-started/install/deploy-to-kubernetes)
- [render.com](https://www.bytebase.com/docs/get-started/install/deploy-to-render)
- [Rainbond](https://www.bytebase.com/docs/get-started/install/deploy-to-rainbond)

# 🎮 Demo

Live demo at https://demo.bytebase.com

You can also [book a 30min product walkthrough](https://cal.com/adela-bytebase/30min) with one of
our product experts.

# 👩‍🏫 Tutorials

- [How to Set Up Database CI/CD with GitHub](https://www.bytebase.com/blog/github-database-cicd-part-1-sql-review-github-actions)
- [How to integrate SQL Review into Your GitLab or GitHub CI/CD](https://www.bytebase.com/blog/how-to-integrate-sql-review-into-gitlab-github-ci)
- [How to Synchronize Database Schemas](https://www.bytebase.com/blog/how-to-synchronize-database-schemas)
- [How to Configure Database Access Control and Data Anonymization for Developer](https://www.bytebase.com/blog/how-to-configure-database-access-control-and-data-anonymization-for-developer)
- [Get Database Change Notification via Webhook](https://www.bytebase.com/blog/get-database-change-notification-via-webhook)
- [How to Set Up Backup Monitoring with Better Uptime](https://www.bytebase.com/blog/how-to-use-bytebase-with-better-uptime)

## Manage database from cloud database vendors

- Manage Snowflake
  - [Database Change Management with Snowflake](https://www.bytebase.com/blog/database-change-management-with-snowflake)
  - [Database Change Management with Snowflake and GitHub](https://www.bytebase.com/blog/database-change-management-with-snowflake-and-github)
- Manage TiDB
  - [Database Change Management with TiDB](https://www.bytebase.com/blog/database-change-management-with-tidb)
  - [Database Change Management with TiDB and GitHub](https://www.bytebase.com/blog/database-change-management-with-tidb-and-github)
- [Manage Supabase PostgreSQL](https://www.bytebase.com/docs/how-to/integrations/supabase)
- [Manage render PostgreSQL](https://www.bytebase.com/docs/how-to/integrations/render)
- [Manage Neon database](https://www.bytebase.com/docs/how-to/integrations/neon)

# 💎 Design Principles

|     |                         |                                                                                                                                                                                                                                                                                                                                                                            |
| --- | ----------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 🪶  | Dependency Free         | Start with a single command `./bytebase` without any external dependency. External PostgreSQL data store and others are optional.                                                                                                                                                                                                                                          |
| 🔗  | Integration First       | Solely focus on database management and leave the rest to others. We have native VCS integration with [GitHub/GitLab](https://www.bytebase.com/docs/vcs-integration/overview), [Terraform Provider](https://registry.terraform.io/providers/bytebase/bytebase/latest/docs), [webhook](https://www.bytebase.com/docs/administration/webhook-integration/overview), and etc. |
| 💂‍♀️  | Engineering Disciplined | Disciplined [bi-weekly release](https://www.bytebase.com/changelog) and [engineering practice](https://github.com/bytebase/bytebase/blob/main/docs/life-of-a-feature.md).                                                                                                                                                                                                  |

# 🧩 Data Model

More details in [Data Model Doc](https://www.bytebase.com/docs/concepts/data-model).

# 🎭 Roles

More details in [Roles and Permissions Doc](https://www.bytebase.com/docs/concepts/roles-and-permissions).

Bytebase employs RBAC (Role-Based-Access-Control) and provides two role sets at the workspace and project level:

- Workspace roles: `Owner`, `DBA`, `Developer`. The workspace role maps to the role in an engineering organization.
- Project roles: `Owner`, `Developer`. The project level role maps to the role in a specific team or project.

Every user is assigned a workspace role, and if a particular user is involved in a particular project, then she will also be assigned a project role accordingly.

Below diagram describes a typical mapping between an engineering org and the corresponding roles in the Bytebase workspace

# 🕊 Developing and Contributing

- Bytebase is built with a curated tech stack. It is optimized for **developer experience** and is very easy to start
  working on the code:

1. It has no external dependency.
  1. It requires zero config.
  1. 1 command to start backend and 1 command to start frontend, both with live reload support.

- Interactive code walkthrough

- [Life of a schema change](https://sourcegraph.com/github.com/bytebase/bytebase/-/blob/docs/design/life-of-a-schema-change.snb.md)
  - [SQL Review](https://sourcegraph.com/github.com/bytebase/bytebase/-/blob/docs/design/sql-review-source-code-tour.snb.md)

- Follow [Life of a Feature](https://github.com/bytebase/bytebase/blob/main/docs/life-of-a-feature.md).

## Dev Environemnt Setup

### Prerequisites

- [Go](https://golang.org/doc/install) (1.20.1 or later)
- [pnpm](https://pnpm.io/installation)
- [Air](https://github.com/bytebase/air) (**our forked repo @87187cc with the proper signal handling**). This is for backend live reload.
  ```bash
  go install github.com/bytebase/air@87187cc
  ```

### Steps

1. Pull source.

```bash
   git clone https://github.com/bytebase/bytebase
   ```

1. Start backend using air (with live reload).

```bash
   air -c scripts/.air.toml
   ```

Change the open file limit if you encounter "error: too many open files".

```bash
   ulimit -n 10240
   ```

If you need additional runtime parameters such as --backup-bucket, please add them like this:

```bash
   air -c scripts/.air.toml -- --backup-region us-east-1 --backup-bucket s3:\\/\\/example-bucket --backup-credential ~/.aws/credentials
   ```

1. Start frontend (with live reload).

```bash
   cd frontend && pnpm i && pnpm dev
   ```

Bytebase should now be running at http://localhost:3000 and change either frontend or backend code would trigger live reload.

# 🤺 Bytebase vs Alternatives

## Bytebase vs Flyway, Liquibase

Either Flyway or Liquibase is a library and CLI focusing on schema change. While Bytebase is an one-stop
solution covering the entire database development lifecycle for Developers and DBAs to collaborate.

Another key difference is Bytebase **doesn't** support Oracle and SQL Server. This is a conscious
decision we make so that we can focus on supporting other databases without good tooliing support.
In particular, many of our users tell us Bytebase is by far the best (and sometimes the only) database
tool that can support their PostgreSQL and ClickHouse use cases.

[![Star History Chart](https://api.star-history.com/svg?repos=bytebase/bytebase,liquibase/liquibase,flyway/flyway&type=Date)](https://star-history.com/#bytebase/bytebase&liquibase/liquibase&flyway/flyway&Date)

## Bytebase vs Yearning, Archery

Either Yearning or Archery provides a DBA operation portal. While Bytebase provides a collaboration
workspace for DBAs and Developers, and brings DevOps practice to the Database Change Management (DCM).
Bytebase has the similar `Project` concept seen in GitLab/GitHub and provides native GitOps integration
with GitLab/GitHub.

Another key difference is Yearning, Archery are open source projects maintained by the individuals part-time. While Bytebase is open-sourced, it adopts an open-core model and is a commercialized product, supported
by a [fully staffed team](https://www.bytebase.com/about#team) [releasing new version every 2 weeks](https://www.bytebase.com/changelog).

[![Star History Chart](https://api.star-history.com/svg?repos=bytebase/bytebase,cookieY/Yearning,hhyo/Archery&type=Date)](https://star-history.com/#bytebase/bytebase&cookieY/Yearning&hhyo/Archery&Date)

# 👨‍👩‍👧‍👦 Community

[![Hang out on Discord](https://img.shields.io/badge/%20-Hang%20out%20on%20Discord-5865F2?style=for-the-badge&logo=discord&labelColor=EEEEEE)](https://discord.gg/huyw7gRsyA)

[![Follow us on Twitter](https://img.shields.io/badge/Follow%20us%20on%20Twitter-1DA1F2?style=for-the-badge&logo=twitter&labelColor=EEEEEE)](https://twitter.com/Bytebase)

# 🤔 Frequently Asked Questions (FAQs)

Check out our [FAQ](https://www.bytebase.com/docs/faq).

# 🙋 Contact Us

- Interested in joining us? Check out our [jobs page](https://bytebase.com/jobs?source=github) for openings.
- Want to solve your schema change and database management headache? Book a [30min demo](https://cal.com/adela-bytebase/30min) with one of our product experts.

留意/Bytebase

简介

发行版

贡献者

近期动态

留意/Bytebase .gitee-modal { width: 500px !important; }

简介

发行版

贡献者

近期动态

搜索帮助

留意/Bytebase