CREATE USER

功能概述

将用户添加到当前工作空间中,使其能够访问和操作工作空间内的资源。

语法

CREATE USER [IF NOT EXISTS] user_name [ DEFAULT_VCLUSTER = vc_name ] [ DEFAULT_SCHEMA = schema_name ] [ COMMENT = 'comment_text' ];

参数说明

参数必填说明
IF NOT EXISTS
IF NOT EXISTS
若用户已存在于工作空间中,则跳过操作不报错
user_name
user_name
用户标识,必须是已在实例用户管理系统中创建的用户名
DEFAULT_VCLUSTER
DEFAULT_VCLUSTER
为用户指定默认计算集群。未指定时使用工作空间的全局默认集群
DEFAULT_SCHEMA
DEFAULT_SCHEMA
为用户指定默认 Schema。设置后用户登录时自动使用该 Schema,会话中可用
USE
USE
命令切换。优先级:
USE
USE
命令 > 默认 Schema
COMMENT
COMMENT
为用户添加备注信息

使用示例

  1. 将用户

    uat_test
    uat_test
    添加到工作空间,使用全局默认计算集群和 Schema:

    CREATE USER uat_test;

  2. 添加用户并同时指定默认计算集群和默认 Schema:

    CREATE USER uat_test DEFAULT_VCLUSTER=vcluster1 DEFAULT_SCHEMA=schema1;

  3. 使用

    IF NOT EXISTS
    IF NOT EXISTS
    避免重复添加报错:

    CREATE USER IF NOT EXISTS uat_test;

  4. 添加用户并附加备注信息:

    CREATE USER uat_test COMMENT='UAT 环境测试账号';

以上命令执行成功后返回空结果集,无错误信息即表示操作成功。

注意事项

  • 执行此命令需要具备
    workspace_admin
    workspace_admin
    user_admin
    user_admin
    角色。
  • user_name
    user_name
    必须是在实例用户管理系统(非工作空间层面)中已存在的账号,否则报错
    NotFound: 没有这样的用户
    NotFound: 没有这样的用户
  • 用户被添加到工作空间后,默认没有任何数据权限,需通过
    GRANT
    GRANT
    命令或分配角色来授予权限。
  • 使用
    IF NOT EXISTS
    IF NOT EXISTS
    时,如果用户已存在,命令静默成功,不会修改已有配置。
联系我们
预约咨询
微信咨询
电话咨询