すべてのプロダクト
Search
ドキュメントセンター

DataWorks:UpdateTable

最終更新日:Sep 29, 2026

MaxCompute テーブルを更新します。

説明

この API は、代替案なしで廃止されました。一時的にアクセス可能ですが、更新やバグ修正対応は一切行われません。継続的な機能を確保するため、移行を計画し、アカウントマネージャーにお問い合わせください。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

この操作の認証情報はありません。問題が発生した場合は、アカウントマネージャーにご連絡ください。

リクエストパラメーター

パラメーター

型

必須 / 任意

説明

例

IsView

integer

任意

テーブルがビューであるかどうかを指定します。有効な値: 0、1。値 0 は、テーブルがビューではないことを示します。値 1 は、テーブルがビューであることを示します。このパラメーターは非推奨です。このパラメーターは使用しないでください。

0

Visibility

integer

任意

テーブルが表示される範囲。有効な値: 0、1、2。値 0 は、テーブルがすべてのメンバーに対して非表示であることを示します。値 1 は、テーブルがすべてのメンバーに対して表示されることを示します。値 2 は、テーブルがワークスペースのメンバーに対して表示されることを示します。

1

LifeCycle

integer

任意

テーブルのライフサイクル。単位: 日。このパラメーターが空の場合、テーブルは永続的に保存されます。

10

CategoryId

integer

任意

関連付けられたカテゴリの ID。

101

LogicalLevelId

integer

任意

論理レベルの ID。

101

PhysicsLevelId

integer

任意

物理層の ID。

101

ExternalTableType

string

任意

外部テーブルのタイプ。有効な値: 0、1、2、3。値 0 は、外部テーブルが OSS 外部テーブルであることを示します。値 1 は、外部テーブルが Tablestore 外部テーブルであることを示します。値 2 は、外部テーブルがボリューム外部テーブルであることを示します。値 3 は、外部テーブルが MySQL 外部テーブルであることを示します。このパラメーターは非推奨です。このパラメーターは使用しないでください。

1

Location

string

任意

外部テーブルのストレージの場所。このパラメーターは非推奨です。このパラメーターは使用しないでください。

location

ProjectId

integer

任意

DataWorks ワークスペースの ID。DataWorks コンソールにログインして、DataWorks ワークスペースの ID を取得できます。

101

TableName

string

必須

MaxCompute テーブルの名前。

abc

Endpoint

string

任意

MaxCompute のエンドポイント。このパラメーターを指定しない場合、MaxCompute プロジェクトのエンドポイントが使用されます。

odps://

EnvType

integer

任意

DataWorks ワークスペースの環境。有効な値: 0、1。値 0 は開発環境を示します。値 1 は本番環境を示します。

1

AppGuid

string

任意

MaxCompute プロジェクトの一意の識別子。GUID を odps.{projectName} フォーマットで指定します。

odps.test

CreateIfNotExists

boolean

任意

テーブルが存在するかどうかを指定します。有効な値:

  • true: テーブルが存在します。

  • false: テーブルが存在しません。

このパラメーターは非推奨です。このパラメーターは使用しないでください。

true

HasPart

integer

任意

更新するテーブルがパーティションテーブルであるかどうかを指定します。有効な値: 0、1。値 0 は、テーブルがパーティションテーブルではないことを示します。値 1 は、テーブルがパーティションテーブルであることを示します。このパラメーターは非推奨です。このパラメーターは使用しないでください。MaxCompute テーブルがパーティションテーブルであるかどうかを指定するには、HasPart パラメーターの代わりに Column.N.isPartitionCol パラメーターを使用します。Column.N.isPartitionCol パラメーターが 1 に設定されている場合、MaxCompute テーブルはパーティションテーブルです。

0

Comment

string

任意

コメント。

Comment

Schema

string

任意

テーブルのスキーマフォーマット。MaxCompute でテーブルスキーマを有効にする場合は、テーブルのスキーマフォーマットを入力する必要があります。

default

Columns

array<object>

任意

フィールドのリスト。

object

任意

返されるオブジェクト。

ColumnNameCn

string

任意

フィールドの表示名。

Chinese name

ColumnName

string

必須

フィールドの名前。

abc

Comment

string

任意

フィールドのコメント。

Comment

ColumnType

string

必須

フィールドのフォーマット。詳細については、MaxCompute のフィールドフォーマットを参照してください。

string

SeqNumber

integer

任意

フィールドのシーケンス番号。フィールドがパーティションフィールドの場合、このパラメーターはサポートされていません。

1

Length

integer

任意

フィールドの長さ。

10

IsPartitionCol

boolean

任意

フィールドがパーティションフィールドであるかどうかを指定します。有効な値: 0、1。値 0 は、フィールドがパーティションフィールドではないことを示します。値 1 は、フィールドがパーティションフィールドであることを示します。

0

Themes

array<object>

任意

フィールドのリスト。

object

任意

返されるオブジェクト。

ThemeId

integer

任意

関連付けられた Topic の ID。

101

ThemeLevel

integer

任意

Topic ID に対応するレベル。

101

レスポンスフィールド

フィールド

型

説明

例

object

返される結果。

RequestId

string

リクエスト ID。

abcde

TaskInfo

object

リクエストタスクに関する情報フォーマット。リクエストタスクが送信されると、複数のサブタスクに分割され、シーケンスで実行されます。現在のサブタスクが成功すると、次のサブタスクの実行が開始されます。すべてのサブタスクが完了すると、リクエストタスクが完了します。以下のいずれかの問題によりリクエストタスクが終了した場合は、エラーコードに基づいて問題に対処し、リクエストタスクを再度開始してください。

  • リクエストタスクの送信に失敗した。

  • リクエストタスクの送信後、サブタスクの実行に失敗した。

Status

string

現在のサブタスクのステータスフォーマット。有効な値:

  • operating: サブタスクが実行中です。

  • success: サブタスクが成功しました。

  • failure: サブタスクの実行に失敗しました。エラーの詳細については、Content パラメーターを参照してください。

success

NextTaskId

string

次に実行するサブタスクの ID。このフィールドが空の場合、すべてのサブタスクが完了しています。この ID を使用して、 GetDDLJobStatus を呼び出すことで、対応するサブタスクのステータスをクエリできます。

abc1

TaskId

string

現在のサブタスクの ID。

abc

Content

string

現在のサブタスクのステータスに関する詳細。有効な値:

  • 現在のサブタスクが成功した場合、success が返されます。

  • 現在のサブタスクが失敗した場合、エラーの詳細が表示されます。

success

例

成功レスポンス

JSONJSON

{
  "RequestId": "abcde",
  "TaskInfo": {
    "Status": "success",
    "NextTaskId": "abc1",
    "TaskId": "abc",
    "Content": "success"
  }
}

エラーコード

HTTP ステータスコード

エラーコード

エラーメッセージ

説明

500 InternalError.System An internal system error occurred. Try again later.
500 InternalError.UserId.Missing An internal system error occurred. Try again later.
403 Forbidden.Access Access is forbidden. Please first activate DataWorks Enterprise Edition or Flagship Edition.
429 Throttling.Api The request for this resource has exceeded your available limit.
429 Throttling.Api.Risk The request for this resource has exceeded your daily available limit.
429 Throttling.System The DataWorks system is busy. Try again later.
429 Throttling.User Your request is too frequent. Try again later.

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。