Updated on 2025-12-11 GMT+08:00

Managing GeminiDB Serverless Tables

After a VPC endpoint is created, you can create, delete, and view GeminiDB Serverless tables on the console.

Usage Notes

  • Only standard tables of GeminiDB DynamoDB-Compatible instances can be created.
  • During the OBT, a tenant can create a maximum of three tables.

Billing

Serverless tables are free of charge during OBT. You will be billed automatically after GA. You can check the notice on Huawei Cloud.

Configuring Permissions

If you are using an IAM user, configure GeminiDB permissions before you use DynamoDB Serverless. For details about the permissions, see GeminiDB Permission Management. The procedure is as follows:

  1. System-defined policy: Configure GeminiDB FullAccess and GeminiDBServerlessFullAccessPolicy permissions.
  2. If you do not configure GeminiDB FullAccess, you can create a custom policy and configure the following permissions on the IAM console. For details, see Creating a Custom Policy.

    If the JSON view is used to configure a custom policy, the policy content is as follows. Table 1 lists the details.

    {   
        "Version": "5.0",
        "Statement": [
            {
                "Effect": "Allow",
                "Action": [
                    "vpcep:endpoints:create",
                    "vpcep:endpoints:delete",
                    "vpcep:endpoints:get",
                    "gaussdbfornosql:serverless:createDynamoDBTable",
                    "gaussdbfornosql:serverless:createEndpoint",
                    "gaussdbfornosql:serverless:deleteDynamoDBTable",
                    "gaussdbfornosql:serverless:deleteEndpoint",
                    "gaussdbfornosql:serverless:getDynamoDBSubscriptionStatus",
                    "gaussdbfornosql:serverless:listDynamoDBTables",
                    "gaussdbfornosql:serverless:listEndpoints",
                    "gaussdbfornosql:serverless:updateDynamoDBSubscriptionStatus"
                ] 
            } 
        ] 
    }
  3. You can assign the custom policy created in 2 to the user on the IAM console.
Table 1 Permissions required for managing Serverless tables

Service

Permission

Description

gaussdbfornosql

gaussdbfornosql:serverless:updateDynamoDBSubscriptionStatus

gaussdbfornosql:serverless:getDynamoDBSubscriptionStatus

Enables Serverless.

gaussdbfornosql

gaussdbfornosql:serverless:listDynamoDBTables

gaussdbfornosql:serverless:createDynamoDBTable

gaussdbfornosql:serverless:deleteDynamoDBTable

Manages tables on the console.

gaussdbfornosql

gaussdbfornosql:serverless:listEndpoints

gaussdbfornosql:serverless:createEndpoint

gaussdbfornosql:serverless:deleteEndpoint

Manages VPC endpoints on the console.

VPCEP

vpcep:endpoints:create

vpcep:endpoints:delete

vpcep:endpoints:get

Grants GeminiDB the permissions of VPC endpoint services.

Procedure

  1. Log in to the Huawei Cloud console.
  2. In the navigation pane, choose Serverless > DynamoDB-compatible.
  3. If you have not enabled GeminiDB Serverless, enable it first.
  4. After enabling GeminiDB Serverless, click Create Serverless Table. In the Create Serverless Table dialog box, set the parameters listed in Table 2.

    Figure 1 Creating a Serverless table
    Table 2 Creating a Serverless table

    Parameter

    Description

    Table

    (Mandatory) Name of a table to be created. The value can contain 3 to 48 characters, including only letters, digits, underscores (_), and hyphens (-).

    Partition Key

    (Mandatory) Partition key name, which can contain 3 to 48 characters, including only letters, digits, underscores (_), and hyphens (-)

    Partition Key Type

    (Mandatory) Partition key type, which can be String, Number, or Binary.

    Sort Key

    (Optional) Sort key name, which can contain 3 to 48 characters, including only letters, digits, underscores (_), and hyphens (-). The value must be different from sort key names.

    Sort Key Type

    (Optional) Sort key type, which can be String, Number, or Binary.

    Max. Write Request Unit

    (Optional) Maximum write request unit (WRU). In pay-per-request billing, API calls to write data to your table are billed by WRU. One WRU can write up to 1 KB of data. More than 1 KB of data consumes additional WRUs. For example, writing 1 KB of data requires one WRU, writing 3 KB of data requires three WRUs. This parameter is not returned if it is not set. The maximum WRU is 40,000.

    Max. Read Request Unit

    (Optional) Maximum read request unit (RRU). In pay-per-request billing, API calls to read data from your table are billed by RRU. When you request strongly consistent reads, one RRU can read up to 4 KB of data. More than 4 KB of data consumes additional RRUs. This parameter is not returned if it is not set. The maximum RRU is 40,000.

  5. Click Create Now.

    Wait for about 30 seconds and refresh the table list to check whether the table is created.

  1. Log in to the Huawei Cloud console.
  2. In the navigation pane, choose Serverless > DynamoDB-compatible.
  3. You can enter a keyword (such as a table ID or name) in the search box.

    Figure 2 Viewing a Serverless table

  4. Click a table name to view details.

    Figure 3 Table details

  1. Log in to the Huawei Cloud console.
  2. In the navigation pane, choose Serverless > DynamoDB-compatible.
  3. Select the table to be deleted and click Delete.

    Figure 4 Deleting a Serverless table

  4. Confirm the table name and ID and click OK.

    Wait for about 30 seconds and refresh the table list to check whether the table is deleted.