Creating a GaussDB(DWS) Database and User

Creating a Database

You can use the DDL syntax or SQL editor to create a table.

• DDL syntax: For details about the syntax, see "CREATE DATABASE".
• SQL editor: For details, see Using the SQL Editor to Connect to a GaussDB(DWS) Cluster.

Creating a Role

1. Log in to the GaussDB(DWS) console. In the navigation pane on the left, choose Dedicated Clusters > Clusters.
2. In the cluster list, click the name of the target cluster. The Cluster Information page is displayed.
3. In the navigation pane on the left, choose User Management.
4. Click Roles and click Create Role. The role creation page is displayed.
5. Configure role information. The parameters are described as follows:

   Table 1 Parameters for configuring role information

   Parameter	Description	Example Value
   Role Name	The value must start with a letter and can contain a maximum of 63 characters, including letters, digits, and underscores (_).	dws-demo
   Expires	Expiration time of the role permissions.	-
   System Administrator	Whether the role has the system administrator rights.	-
   Create Database	Whether the role has the permission to create databases.	-
   Create Role	Whether the role has the permission to create users and roles.	-
   Inherit Permissions	Whether the role inherits the permissions from its role group. By default, this function is enabled and it is best to keep it that way.	-

6. Confirm the settings and click Next.
7. Configure the permissions of the role.

   Click Add to add a permission configuration. Select the database object type and the corresponding objects. Then, select permissions. For details about permission definitions, see "DCL Syntax" > "GRANT" in GaussDB(DWS) SQL Overview.

   

8. After the authorization is complete, click Create.

Creating a Database User

You can use the DDL syntax or create a table on the GaussDB(DWS) console. For details about the DDL syntax, see "CREATE USER".

• If the current console does not support this feature, contact technical support.
• After a cluster is created, the users or roles created with it cannot be modified.
• Before using this function, ensure that the cluster is available.

1. Log in to the GaussDB(DWS) console. In the navigation pane, choose Dedicated Clusters > Clusters.
2. In the cluster list, click the name of the target cluster. The Cluster Information page is displayed.
3. In the navigation pane, choose User Management.
4. On the Users page, click Create User.
5. Set the parameters on the Configure Basic Settings page.

   Table 2 Parameters on the Configure Basic Settings page

   Parameter	Description	Example Value
   Username	The value must start with a letter and can contain a maximum of 63 characters, including letters, digits, and underscores (_).	Dws-demo
   Password	Enter a value that is 12 to 32 characters long and can contain letters, digits, underscores (_), and special characters. NOTE: Your password must contain a minimum of three of the following character types: uppercase letters, lowercase letters, digits, and special characters (~!?,.:;_(){}[]/<>@#%^&*+|\=-)	-
   Maximum Connections	Maximum number of connections between the user and the database. The value –1 indicates that the number of connections is not limited.	–1
   Expires	Expiration time of the user's permissions.	-
   System Administrator	Whether the user is a system administrator.	-
   Create Database	Whether the user has the permission to create databases.	-
   Create Role	Whether the user has the permission to create users and roles.	-
   Inherit Permissions	Whether the user inherits permissions from its user group. By default, this function is enabled and it is best to keep it that way.	-

6. Confirm the settings and click Next.
7. On the Configure Roles page, select the role to be assigned to the user and click Next.
8. Configure permissions not included in the roles of the user.

   Click Add to add a permission configuration. Select the database object type and corresponding database object, and select the permission to complete assignment. For details about permission definitions, see "DCL Syntax" > "GRANT" in GaussDB(DWS) SQL Overview.

   

9. After the authorization is complete, click Create.

Modifying a User

1. Log in to the GaussDB(DWS) console. In the navigation pane, choose Dedicated Clusters > Clusters.
2. In the cluster list, click the name of the target cluster. The Cluster Information page is displayed.
3. In the navigation pane, choose User Management.
4. In the user list, select a user and click Modify. The page for modifying user details is displayed.
5. Modify the user information. For details, see Table 2. After confirming that the information is correct, click Next.
6. Select the role you want to grant to the user and click Next.
7. After selecting a permission type, you can click Edit in the Operation column and click Modify in the Permission column to add or remove a permission.

   

8. Confirm the permissions. Click Save.

Deleting a User

Prerequisites

To prevent any problems with deleting a user, check for dependencies between database objects (such as tables) beforehand. If there are any dependencies, delete them first before proceeding with the user deletion.

Procedure

1. Log in to the GaussDB(DWS) console. In the navigation pane, choose Dedicated Clusters > Clusters.
2. In the cluster list, click the name of the target cluster. The Cluster Information page is displayed.
3. In the navigation pane, choose User Management.
4. Select a user from the user list and click Delete. A confirmation dialog box is displayed.
5. Click OK.

Exporting a User

1. Log in to the GaussDB(DWS) console. In the navigation pane, choose Dedicated Clusters > Clusters.
2. In the cluster list, click the name of the target cluster. The Cluster Information page is displayed.
3. In the navigation pane, choose User Management.
4. Click Export in the upper part of the user list and select the number of records to be exported to export the user list.
   Figure 1 Exporting a user
   

5. Confirm the configurations and click Export.

Exporting User Permissions

1. Log in to the GaussDB(DWS) console. In the navigation pane, choose Dedicated Clusters > Clusters.
2. In the cluster list, click the name of the target cluster. The Cluster Information page is displayed.
3. In the navigation pane, choose User Management.
4. Select a user from the user list and click Export Permissions to export the user permission list.
   Figure 2 Exporting permissions
   

Modifying a Role

1. Log in to the GaussDB(DWS) console. In the navigation pane, choose Dedicated Clusters > Clusters.
2. In the cluster list, click the name of the target cluster. The Cluster Information page is displayed.
3. In the navigation pane, choose User Management.
4. In the role list, select a user and click Modify. The page for modifying role details is displayed.
5. Modify the role information. For the parameter description, see Table 1.
6. Confirm the settings and click Next.
7. Configure permissions. Select a permission type as required, click Edit in the Operation column, and click Modify in the Permission column to add or remove permissions.
8. Confirm the permissions. Click Save.

Deleting a Role

Prerequisites

To prevent any problems with deleting a role, check for dependencies such as database objects beforehand. If there are any dependencies, delete them first before proceeding with the role deletion.

Procedure

1. Log in to the GaussDB(DWS) console. In the navigation pane, choose Dedicated Clusters > Clusters.
2. In the cluster list, click the name of the target cluster. The Cluster Information page is displayed.
3. In the navigation pane, choose User Management.
4. Select a role from the role list and click Delete. A confirmation dialog box is displayed.
5. Click OK to delete the role.

Exporting Roles

1. Log in to the GaussDB(DWS) console. In the navigation pane, choose Dedicated Clusters > Clusters.
2. In the cluster list, click the name of the target cluster. The Cluster Information page is displayed.
3. In the navigation pane, choose User Management and click Roles to switch to the role list page.
4. Click Export in the upper part of the role list and select the number of roles to be exported.
   Figure 3 Exporting roles
   

5. Confirm the information and click Export.

Exporting Role Permissions

1. Log in to the GaussDB(DWS) console. In the navigation pane, choose Dedicated Clusters > Clusters.
2. In the cluster list, click the name of the target cluster. The Cluster Information page is displayed.
3. In the navigation pane, choose User Management and click Roles to switch to the role list page.
4. Select a user from the role list, click Export Permissions, and select the number of records to be exported.
   Figure 4 Exporting role permissions