UpdateTable_数据湖构建_API文档

插件下载了解更多
VS Code 插件
安装插件之前,确保已安装 VS Code安装插件之前,确保已安装 VS Code
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
JetBrains 插件
安装插件之前,确保已安装 JetBrains IDE安装插件之前,确保已安装 JetBrains IDE
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.

流控信息

当前云产品API请求速率暂未透出。

授权信息

如下是此API对应的授权信息,用于RAM权限策略语句的Action元素中,为RAM用户或RAM角色授予调用此API的权限。请通过 RAM 访问控制设置,使用方法可参考访问控制帮助文档

具体说明如下:展开详情

操作访问级别资源类型条件关键字关联操作
dlf:UpdateTable
全部资源
*

请求语法

PUT /api/metastore/catalogs/databases/tables HTTP/1.1

请求参数

字段名称字段详情
Bodyobject

HTTP 请求体,均采用 JSON 格式。

请求说明

IsAsync:

  • true:表示异步调用,不等待后台任务返回,接口即返回结果,返回结果中带上 taskid,这样客户端可以通过 taskid 查询任务的状态。
  • false:表示同步调用,接口等待后台任务完成时,接口才返回结果。那么为 false 的风险就是如果后台任务需要做很长,接口会超时

返回参数

字段名称字段详情
Codestring

状态码描述。

示例值:OK
Messagestring

返回信息。

示例值:.
RequestIdstring

请求 ID。

示例值:B7F4B621-E41E-4C84-B97F-42B5380A32BB
Successboolean

是否调用成功。取值如下:展开详情

示例值:true
TaskIdstring

异步任务 ID。

示例值:aa689782deb97265701f57324fc4ae42

返回说明

Code 错误码说明:

  • InvalidOperation:对应的数据库、表不存在。
  • InternalError:其他类型错误,请参考 Message 提示。
  • taskid:因为 updatetable 也会更新 table 的所有 partitions 信息,如果是异步提交,那么就会返回一个 taskid,用来跟踪异步任务的执行状态。如果同步提交,那么该值无意义。

返回示例

变更历史

变更时间变更内容概要操作
2021-05-13
变更请求参数Body
变更返回参数

相关示例