Manage connections

Overview

On the homepage of OceanBase Developer Center (ODC), the Private Connection tab displays the information of connections that you created and saved.

All the connections you created are displayed in a list on the Private Connection tab for you to view and manage them.

View connections

On the Private Connection tab, you can perform the following operations:

• Click the refresh icon to manually refresh the list.

• Click All Modes to select the MySQL or Oracle mode.

• Search for connections by using the search box.

• Adjust the column width of the connection list.

The following table describes columns in the list of private connections.

Column	Description
Connection Name	The name of the connection and the host, port, cluster, and tenant information. You can click the name of a connection to go to the corresponding connection management page. The icon before the connection name indicates the status of the connection. Blue indicates valid, red indicates invalid, and gray indicates that the database password is not saved.
Cluster	The cluster information. You can click the filter icon to filter the cluster information. If you select Empty , you can filter connections that do not belong to any clusters.
Tenant	The tenant information. You can click the filter icon to filter the tenant information. If you select Empty , you can filter connections that do not belong to any tenants.
Tag	The tag of the connection. You can create a tag and assign it to a connection. You can assign only one tag to each connection.
Operation Time	The time when the connection was edited, or the time when the connection was created if the connection has not been edited.
Actions	The actions you can take. Valid values: Open , Edit , Copy , and Delete .

View connection history

In the upper-right corner of the list, click History . The Historical Opened Windows panel appears.

The panel shows a list that has the following columns.

Note

By default, the historical records in the panel are saved for 48 hours. You can quickly restore the content in an unsaved SQL window based on records in the panel.

Set a tag

ODC allows you to create a tag and assign it to a connection. You can assign only one tag to each connection.

• Tag creation: You can create a tag by using the following two methods:

  • Click Set Tag next to the Connection Name field in the Create Connection panel.

  • Move the pointer in the tag column of the row where the target connection is located in the connection list, click Set Tag and click Create Tag in the drop-down list. On the Tags page, specify the name and color of the tag, and click the tick icon to complete the creation.

• Tag setting: Select the target tag from the drop-down list that displays all the tags that you created, and modify related parameters to finish the setting.

• Tag management: Click the settings icon in the upper-right corner of the drop-down list to go to the Tags page, where you can edit or delete created tags.

Pin a connection to the top

By default, the connections in the connection list are sorted by creation time, with the most recently created connection on top. The list does not support custom sorting, but you can pin frequently used connections to the top.

You can click the flag next to the name of a connection to pin the connection to the top. This turns the flag yellow. You can click the flag again to unpin the connection from the top.

Edit a connection

Click Edit in the Actions column of the target connection. The Edit Connection panel appears, which has the same structure as the Create Connection panel and displays the configuration information of the current connection. You can edit the information displayed in the Edit Connection panel.

Before you change Database Password , you must first click Change Password next to the password box. To abort the current change, click Cancel next to the password box, and the input in the password box is restored to its original value.

Copy a connection

Click Copy in the Actions column of the target connection. The Create Connection panel appears. The copied information is automatically filled in the panel. This allows you to quickly create a connection by modifying existing information.

The copy feature allows you to easily create database connections having similar information.

Delete a connection

To delete a connection, click Delete in the Actions column of the target connection.

For example, when the connected database no longer exists or you do not need to access the connected database, you can directly delete the corresponding connection.

Other operations

• In addition to the management actions that the Private Connection tab provides, after you go to the management page of a database connection, the homepage menu icon in the top navigation bar further provides the following buttons:

  • Open Connection in New Window : After you click a connection in the connection list that appears, ODC opens the connection in a new window.

  • Connections : Click this button to open the ODC homepage in a new window. On the ODC homepage, you can view and manage the configuration information of all connections.

  • Reload : Click this button to reload the current page.

  • Exit Connection : Click this button to exit the current connection and go to the ODC homepage.

    

• On the database connection page, the @{database name} information is included in the window name of Client ODC.

• Information such as the connection name, schema (in Oracle mode), and database name (in MySQL mode) appears in the top navigation bar of the workspace.

  • Move your pointer over the connection name in the top navigation bar. In the tooltip that appears, you can see information in the following fields: Connection Mode , Host/Port, Cluster/Tenant , and Database Username .

  • Click the drop-down arrow next to the displayed schema name or database name. In the drop-down list that appears, click a schema or database name to go to the target schema or database.