创建MaxCompute项目空间后,您需要进入项目空间才可以执行后续开发、分析、运维等一系列操作。本文为您介绍如何进入或查看项目空间,以及设置或查看项目空间Project级的属性。
项目空间操作的常用命令如下。
类型 | 功能 | 角色 | 操作入口 |
---|---|---|---|
进入项目空间 | 进入具备访问权限的项目空间。 | 具备项目空间访问权限的用户 | 本文中的命令您需要在MaxCompute客户端执行。 |
查看项目空间属性 | 查看项目空间配置的属性信息。 | 项目空间Owner | |
设置项目空间属性 | 设置项目空间的属性信息。 | 项目空间Owner | |
查看项目空间账号体系 | 显示当前项目空间支持的账号体系信息。 | 项目空间Owner | |
增加RAM账号体系 | 为当前项目空间增加RAM账号体系。 | 项目空间Owner | |
删除RAM账号体系 | 删除当前项目空间的RAM账号体系。 | 项目空间Owner |
注意事项
- 项目空间非工作空间。项目空间名称获取方式:登录MaxCompute控制台,项目管理页签下的MaxCompute项目名称即项目空间名称。
- MaxCompute没有提供创建和删除项目空间的命令。创建项目空间操作详情请参见创建项目空间。
进入项目空间
进入指定的、具有访问权限的项目空间。进入项目空间后,可以直接操作该项目空间下的所有对象。
- 命令格式
use <project_name>;
- 参数说明
project_name:待访问项目空间的名称。如果项目空间不存在或您不属于该项目空间时,返回报错。
- 使用示例
- 示例1:进入指定项目空间并访问项目空间下的对象。
MaxCompute自动在项目空间my_project_test中搜索表。如果表存在,返回表中的数据;如果表不存在,返回报错。--当前项目空间为my_project,待访问项目空间为my_project_test。my_project_test是用户有权限访问的一个项目空间。 odps@ my_project>use my_project_test; --查询my_project_test项目空间下的表test_src。 odps@ my_project_test>select * from test_src;
- 示例2:跨项目访问另一项目空间下的对象,需要指定项目空间名称。
--在my_project_test项目空间下访问另一项目空间my_project2的表test_src。 odps@ my_project_test>select * from my_project2.test_src;
- 示例1:进入指定项目空间并访问项目空间下的对象。
查看项目空间属性
显示当前项目空间Project级的属性配置信息。MaxCompute也支持查看Session级的属性,详情请参见show flags。
- 命令格式
setproject;
- 属性说明
项目空间的常用属性如下。
属性名称(KEY) 描述 取值范围(VALUE) odps.sql.allow.fullscan 设置项目空间是否允许全表扫描。全表扫描会占用大量资源,为提升处理效率,不建议开启该功能。 - True:允许全表扫描。
- False:禁止全表扫描。
odps.table.lifecycle 设置项目空间下的表是否需要配置生命周期。 - Optional:创建表时,Lifecycle子句为可选设置,如果不设置表的生命周期,则该表永久有效。
- Mandatory:Lifecycle子句为必选设置,用户必须设置表的生命周期。
- Inherit:创建表时,如果不设置表的生命周期,则该表的生命周期为odps.table.lifecycle.value的值。
odps.table.lifecycle.value 设置表的生命周期。单位为:天。 1~37231,默认值为37231。 odps.security.ip.whitelist 设置经典网络场景下可以访问项目空间的IP白名单。详情请参见设置IP白名单。 IP列表,以英文逗号(,)分隔。 odps.security.vpc.whitelist 指定VPC网络场景下可以访问项目空间的IP白名单。详情请参见设置IP白名单。 RegionID_VPCID[IP Address]。 READ_TABLE_MAX_ROW 设置SELECT语句返回的数据条数。 1~10000,默认值为10000。 odps.sql.type.system.odps2 2.0新数据类型开关。2.0数据类型详情请参见2.0数据类型版本。 - True:打开
- False:关闭
odps.sql.hive.compatible Hive兼容模式开关。打开Hive兼容模式后,MaxCompute才支持Hive指定的各种语法,例如 inputRecordReader
、outputRecordReader
和Serde
。Hive兼容数据类型详情请参见Hive兼容数据类型版本。- True:打开
- False:关闭
odps.sql.decimal.odps2 DECIMAL 2.0数据类型 DECIMAL(precision,scale)
开关。详情请参见2.0数据类型版本。- True:打开
- False:关闭
odps.timemachine.retention.days 设置备份数据的保留天数。详情请参见备份与恢复。 0~30,默认值为1。 odps.instance.priority.enable 使用包年包月计算资源项目空间的作业优先级功能开关。详情请参见作业优先级。 0~9,默认值为9。数值越小,优先级越高。 odps.output.field.formatter 设置SQL查询结果的动态脱敏规则。详情请参见MaxCompute数据动态脱敏。 自定义的动态脱敏规则。 odps.sql.metering.value.max 单SQL消费限制值。详情请参见消费控制。 无。
设置项目空间属性
设置项目空间的Project级属性。设置项目空间属性命令会存在0~5分钟的时延。命令执行成功后,请您等待5分钟后验证执行结果。MaxCompute也支持设置Session级的属性,详情请参见set。
- 命令格式
setproject <KEY>=<VALUE>;
- 参数说明
- KEY:属性名称。
- VALUE:属性值。属性详情请参见查看项目空间属性。
- 使用示例
设置允许在项目空间执行全表扫描操作。
setproject odps.sql.allow.fullscan=true;
查看项目空间账号体系
显示当前项目空间支持的账号体系信息。命令格式如下:
list accountproviders;
说明 MaxCompute项目空间默认仅能识别阿里云账号体系,无法识别RAM账号体系。
增加RAM账号体系
为当前项目空间增加RAM账号体系。命令格式如下:
add accountprovider ram;
删除RAM账号体系
删除当前项目空间的RAM账号体系。命令格式如下:
remove accountprovider ram;