すべてのプロダクト
Search

このプロダクト

    DataWorks:CreateTable

    ドキュメントセンター

    DataWorks:CreateTable

    最終更新日:Sep 29, 2026

    MaxCompute テーブルを作成します。

    説明

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

    今すぐお試しください

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

    テスト

    RAM 認証

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

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    IsView

    integer

    任意

    ビューまたはテーブルを作成するかどうかを指定します。有効な値:

    • 0: テーブルを作成します。

    • 1: ビューを作成します。

    0
    Visibility

    integer

    任意

    テーブルまたはワークスペースが表示されるかどうかを指定します。有効な値:

    • 0: テーブルとワークスペースの両方が非表示になります。

    • 1: テーブルとワークスペースの両方が表示されます。

    • 2: ワークスペースのみが表示されます。

    1
    LifeCycle

    integer

    任意

    テーブルのライフサイクル。単位: 日。デフォルトではこのパラメーターは空であり、テーブルが永続的に保存されることを示します。

    10
    CategoryId

    integer

    任意

    関連付けられたカテゴリの ID。 GetMetaCategory 操作を呼び出して、関連付け可能なすべてのカテゴリの ID を照会できます。

    101
    LogicalLevelId

    integer

    任意

    論理レベルの ID。

    101
    PhysicsLevelId

    integer

    任意

    物理レベルの ID。

    101
    ExternalTableType

    string

    任意

    外部テーブルのストレージタイプ。有効な値:

    • 0: Object Storage サービス (OSS)

    • 1: Tablestore

    • 2: ボリューム

    • 3: MySQL

    0
    Location

    string

    任意

    外部テーブルのストレージ場所。

    location
    ProjectId

    integer

    任意

    DataWorks ワークスペースの ID。

    23
    TableName

    string

    必須

    テーブル名。

    tableName1
    Endpoint

    string

    任意

    MaxCompute のエンドポイント。

    odps://abc
    EnvType

    integer

    任意

    DataWorks ワークスペースの環境タイプ。有効な値:

    • 0: 開発環境

    • 1: 本番環境

    1
    AppGuid

    string

    任意

    MaxCompute プロジェクトの ID。ID は odps.{projectName} フォーマットで指定します。

    odps.test
    Comment

    string

    任意

    コメント。

    Comment
    HasPart

    integer

    任意

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

    0
    ClientToken

    string

    任意

    予約済みパラメーター。

    Reserved field
    Schema

    string

    任意

    テーブルのスキーマ情報。MaxCompute で 3 レイヤーモデルを有効にする場合は、テーブルのスキーマ情報を入力する必要があります。

    default
    Columns

    array<object>

    必須

    フィールドのリスト。最大 1,000 個のフィールドがサポートされます。

    object

    任意

    フィールド。

    ColumnNameCn

    string

    任意

    フィールドの中国語名。

    Chinese name
    ColumnName

    string

    必須

    フィールド名。CreateTable 操作を呼び出してテーブルを作成する際、最大 1,000 個のフィールドを設定できます。

    columnName1
    Comment

    string

    任意

    フィールドのコメント。

    Comment
    ColumnType

    string

    必須

    フィールドのデータの型。サポートされるフィールドタイプは、MaxCompute プロジェクトで使用するデータ型エディションによって異なります。各エディションでサポートされるデータ型の情報については、MaxCompute ドキュメントの「データ型エディション」を参照してください。

    string
    SeqNumber

    integer

    任意

    フィールドのシーケンス番号。このパラメーターを使用して、テーブル内でのフィールドのソート方法を指定できます。デフォルトでは、フィールドは作成リクエストで指定された順序に基づいてソートされます。フィールドがパーティションフィールドである場合、このパラメーターはサポートされません。

    1
    Length

    integer

    任意

    フィールドの長さ。詳細については、「MaxCompute データの型エディション」を参照してください。

    10
    IsPartitionCol

    boolean

    任意

    フィールドがパーティションフィールドであるかどうかを指定します。

    true
    Themes

    array<object>

    任意

    テーマのリスト。

    object

    任意

    返されるオブジェクト。

    ThemeId

    integer

    任意

    テーマ ID。

    101
    ThemeLevel

    integer

    任意

    テーマ ID に対応するレベル。

    101

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    レスポンス要素。

    RequestId

    string

    リクエスト ID。

    abcdef
    TaskInfo

    object

    リクエストタスクの情報。リクエストタスクが送信されると、複数のサブタスクに分割され、シーケンスで実行されます。現在のサブタスクが正常に完了すると、次のサブタスクが実行されます。すべてのサブタスクが完了すると、リクエストタスクが完了します。

    以下のいずれかの発行によりリクエストタスクが中断された場合は、エラーコードに基づいて発行に対処し、リクエストタスクを再実行してください。

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

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

    Status

    string

    現在のサブタスクのステータス。有効な値:

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

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

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

    success
    NextTaskId

    string

    次に実行するサブタスクの ID。このフィールドが空の場合、すべてのサブタスクが完了しています。

    abc1
    TaskId

    string

    現在のサブタスクの ID。

    abc
    Content

    string

    現在のサブタスクのステータスに関する詳細。

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

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

    success

    例

    成功レスポンス

    JSONJSON

    {
  "RequestId": "abcdef",
  "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.

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

    変更履歴

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