项目空间操作

注意事项

• 项目空间非工作空间。项目空间名称获取方式：登录MaxCompute控制台，项目管理页签下的MaxCompute项目名称即项目空间名称。
• MaxCompute没有提供创建和删除项目空间的命令。创建项目空间操作详情请参见创建项目空间。

进入项目空间

进入指定的、具有访问权限的项目空间。进入项目空间后，可以直接操作该项目空间下的所有对象。

• 命令格式

  use <project_name>;

• 参数说明

  project_name：待访问项目空间的名称。如果项目空间不存在或您不属于该项目空间时，返回报错。

• 使用示例
  • 示例1：进入指定项目空间并访问项目空间下的对象。

    --当前项目空间为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;

    MaxCompute自动在项目空间my_project_test中搜索表。如果表存在，返回表中的数据；如果表不存在，返回报错。
  • 示例2：跨项目访问另一项目空间下的对象，需要指定项目空间名称。

    --在my_project_test项目空间下访问另一项目空间my_project2的表test_src。
    odps@ my_project_test>select * from my_project2.test_src;

查看项目空间属性

显示当前项目空间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;

增加RAM账号体系

add accountprovider ram;

删除RAM账号体系

remove accountprovider ram;