ジャンプ先

• リクエスト
• レスポンス

データ・ロード・ジョブの作成

POST

/data-tools/data-loads/

リクエスト

サポートされるメディア・タイプ

• application/json

本文 ()

実行するデータ・ロード

ルート・スキーマ: data-loads

タイプ: object

ソースの表示

• data_loads(optional): array data_loads

{
    "type":"object",
    "properties":{
        "data_loads":{
            "type":"array",
            "items":{
                "$ref":"#/definitions/data-load"
            }
        }
    }
}

ネストされたスキーマ: data_loads

タイプ: array

ソースの表示

• 配列: オブジェクト data-load

{
    "type":"array",
    "items":{
        "$ref":"#/definitions/data-load"
    }
}

ネストされたスキーマ: data-load

タイプ: object

ソースの表示

• columns(optional): array columns
• data_load_job_id(optional): string
  データ・ロード・ジョブの名前

  例: SALES-LOAD-20220529-112233-4567
• format(optional): object format
  DBMS_CLOUD.COPY_DATA書式設定オプション
• merge_keys(optional): array merge_keys
• object_filter(optional): string
  ファイルのサブセットを選択するフィルタ

  例: *.csv
• object_filter_type(optional): string
  指定できる値: [ "GLOB", "REGEX" ]

  object_filterの一致のタイプ

  例: GLOB
• objects(optional): array data_load_objects
• partition_column_name(optional): string
  表をパーティション化する列名

  例: FISCAL_YEAR
• sql_statements(optional): array sql_statements
  データベース操作を実行するSQL文
• storage_link_name(optional): string
  クラウド・ストレージ・リンクの名前

  例: MY-BUCKET
• table_exists_action(optional): string
  指定できる値: [ "SKIP", "APPEND", "TRUNCATE", "MERGE", "REPLACE" ]

  既存の表がある場合に実行するアクション。

  例: APPEND
• table_name(optional): string
  ロードする表名

  例: SALES
• target_type(optional): string
  指定できる値: [ "TABLE", "EXTERNAL_TABLE" ]

  作成するデータベース・オブジェクトのタイプ。

  例: TABLE

{
    "type":"object",
    "properties":{
        "data_load_job_id":{
            "$ref":"#/definitions/data_load_job_id"
        },
        "table_name":{
            "$ref":"#/definitions/table_name"
        },
        "objects":{
            "$ref":"#/definitions/data_load_objects"
        },
        "storage_link_name":{
            "$ref":"#/definitions/storage_link_name"
        },
        "columns":{
            "$ref":"#/definitions/columns"
        },
        "object_filter":{
            "$ref":"#/definitions/object_filter"
        },
        "object_filter_type":{
            "$ref":"#/definitions/object_filter_type"
        },
        "partition_column_name":{
            "type":"string",
            "example":"FISCAL_YEAR",
            "description":"Column name to partition table on"
        },
        "format":{
            "$ref":"#/definitions/format"
        },
        "sql_statements":{
            "$ref":"#/definitions/sql_statements"
        },
        "merge_keys":{
            "type":"array",
            "items":{
                "type":"string",
                "description":"Column name to merge on"
            },
            "example":"[ 'RECORD_ID' ]"
        },
        "table_exists_action":{
            "type":"string",
            "example":"APPEND",
            "description":"Action to take when there is an existing table.",
            "enum":[
                "SKIP",
                "APPEND",
                "TRUNCATE",
                "MERGE",
                "REPLACE"
            ]
        },
        "target_type":{
            "type":"string",
            "example":"TABLE",
            "description":"Type of database object to create.",
            "enum":[
                "TABLE",
                "EXTERNAL_TABLE"
            ]
        }
    }
}

ネストされたスキーマ: columns

タイプ: array

ソースの表示

• 配列: オブジェクト column

{
    "type":"array",
    "items":{
        "$ref":"#/definitions/column"
    },
    "example":[
        {
            "column_name":"RECEIVED_DATE",
            "datatype":"DATE",
            "columnId":1,
            "format":"YYYY-MM-DD"
        },
        {
            "column_name":"UNITS",
            "datatype":"NUMBER",
            "columnId":2,
            "length":38
        }
    ]
}

例:

[
    {
        "column_name":"RECEIVED_DATE",
        "datatype":"DATE",
        "columnId":1,
        "format":"YYYY-MM-DD"
    },
    {
        "column_name":"UNITS",
        "datatype":"NUMBER",
        "columnId":2,
        "length":38
    }
]

ネストされたスキーマ: format

タイプ: object

DBMS_CLOUD.COPY_DATA書式設定オプション

例:

{
    "delimiter":",",
    "blankasnull":true,
    "characterset":"AL32UTF8"
}

ネストされたスキーマ: merge_keys

タイプ: array

ソースの表示

• 配列: 文字列
  マージする列名

{
    "type":"array",
    "items":{
        "type":"string",
        "description":"Column name to merge on"
    },
    "example":"[ 'RECORD_ID' ]"
}

例:

[ 'RECORD_ID' ]

ネストされたスキーマ: data_load_objects

タイプ: array

ソースの表示

• 配列: オブジェクト data_load_object

{
    "type":"array",
    "items":{
        "$ref":"#/definitions/data_load_object"
    },
    "example":[
        {
            "object_name":"sales1976.csv"
        },
        {
            "object_name":"sales2009.csv"
        },
        {
            "object_name":"sales2013.csv"
        }
    ]
}

例:

[
    {
        "object_name":"sales1976.csv"
    },
    {
        "object_name":"sales2009.csv"
    },
    {
        "object_name":"sales2013.csv"
    }
]

ネストされたスキーマ: sql_statements

タイプ: array

データベース操作を実行するSQL文

ソースの表示

• 配列: 文字列
  SQL文

{
    "type":"array",
    "items":{
        "description":"SQL statement",
        "type":"string"
    },
    "description":"SQL statements to perform database operation",
    "example":[
        "CREATE TABLE \"MYSCHEMA\".\"EXAMPLE_TABLE\"(\"ID\" NUMBER, \"DATE_RECV\" DATE);"
    ]
}

例:

[
    "CREATE TABLE \"MYSCHEMA\".\"EXAMPLE_TABLE\"(\"ID\" NUMBER, \"DATE_RECV\" DATE);"
]

ネストされたスキーマ: column

タイプ: object

ソースの表示

• column_name(optional): string
  表の列の名前

  例: UNITS
• columnId(optional): integer
  入力ファイルの列位置

  例: 2
• datatype(optional): string
  指定できる値: [ "VARCHAR2", "CLOB", "NUMBER", "INTEGER", "FLOAT", "BINARY_FLOAT", "BINARY_DOUBLE", "DATE", "TIMESTAMP", "TIMESTAMP WITH TIME ZONE", "TIMESTAMP WITH LOCAL TIME ZONE", "NVARCHAR2", "NCLOB" ]

  列のデータ型

  例: NUMBER
• format(optional): string
  特定の列タイプのデータ書式

  例: YYYY-MM-DD
• length(optional): integer
  列の長さまたは精度

  例: 40

{
    "type":"object",
    "properties":{
        "column_name":{
            "$ref":"#/definitions/column_name"
        },
        "columnId":{
            "type":"integer",
            "example":2,
            "description":"Column position in input file"
        },
        "datatype":{
            "type":"string",
            "example":"NUMBER",
            "description":"Data type of column",
            "enum":[
                "VARCHAR2",
                "CLOB",
                "NUMBER",
                "INTEGER",
                "FLOAT",
                "BINARY_FLOAT",
                "BINARY_DOUBLE",
                "DATE",
                "TIMESTAMP",
                "TIMESTAMP WITH TIME ZONE",
                "TIMESTAMP WITH LOCAL TIME ZONE",
                "NVARCHAR2",
                "NCLOB"
            ]
        },
        "length":{
            "type":"integer",
            "example":40,
            "description":"Length or precision of column"
        },
        "format":{
            "type":"string",
            "example":"YYYY-MM-DD",
            "description":"Data format for certain column types"
        }
    }
}

ネストされたスキーマ: data_load_object

タイプ: object

ソースの表示

• object_name(optional): string
  ロードするオブジェクトの名前

  例: sales.csv

{
    "type":"object",
    "properties":{
        "object_name":{
            "type":"string",
            "description":"Name of object to load",
            "example":"sales.csv"
        }
    }
}

先頭に戻る

レスポンス

サポートされるメディア・タイプ

• application/json

201レスポンス

データ・ロードのリスト

本文 ()

ルート・スキーマ: data-load-job-ids

タイプ: object

データ・ロード・ジョブIDのリスト

ソースの表示

• data_load_job_ids(optional): array data_load_job_ids

{
    "type":"object",
    "description":"List of data load job IDs",
    "properties":{
        "data_load_job_ids":{
            "type":"array",
            "items":{
                "$ref":"#/definitions/data-load-job-id"
            }
        }
    }
}

ネストされたスキーマ: data_load_job_ids

タイプ: array

ソースの表示

• 配列: オブジェクト data-load-job-id
  データ・ロード・ジョブのID

{
    "type":"array",
    "items":{
        "$ref":"#/definitions/data-load-job-id"
    }
}

ネストされたスキーマ: data-load-job-id

タイプ: object

データ・ロード・ジョブのID

ソースの表示

• data_load_job_id(optional): string
  データ・ロード・ジョブの名前

  例: SALES-LOAD-20220529-112233-4567

{
    "type":"object",
    "description":"ID of data load job",
    "properties":{
        "data_load_job_id":{
            "$ref":"#/definitions/data_load_job_id"
        }
    }
}

204レスポンス

コンテンツがありません

先頭に戻る