Add an Instance
Database Instance
or simply Instance
models after a single database server which is usually accessed via a host:port address. A typical database instance could be your on-premises MySQL instance, an AWS RDS instance etc. Each Database Instance
belongs to an Environment
.
Prerequisites
-
Workspace Admin or Workspace DBA role
-
Bytebase provides two embedded sample PostgreSQL instances. You may add your own or add a local MySQL instance.
Add instance
Go to Instances and Add Instance.
For Host or socket, the screenshot assumes you run Bytebase inside Docker and try to connect to a database instance on the same host, thus it uses host.docker.internal
. Check out Instance Connection Configuration for the detailed guide.
Sync instance
After instance is added, click Sync Now to synchronize the instance schema such as its containing databases to Bytebase.
By default, Bytebase doesn't automatically sync the instance schema. You can set a Scan Interval to ask Bytebase to sync the schema periodically.