Buying and Connecting to a Cluster Instance
This section describes how to buy a GeminiDB Influx cluster instance on the GeminiDB console and connect to the instance.
One cluster consists of at least three nodes. A cluster is easy to scale out to meet increasing data growth needs. A cluster is recommended if you have high requirements on availability, large volume of data, and future scalability.
Each tenant has up to 50 GeminiDB Influx instances by default. To request a higher quota, contact customer service.
- Step 1: Buying a Cluster Instance
- Step 2: Connecting to an Instance Through DAS
For details about other connection methods, see Connection Methods.
- Log in to the GeminiDB console.
- In the service list, choose Databases > GeminiDB Influx API.
- On the Instances page, click Buy DB Instance.
- On the displayed page, select a billing mode, configure instance specifications, and click Next.
The following parameters are for reference only. Select proper specifications as needed. Table 1 lists details about the parameters.
Figure 1 Billing mode and basic information
Parameter
Example Value
Description
Billing description
Pay-per-use
Billing mode of an instance
- Yearly/Monthly: A prepaid billing mode in which you pay for resources before using it. Bills are settled based on the subscription period. The longer the subscription term, the bigger the discount. This mode is a good option for long-term stable services.
- Pay-per-use: A postpaid billing mode. Pay as you go and just pay for what you use. The DB instance usage is calculated by the second but billed every hour. This mode allows you to adjust resource usage easily. You neither need to prepare for resources in advance, nor end up with excessive or insufficient preset resources.
Region
Select CN-Hong Kong.
The region where the tenant is located. It can be changed in the upper left corner.
NOTICE:Select the nearest region where you will access the instance from, so latency can be kept to a minimum and response will be faster. Instances deployed in different regions cannot communicate with each other over a private network. After you buy an instance, you cannot change its region.
DB Instance Name
User-defined
The instance name:
- Can be the same as an existing instance name.
- Contains 4 to 64 characters and must start with a letter. It is case-sensitive and allows only letters, digits, hyphens (-), and underscores (_). If the name contains Chinese characters, the length cannot exceed 64 bytes.
Compatible API
InfluxDB
-
DB Instance Type
Cluster
One cluster consists of at least three nodes. A cluster is easy to scale out to meet increasing data growth needs. A cluster is recommended if you have high requirements on availability, large volume of data, and future scalability.
Compatible Version
1.8
1.8
AZ
AZ 1, AZ 2, and AZ 3
Availability zone where the instance is created. An AZ is a part of a region with its own independent power supplies and networks. AZs are physically isolated but can communicate with each other over a private network.
An instance can be deployed in one or three AZs.
- If you want to deploy an instance in a single AZ, select one AZ.
- If you want to deploy your instance across AZs for disaster recovery, select three AZs. Nodes of the instance are evenly distributed across the three AZs.
Figure 2 Storage and specifications
Parameter
Example Value
Description
Data Node Specifications
2U8GB
Data nodes provide read and write capabilities for time series databases. The specifications depend on configurations of the DFV shared resource pool and memory. Select specifications based on service requirements.
For details about supported specifications, see Instance Specifications.
Data Nodes
3
Select the number of data nodes based on service requirements. After an instance is created, you can add nodes. For details, see Adding Nodes.
Storage Space
100GB
The storage is an integer and the minimum storage is 100 GB. You can add a minimum of 1 GB at a time.
Purchase Cold Storage
No
Do not purchase cold storage.
If you do not enable cold storage when creating an instance, you can enable it later based on service requirements. For details, see Enabling Cold Storage.
NOTE:Cold storage cannot be disabled after being enabled.
Figure 3 Network and database configurations
Parameter
Example Value
Description
VPC
default_vpc
Virtual private network where your DB instances are located. A VPC isolates networks for different services. You can select an existing VPC or create a VPC.
NOTE:- After a GeminiDB Influx instance is created, the VPC where the instance is deployed cannot be changed.
- If you want to connect to a GeminiDB Influx instance from an ECS over a private network, ensure that the instance and the ECS are in the same VPC. If they are not, create a VPC peering connection between them.
Subnet
default_subnet
A subnet provides dedicated network resources that are logically isolated from other networks for security purposes.
Security Group
default
A security group controls access between GeminiDB Influx instances and other services. Ensure that the security group you selected allows your client to access the instance.
If no security group is available, the system creates one for you.
Administrator Password
Configured based on the password policy
Password of the administrator account. The password:
- Can contain 8 to 32 characters.
- Can include uppercase letters, lowercase letters, digits, and any of the following special characters: ~!@#%^*-_=+?
- For security reasons, set a strong password. The system will verify the password strength.
Keep your password secure. The system cannot retrieve it if it is lost.
Parameter Template
Default-InfluxDB-1.8
A template of parameters for creating an instance. The template contains API configuration values that are applied to one or more instances.
After an instance is created, you can modify its parameters to better meet your service requirements. For details, see Modifying Parameters of GeminiDB Influx Instances.
Enterprise Project
default
This parameter is provided for enterprise users.
An enterprise project groups cloud resources, so you can manage resources and members by project. The default project is default.
Select an enterprise project from the drop-down list. For more information about enterprise projects, see Enterprise Management User Guide.
Retain the default values for other parameters.
- On the order confirmation page, check the instance information. If you need to modify the information, click Previous. If no modification is required, read and agree to the service agreement and click Submit.
- Click Back to Instance Management to go to the instance list.
- On the Instances page, view and manage the created instance.
- Creating an instance takes about 5 to 9 minutes. During the process, the instance status displayed in the DB instance list is Creating.
- After the creation is complete, the instance status changes to Available.
Figure 4 Successful purchase
Step 2: Connecting to an Instance Through DAS
- Log in to the GeminiDB console.
- In the service list, choose Databases > GeminiDB Influx API.
- In the instance list, locate a target instance and click Log In in the Operation column.
Figure 5 Connecting to a GeminiDB Influx Instance
Alternatively, click the instance name to go to the Basic Information page. Click Log In in the upper right corner of the page.
Figure 6 Connecting to a GeminiDB Influx Instance
- Enter a password for logging in to the instance.
You need to enter the password only when you log in to a GeminiDB Influx instance first time or after you set the password.
Figure 7 Logging in to the GeminiDB Influx instance
- Manage relevant databases.
Figure 8 Instance homepage
- Save commands to the execution record.
This function is enabled by default to save the recently executed commands for your later query.
Then you can click the Executed Commands tab on the lower page to view historical commands.
Commands with passwords are not displayed on the Executed Commands tab page.
Figure 9 Executed commands
If this function is disabled, the commands executed subsequently are not displayed. You can click next to Save Executed SQL Statements in the upper right corner to disable this function.
- Execute a command.
Enter a command in the command window and click Execute or F8.
Figure 10 Execute a command.
After a command is executed, you can view the execution result on the Results page.
- Save a command.
You can save a command to all instances or the current instance. Then you can view details in My Commands.
Commands with passwords cannot be saved to My Commands.
Figure 11 Save a command.
- View my commands.
Common commands are displayed the My Commands page.
You can set a filter to narrow the scope of commands. If you select All, all commands saved in the current account are displayed.
Figure 12 Filtering commands
Alternatively, you can enter a command title or statement in the search box to search for the corresponding command.
Figure 13 Searching for a command
On the My Commands page, you can also create, edit, and delete a command or copy it to the Execute window.
Figure 14 Managing a command
- Clear a command.
You can also press F10 to clear the command in the execution window.
- Save commands to the execution record.
Feedback
Was this page helpful?
Provide feedbackThank you very much for your feedback. We will continue working to improve the documentation.See the reply and handling status in My Cloud VOC.
For any further questions, feel free to contact us through the chatbot.
Chatbot