创建MaxCompute项目空间后,您需要进入项目空间才可以执行后续开发、分析、运维等一系列操作。本文为您介绍如何进入或查看项目空间,以及设置或查看项目空间Project级的属性。

项目空间操作的常用命令如下。
类型 功能 角色 操作入口
进入项目空间 进入具备访问权限的项目空间。 具备项目空间访问权限的用户 本文中的命令您需要在MaxCompute客户端执行。
查看项目空间属性 查看项目空间配置的属性信息。 项目空间Owner
设置项目空间属性 设置项目空间的属性信息。 项目空间Owner
查看项目空间账号体系 显示当前项目空间支持的账号体系信息。 项目空间Owner
增加RAM账号体系 为当前项目空间增加RAM账号体系。 项目空间Owner
删除RAM账号体系 删除当前项目空间的RAM账号体系。 项目空间Owner

注意事项

  • 项目空间非工作空间。项目空间名称获取方式:登录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指定的各种语法,例如inputRecordReaderoutputRecordReaderSerde。Hive兼容数据类型详情请参见Hive兼容数据类型版本
    • True:打开
    • False:关闭
    odps.sql.decimal.odps2 DECIMAL 2.0数据类型DECIMAL(precision,scale)开关。详情请参见2.0数据类型版本
    • True:打开
    • False:关闭
    odps.sql.metering.value.max 设置单SQL消费限制值。详情请参见消费控制 无。
    odps.sql.timezone 设置MaxCompute项目的时区。更多时区信息,请参见时区配置操作 无。
    odps.sql.unstructured.oss.commit.mode 设置是否开启通过OSS的分片上传功能向OSS外部表写入数据。详情请参见输出到OSS的非结构化数据
    • True:打开
    • False:关闭

设置项目空间属性

设置项目空间的Project级属性。设置项目空间属性命令会存在0~5分钟的时延。命令执行成功后,请您等待5分钟后验证执行结果。MaxCompute也支持设置Session级的属性,详情请参见set

  • 命令格式
    setproject <KEY>=<VALUE>;
  • 参数说明
  • 使用示例
    设置允许在项目空间执行全表扫描操作。
    setproject odps.sql.allow.fullscan=true;

查看项目空间账号体系

显示当前项目空间支持的账号体系信息。账号体系包括ALIYUN、RAM两种。命令格式如下:
list accountproviders;
说明 MaxCompute项目空间默认仅能识别阿里云账号体系,无法识别RAM账号体系。

增加RAM账号体系

为当前项目空间增加RAM账号体系。命令格式如下:
add accountprovider ram;

删除RAM账号体系

删除当前项目空间的RAM账号体系。命令格式如下:
remove accountprovider ram;