839133fc27
* docs: add guides to view middleware data * docs: add guide for grafana * docs: add guide for otel and integration guides for other middleware * docs: add guide for elasticsearch * docs: update based on suggestions * Update zh.ts * docs: update content * docs: resolve conflict
2.8 KiB
outline, description
| outline | description | ||
|---|---|---|---|
|
Learn how to view and manage PostgreSQL data in Olares using CLI or Bytebase. |
View PostgreSQL data
PostgreSQL is available by default in Olares. This guide walks you through accessing it from Olares.
Get connection information
Before connecting, obtain PostgreSQL connection details from the Control Hub.
-
Open Control Hub from Launchpad.
-
In the left navigation pane, go to Middleware and select Postgres.
-
On the Details panel, record the following information:
- Host: Used for Bytebase connection.
- User: Used for Bytebase connection.
- Password: Used for both CLI and Bytebase.
{width=60% style="margin-left:0"}
Access via CLI
You can use the Olares terminal to access the database container.
-
In Control Hub, open the Olares terminal at the bottom of the left navigation pane.
-
Enter the PostgreSQL container. The container name is fixed.
kubectl exec -it -n os-platform citus-0 -- sh -
Connect to the PostgreSQL database:
psql -h citus-0 -U olares -
When prompted, enter the password you retrieved from Control Hub.
Manage via Bytebase
Bytebase provides a graphical interface for database management and schema changes.
Prerequisites
:::info MongoDB app required Bytebase uses MongoDB to store its metadata. Install MongoDB before installing Bytebase. :::
- Open Market and search for "MongoDB".
- Click Get, then Install, and wait until the service is running.
- After MongoDB is installed, search for "Bytebase" in Market.
- Click Get, then Install.
First-time setup
When launching Bytebase for the first time, you must configure an administrator account.
:::tip Remember these credentials. Only the admin account can create new database instances. :::
- Open Bytebase from Launchpad.
- Follow the on-screen prompts to set up your admin account with email and password.
Create a PostgreSQL instance
- Log in to Bytebase with your admin account.
- In the left navigation pane, select Instances, then click + Add Instance.
- Choose PostgreSQL as the database type.
- Fill in the connection fields using values from Control Hub:
- Host or Socket: Enter the Host address and do not include the port.
- Port: Keep the default, usually
5432. - Username: Enter the User value from Control Hub.
- Password: Enter the Password value from Control Hub.
- Click Test Connection to verify connectivity, then click Create.
Creating an instance in Bytebase does not create a new database. Once the instance is created, you can use the corresponding client tools to inspect and manage data.