All Products
Search
Document Center

Hologres:Manage users

Last Updated:Feb 28, 2026

You can add and remove users, assign roles, and grant permissions for a Hologres instance from the User Management page in the console.

Account types and roles

Hologres supports three account types:

Account typeSystem identifierAuthenticationScope
Alibaba Cloud account (ALIYUN)11822780xxxAccessKey pair (automatic)All Alibaba Cloud services
RAM user (RAM)p4_269499383xxxxAccessKey pair (automatic)All Alibaba Cloud services (within granted permissions)
Custom account (BASIC)BASIC$xxxPasswordHologres only

Each user has one of two roles:

  • Superuser: Has all permissions on the instance. No additional authorization required.

  • Normal: Has no permissions after creation. You must grant permissions before this user can access databases, schemas, or tables.

The Alibaba Cloud account that purchased the instance is the default superuser and has all permissions on that instance. Before you add other users, the User Management page displays only this account.

Prerequisites

OperationRequired account
Add a userAlibaba Cloud account, or a RAM user with the Superuser role and the AliyunRAMReadOnlyAccess policy attached
Create a custom userSuperuser account
Delete a user or reset a passwordSuperuser account

Add a user

Add an existing RAM user to a Hologres instance.

  1. On the User Management page, select the target instance and click Add User in the upper-right corner.

  2. In the Add User dialog box, select a RAM user associated with the current Alibaba Cloud account.

  3. Select a role: Superuser or Regular User.

  4. Click OK.

Note If the current Alibaba Cloud account has no RAM users, create one first. For more information, see Quick Start for RAM user authorization. A RAM user that adds other users must have the AliyunRAMReadOnlyAccess permission. For more information, see Grant permissions to a RAM user.

Grant permissions to a normal user

After you add a normal user, grant permissions so the user can access databases and objects:

Create a custom user

Custom users authenticate with a username and password instead of an AccessKey pair and are valid only within Hologres.

Important

Custom users cannot access other Alibaba Cloud services directly. To allow a custom user to query MaxCompute foreign tables, create a user mapping. See Create a user mapping for MaxCompute access.

Console

  1. On the User Management page, select the target instance and click Create Custom User in the upper-right corner.

  2. In the Create Custom User dialog box, configure the following parameters:

    ParameterDescription
    Account NameEnter a username. Up to 57 characters. Only lowercase letters, digits, and underscores (_) are allowed. The username cannot end with admin, developer, writer, viewer, or all_users.
    Select Member RoleSelect Superuser or Regular User.
    Password8 to 32 characters. Must contain at least three of these character types: uppercase letters, lowercase letters, digits, and special characters (!@#$%^&*()_+-=).
    Confirm PasswordRe-enter the password.
  3. Click OK.

SQL

CREATE USER "BASIC$<user_name>" WITH PASSWORD '<password>';
  • user_name: the custom username.

  • password: the password for the custom user.

Reset a custom user password

Only custom user passwords can be reset. Alibaba Cloud accounts and RAM users authenticate with automatically generated AccessKey pairs.

Console

  1. On the User Management page, find the target custom user in the User Account Authorization list.

  2. Click Reset Password in the Actions column.

  3. In the Reset Password dialog box, enter and confirm the new password.

  4. Click OK.

SQL

ALTER USER "BASIC$<user_name>" WITH PASSWORD '<password>';
  • user_name: the custom username.

  • password: the new password.

Delete a user

Deleting a user removes the user from the instance and revokes all access permissions.

Delete a RAM user or Alibaba Cloud account

On the User Management page, select the target instance, find the user in the list, and click Delete in the Actions column.

Delete a custom user

Console

  1. On the User Management page, find the target custom user in the User Account Authorization list.

  2. Click Delete in the Actions column.

  3. In the Remove User dialog box, click OK.

SQL

DROP USER "BASIC$<user_name>";
  • user_name: the custom username.

Create a user mapping for MaxCompute access

Custom accounts exist only within Hologres and cannot query MaxCompute foreign tables by default. If a custom account attempts to query a MaxCompute foreign table, the following error occurs:

ERROR:  Query:[xxxxxx] Build desc failed: failed to check permission: Authorization Failed [4002], You don't exist in project hologres_test. Context ID:xxxxxx-xxxx-xxxx-xxxx-xxxxxxx.    --->Tips: Pricipal:INVALID$BASIC$xxx; You don't exist in project xxx

To resolve this, create a USER MAPPING that attaches the custom account to a RAM user with the required permissions on the MaxCompute project and the Hologres database.

Syntax

CREATE USER MAPPING
FOR "<user_name>"
SERVER odps_server
OPTIONS
(
    access_id '<Access_id>',
    access_key '<Access_key>'
);

Parameters

ParameterDescription
user_nameThe username of the custom account.
access_idThe AccessKey ID of an account that has logon permissions for the current database. Obtain this from AccessKey Management.
access_keyThe AccessKey secret of an account that has logon permissions for the current database. Obtain this from AccessKey Management.

Examples

Create a USER MAPPING for a specific custom user:

CREATE USER MAPPING
FOR "BASIC$test"
SERVER odps_server
OPTIONS (
  access_id 'LTxxxxxxxxxx',
  access_key 'y8xxxxxxxxxxxxx');

Create a USER MAPPING for the current user:

CREATE USER MAPPING
FOR CURRENT_USER
SERVER odps_server
OPTIONS (
  access_id 'LTxxxxxxxxxx',
  access_key 'y8xxxxxxxxxxxxx');

User Management page columns

The User Management page displays the following columns:

ColumnDescription
Account NameThe username in the current instance. Includes Alibaba Cloud accounts, Resource Access Management (RAM) users, and custom accounts.
Account IDThe account ID. For example: Alibaba Cloud account 11822780xxx, RAM user p4_269499383xxxx, or custom account BASIC$xxx.
Account TypeOne of: Alibaba Cloud Account (ALIYUN), RAM User (RAM), or Basic User (BASIC).
Role TypeSuperuser or Normal.
ActionsOperations available for the user, such as Delete, Reset Password, or Change Role.

References

For more information about deleting an account (DROP USER) in Hologres and troubleshooting related errors, see Delete an account.