Creates data load jobs
post
/ords/_/db-api/stable/data-tools/data-loads/
Request
Supported Media Types
- application/json
Data Loads to perform
Nested Schema : data-load
Type:
Show Source
object
-
columns(optional):
array columns
-
data_load_job_id(optional):
string
Name of data load jobExample:
SALES-LOAD-20220529-112233-4567
-
format(optional):
object format
DBMS_CLOUD.COPY_DATA formatting options
-
merge_keys(optional):
array merge_keys
-
object_filter(optional):
string
Filter to select subset of filesExample:
*.csv
-
object_filter_type(optional):
string
Allowed Values:
[ "GLOB", "REGEX" ]
Type of matching for object_filterExample:GLOB
-
objects(optional):
array data_load_objects
-
partition_column_name(optional):
string
Column name to partition table onExample:
FISCAL_YEAR
-
sql_statements(optional):
array sql_statements
SQL statements to perform database operation
-
storage_link_name(optional):
string
Name of Cloud Storage LinkExample:
MY-BUCKET
-
table_exists_action(optional):
string
Allowed Values:
[ "SKIP", "APPEND", "TRUNCATE", "MERGE", "REPLACE" ]
Action to take when there is an existing table.Example:APPEND
-
table_name(optional):
string
Table name to loadExample:
SALES
-
target_type(optional):
string
Allowed Values:
[ "TABLE", "EXTERNAL_TABLE" ]
Type of database object to create.Example:TABLE
Nested Schema : columns
Type:
Show Source
array
Example:
[
{
"column_name":"RECEIVED_DATE",
"datatype":"DATE",
"columnId":1,
"format":"YYYY-MM-DD"
},
{
"column_name":"UNITS",
"datatype":"NUMBER",
"columnId":2,
"length":38
}
]
Nested Schema : format
Type:
object
DBMS_CLOUD.COPY_DATA formatting options
Example:
{
"delimiter":",",
"blankasnull":true,
"characterset":"AL32UTF8"
}
Nested Schema : merge_keys
Type:
Show Source
array
-
Array of:
string
Column name to merge on
Example:
[ 'RECORD_ID' ]
Nested Schema : data_load_objects
Type:
Show Source
array
Example:
[
{
"object_name":"sales1976.csv"
},
{
"object_name":"sales2009.csv"
},
{
"object_name":"sales2013.csv"
}
]
Nested Schema : sql_statements
Type:
array
SQL statements to perform database operation
Show Source
-
Array of:
string
SQL statement
Example:
[
"CREATE TABLE \"MYSCHEMA\".\"EXAMPLE_TABLE\"(\"ID\" NUMBER, \"DATE_RECV\" DATE);"
]
Nested Schema : column
Type:
Show Source
object
-
column_name(optional):
string
Column name in tableExample:
UNITS
-
columnId(optional):
integer
Column position in input fileExample:
2
-
datatype(optional):
string
Allowed Values:
[ "VARCHAR2", "CLOB", "NUMBER", "INTEGER", "FLOAT", "BINARY_FLOAT", "BINARY_DOUBLE", "DATE", "TIMESTAMP", "TIMESTAMP WITH TIME ZONE", "TIMESTAMP WITH LOCAL TIME ZONE", "NVARCHAR2", "NCLOB" ]
Data type of columnExample:NUMBER
-
format(optional):
string
Data format for certain column typesExample:
YYYY-MM-DD
-
length(optional):
integer
Length or precision of columnExample:
40
Nested Schema : data_load_object
Type:
Show Source
object
-
object_name(optional):
string
Name of object to loadExample:
sales.csv
Response
Supported Media Types
- application/json
201 Response
List of Data Loads
Nested Schema : data_load_job_ids
Type:
Show Source
array
-
Array of:
object data-load-job-id
ID of data load job
Nested Schema : data-load-job-id
Type:
object
ID of data load job
Show Source
-
data_load_job_id(optional):
string
Name of data load jobExample:
SALES-LOAD-20220529-112233-4567
204 Response
No content