- 类别:
:doc:`/sql-reference/functions-system`(系统控制)
SYSTEM$INITIATE_MOVE_ORGANIZATION_ACCOUNT¶
启动将 组织账户 移动到新区域的过程。
语法¶
SYSTEM$INITIATE_MOVE_ORGANIZATION_ACCOUNT(
'<temp_name>' ,
'<region>' ,
{ 'ALL' | '<object> [, <object> ...]' } )
实参¶
'temp_name'
指定一个临时账户名,在移动完成之前可以通过该临时账户名识别新区域中的组织账户。名称必须以字母开头,且只能包含大写字母、数字和下划线。
当 SYSTEM$COMMIT_MOVE_ORGANIZATION_ACCOUNT 函数成功完成后,新区域的组织账户名称将从该临时账户名称更改为原始组织账户名称。
'region'
组织账户将迁移至的区域的 Snowflake 区域 ID。
{ 'ALL' | 'object [, object ...]' }
将移至新区域的组织账户的对象列表。由于 Snowflake 使用复制组来移动对象,因此您只能移动复制组支持的对象,这取决于您的 Snowflake 版本。有关可移动对象的列表,请参阅 复制对象。
要移动所有可以复制的对象,请指定
ALL
。
访问控制要求¶
只有拥有 GLOBALORGADMIN 角色才能调用此函数。
使用说明¶
在启动过程完成之前,您无法登录新区域中的组织账户。要检查过程的状态,请调用 SYSTEM$SHOW_MOVE_ORGANIZATION_ACCOUNT_STATUS 函数。
启动过程完成后,您可以使用组织账户的临时名称登录新区域中的组织账户,但无法执行除 SELECT、USE 和 SHOW 之外的任何 SQL 语句。
示例¶
SELECT SYSTEM$INITIATE_MOVE_ORGANIZATION_ACCOUNT('TEMP_ACCT', 'aws_us_west_2', 'ALL');