This topic describes how to enable Babelfish for an ApsaraDB RDS for PostgreSQL instance.
Usage notes
You can enable Babelfish for an ApsaraDB RDS for PostgreSQL instance only when you create the RDS instance. The RDS instance must use the following parameter settings:
NoteRDS instances that run RDS Cluster Edition are not supported.
Database Engine: PostgreSQL 15.
Product Type: Standard.
You cannot enable Babelfish for existing RDS instances.
You cannot disable Babelfish after it is enabled.
After the RDS instance is created, the babelfish_db database is created. The babelfish_db database is the key database of the RDS instance for which Babelfish is enabled. We recommend that you do not delete the database. If you delete the database, the RDS instance becomes unavailable.
Enable Babelfish for an RDS instance
Log on to the ApsaraDB RDS console. In the left-side navigation pane, click Instances. In the top navigation bar, select the region in which the RDS instance resides.
Click Create Instance to go to the ApsaraDB RDS buy page.
Configure the parameters.
This section describes the key parameters that are used to enable Babelfish for an RDS instance when you create the RDS instance. For more information about other parameter settings, see Create an ApsaraDB RDS for PostgreSQL instance.
The following table describes the key parameters.
Parameter
Description
Database Engine
The database engine of the RDS instance. Set the value to PostgreSQL 15.
Select Enable Babelfish.
Instance Type
The instance type of the RDS instance. The ApsaraDB RDS console displays the available instance types.
Babelfish Migration Mode
The migration mode after you enable Babelfish. This parameter takes effect only when you select Enable Babelfish in the Basic Configurations step.
single-db: You can create only one SQL Server database on an RDS instance for which Babelfish is enabled and create a standard PostgreSQL schema for the database.
multi-db: You can create multiple SQL Server databases and create different PostgreSQL schemas for the databases. You must name the schemas in the <Database name>_<Schema name> format to avoid name conflicts.
For more information about how to select a migration mode, see Migration modes.
Initial Account
The username of the management account that can be used to manage Babelfish or PostgreSQL.
ImportantThis account is a privileged account. You cannot delete the account after it is created.
The username must meet the following requirements:
It must be 2 to 63 characters in length.
It can contain lowercase letters, digits, and underscores (_).
It must start with a lowercase letter and end with a lowercase letter or a digit.
It cannot start with pg.
It cannot contain SQL keywords. For more information, see SQL Keywords.
Password
The password of the management account.
NoteYou can change the password after the RDS instance is created. For more information, see Reset the password of an account.
The password must meet the following requirements:
It is 8 to 32 characters in length.
It must contain at least three of the following character types: uppercase letters, lowercase letters, digits, and special characters.
The following special characters are supported:
! @ # $ % ^ & * ( ) _ + - =
.
View the status of Babelfish
Go to the Instances page. In the top navigation bar, select the region in which the RDS instance resides. Then, find the RDS instance and click the ID of the instance.
In the left-side navigation pane of the page that appears, click Basic Information.
In the Configuration Information section of the page that appears, view the values of Minor Engine Version and Babelfish Status.
View the Babelfish management account
Go to the Instances page. In the top navigation bar, select the region in which the RDS instance resides. Then, find the RDS instance and click the ID of the instance.
In the left-side navigation pane of the page that appears, click Accounts.
On the Accounts tab of the page that appears, view the Babelfish management account that is initialized when you created the RDS instance.
View the endpoints and TDS port
Prerequisites
A whitelist is created for the RDS instance. For more information, see Control access to an ApsaraDB RDS for MySQL instance.
Procedure
Go to the Instances page. In the top navigation bar, select the region in which the RDS instance resides. Then, find the RDS instance and click the ID of the instance.
In the left-side navigation pane of the page that appears, click Database Connection.
You can view the internal and public endpoints and Tabular Data Stream (TDS) port in the Database Connection section.
NoteIf you want to use a public endpoint, click Apply for Public Endpoint. For more information about how to apply for a public endpoint, see Apply for or release a public endpoint.
If you want to change the TDS port number for Babelfish, click Modify Endpoint. For more information, see View and change the endpoints and port numbers of an ApsaraDB RDS for PostgreSQL instance.
Related operations
Operation | Description |
Creates an instance. | |
Queries the details of an instance. | |
Applies for a public endpoint for an instance. | |
Changes the endpoint of an instance. | |
Queries the endpoints of an instance. |