ALTER STAGE

语法说明

ALTER STAGE 用于修改现有已命名的内部或外部阶段的属性。

Note

集群管理员（即 root 用户）和租户管理员可以修改数据阶段。

语法结构

1. > ALTER STAGE [ IF EXISTS ] { stage_name }
2. { StageParams }
3. [ directoryTableParams ]
4. [ COMMENT = '<string_literal>' ]

6. StageParams (for Amazon S3) :
7. URL =  "endpoint"='<string>' CREDENTIALS = {"access_key_id"='<string>', "secret_access_key"='<string>'}

9. StageParams (for Aliyun OSS) :
10. URL =  "endpoint"='<string>' CREDENTIALS = {"access_key_id"='<string>', "secret_access_key"='<string>'}

12. StageParams (for File System) :
13. URL= 'filepath'

15. directoryTableParams :
16. ENABLE = { TRUE | FALSE }

语法解释

  • IF EXISTS：可选参数，用于在修改 Stage 时检查是否已存在要修改的 Stage。
  • stage_name：要修改的 Stage 的名称。

  • StageParams：这是一个参数组，用于指定 Stage 的配置参数。

  • endpoint：Stage 的连接 URL，指定对象存储服务的位置。对于不同的对象存储服务（如 Amazon S3、Aliyun OSS、文件系统等），这个 URL 的内容可能有所不同。例如：s3.us-west-2.amazonaws.com

  • CREDENTIALS：这是一个 JSON 对象，包含连接到对象存储服务所需的凭证信息，如 access_key_id、secret_access_key 等。

  • directoryTableParams：这是一个参数组，用于指定 Stage 的目录表（directory table）的配置。

  • ENABLE：是否修改启用目录表，值为 TRUE 或 FALSE。

示例

1. CREATE TABLE `user` (`id` int(11) ,`user_name` varchar(255) ,`sex` varchar(255));
2. INSERT INTO user(id,user_name,sex) values('1', 'weder', 'man'), ('2', 'tom', 'man'), ('3', 'wederTom', 'man');

4. -- 创建内部数据阶段
5. mysql> CREATE STAGE stage1 URL='/tmp' ENABLE = TRUE;

7. -- 将数据从表导出到数据阶段
8. mysql> SELECT * FROM user INTO OUTFILE 'stage1:/user.csv';
9. -- 你可以在你本地目录下看到你导出的表

11. mysql> SHOW STAGES;
12. +------------+-----------------------------+---------+---------+
13. | STAGE_NAME | URL                         | STATUS  | COMMENT |
14. +------------+-----------------------------+---------+---------+
15. | stage1     | /Users/Prinz/03testrepo/csv | ENABLED |         |
16. +------------+-----------------------------+---------+---------+
17. 1 row in set (0.01 sec)

19. -- 修改 stage
20. mysql> ALTER STAGE stage1 SET COMMENT 'user stage';

22. mysql> SHOW STAGES;
23. +------------+-----------------------------+---------+------------+
24. | STAGE_NAME | URL                         | STATUS  | COMMENT    |
25. +------------+-----------------------------+---------+------------+
26. | stage1     | /Users/Prinz/03testrepo/csv | ENABLED | user stage |
27. +------------+-----------------------------+---------+------------+
28. 1 row in set (0.00 sec)

30. -- 禁用名为 'stage1' 的数据阶段
31. mysql> ALTER STAGE stage1 SET ENABLE = FALSE;
32. Query OK, 0 rows affected (0.00 sec)

34. -- 尝试将 user 表的数据导出到名为 'stage1:/user.csv' 的数据阶段中，但 stage1 已经被禁用，所以已不可用，产生报错
35. mysql> SELECT * FROM user INTO OUTFILE 'stage1:/user.csv';
36. ERROR 20101 (HY000): internal error: stage 'stage1' is invalid, please check