Database governance built for humans and agents — controlling changes and access across every major database.
Bytebase
Bytebase is a governed database development workspace. It turns proposed database work into reviewable plans and staged execution across managed database resources.
Language
Export Destination: Where an export goes: Download to the caller's machine, or a configured storage location such as the Project Export Destination. Download is available unless the workspace query data policy disables it, and configuring a storage location approves exports to it; the Export Permission decides who may export, and an export access grant never adds a destination. Avoid: Export delivery, export target, download location
Project Export Destination: The single configured storage location for a project's exports, which receives them directly from Bytebase. Its readers and retention are governed by the customer's storage administrators, independently of who initiates an export. Avoid: User export folder
Download: The Export Destination that returns an exported file from Bytebase to the caller's machine. It is distinct from viewing query results in SQL Editor or opening a file already sent to a Project Export Destination. Avoid: Local export, local export download, query access
Workspace: The top-level collaboration boundary that contains projects, database connections, environments, users, and policies. Avoid: Project, organization
Seat-Occupying User: An end user who consumes one workspace license seat through workspace membership. Pending invited users count; soft-deleted users and non-user identities do not. Avoid: Active user, principal count, logged-in user
Project: A governance boundary for an application or team's databases. It can own project instances and owns database membership, issue workflow, approvals, labels, and rollout limits. Avoid: Workspace, repository, environment
Instance: A registered database server, cluster, or service connection that Bytebase syncs and operates against. An instance is registered as either a workspace instance or a project instance, and its scope does not change. Avoid: Database, environment
Workspace Instance: An instance governed directly by the workspace. Its databases may belong to different projects. Avoid: Project instance, unassigned instance
Project Instance: An instance owned by exactly one project. Every database it contains belongs to that same project. Avoid: Workspace instance, shared instance
Sample Project Instance: A Project Instance provided by Bytebase Cloud for temporary evaluation. It is an aggregate comprising one Project Instance and its one dedicated database and login role on Bytebase's shared, dedicated Cloud SQL PostgreSQL instance. Each Workspace has one lifetime entitlement. Seven-day eligibility begins only when the aggregate is ready; physical cleanup removes the backing database and role while retaining Bytebase metadata. Avoid: Sample instance, sample database, shared instance
Database: A named database inside an instance that Bytebase tracks and assigns to a project. In a project instance, it belongs to the instance's project; in a workspace instance, it may be assigned independently. Avoid: Instance, schema
Environment: A lifecycle tier such as development, staging, or production used to classify and order database work. Environments classify instances, databases, and rollout stages; they are not projects. Avoid: Project, instance, deployment
Database Change: A requested modification to database structure or data managed through Bytebase's workflow. Use this term instead of bare "change" when the object is a database operation. Avoid: Change, rollout, migration
Plan: A reviewable proposal for database work in a project. A plan describes what should happen and to which targets before execution begins. Avoid: Rollout, issue, migration
Bytebase Issue: A project-scoped request and review record for database changes, data exports, role grants, or access grants. It may carry approval state and may link to a plan; it is distinct from Linear or GitHub issues. Avoid: Linear issue, GitHub issue, ticket, plan
Rollout: The execution of a plan, organized into stages and tasks. A rollout exists once a plan is ready to be executed and tracks progress through target environments. Avoid: Plan, issue, release
Rollout Stage: A group of rollout tasks for one environment. Stages express environment order within a rollout. Avoid: Environment, task
Task: A single executable unit within a rollout stage, targeting a database or instance. Tasks are execution work; they are not planning items or issue-tracker tasks. Avoid: Plan spec, checklist item, Linear task
Task Run: A recorded attempt to execute a task. Use this term when discussing execution logs, status transitions, or results rather than the task definition itself. Avoid: Task
Release: A packaged set of database change inputs used to coordinate deployment across targets. It is the change artifact, not the approval record or execution. Avoid: Plan, rollout, issue
Changelog: The recorded history of a database migration after execution. It is evidence that a change ran, not the proposed change itself. Avoid: Change request, release
Work Queue Surface: A list surface read to decide what needs attention now, such as the issue, plan, and release lists. The primary time question on a work queue is freshness. Avoid: History view, feed, dashboard
History View Surface: A surface read as a record of what already happened, such as the audit log, database changelog, revisions, and task-run history. The primary time question on a history view is exactly when something happened. Avoid: Work queue, activity feed
Composite Type:
A PostgreSQL-family standalone named row type (CREATE TYPE x AS (...), pg_type.typtype = 'c' excluding table row types). Distinct from enums, domains, ranges, Oracle object types, and SQL Server table/alias types — each is its own concept with its own name.
Avoid: UDT, user-defined type, custom type, object type
Export Permission: The permission to export query results from specific databases, schemas, or tables. It decides who may export, and on its own it lets the holder read the data it covers through export. Avoid: Exporter role, export right, export approval
Access Grant: An approved, time-limited permission for one user to run one specific query on its target databases. A grant that includes export satisfies the Export Permission for that query. Avoid: JIT access, temporary role, export ticket