CREATE MANAGED ACCOUNT

创建新的托管账户。目前由数据提供商用于为其使用者创建读者账户。有关更多详细信息，请参阅 管理阅读者账户。

另请参阅：

DROP MANAGED ACCOUNT、SHOW MANAGED ACCOUNTS

语法

CREATE MANAGED ACCOUNT <name>
    ADMIN_NAME = <username> , ADMIN_PASSWORD = <user_password> ,
    TYPE = READER ,
    [ COMMENT = '<string_literal>' ]
Copy

必填参数

name

托管账户的标识符；对于账户来说必须唯一。

此外，标识符必须以字母字符开头，且不能包含空格或特殊字符，除非整个标识符字符串放在双引号内（例如，"My object"）。

有关更多详细信息，请参阅 标识符要求。

重要

托管账户的标识符与账户访问所需的账户名称不同。账户名称，也称为 定位器，由 Snowflake 分配。

ADMIN_NAME = username

托管账户中初始用户的标识符以及登录名。此用户担任账户的账户管理员（即，系统会在创建账户时自动创建此用户，并为其分配 ACCOUNTADMIN 角色）。

创建账户之后，您将以此用户的身份登录账户以配置（即“启动”）账户。

ADMIN_PASSWORD = user_password

托管账户中初始用户的密码。密码是字符串字面量，必须放在单引号或双引号内，并且必须符合 Snowflake 提供的密码策略。

TYPE = READER

指定托管账户的类型。目前，唯一支持的类型是 :code:`READER`（即，用于数据共享的阅读者账户）。

可选参数

COMMENT = 'string_literal'

为托管账户指定注释。

访问控制要求

用于执行此 SQL 命令的 角色 必须至少具有以下 权限：

权限

对象

备注

CREATE ACCOUNT

账户

Only the ACCOUNTADMIN role has this privilege by default. The privilege can be granted to additional roles as needed.

有关创建具有指定权限集的自定义角色的说明，请参阅 创建自定义角色。

有关对 安全对象 执行 SQL 操作的相应角色和权限授予的一般信息，请参阅 访问控制概述。

使用说明

  • 默认情况下，提供商可以创建的阅读者账户总数为 20 个。如果您达到该限额但需要创建更多账户，请联系 Snowflake 支持部门。

    如果您为了创建新账户而删除了阅读者账户，但没有超过此限制，则在 7 天之内不能创建新阅读者账户，这是已删除阅读者账户的保留期。

  • 如果命令成功完成，它会返回 JSON 对象，包含账户名称/定位器以及用于访问账户的 URL。

  • 关于元数据：

    注意

    客户应确保在使用 Snowflake 服务时，不会将个人数据（用户对象除外）、敏感数据、出口管制数据或其他受监管数据作为元数据输入。有关更多信息，请参阅 Snowflake 中的元数据字段。

  • CREATE OR REPLACE <object> 语句是原子的。也就是说，当对象被替换时，旧对象将被删除，新对象将在单个事务中创建。

示例

CREATE MANAGED ACCOUNT reader_acct1
    ADMIN_NAME = user1 , ADMIN_PASSWORD = 'Sdfed43da!44' ,
    TYPE = READER;
Copy
+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| status                                                                                                                                                                            |
|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| {"accountName":"READER_ACCT1","accountLocator":"IIB88126","url":"https://myorg-reader_acct1.snowflakecomputing.cn","accountLocatorUrl":"https://iib88126.snowflakecomputing.cn"}|
+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
语言: 中文