エクスポート・データ・ポンプ・ジョブの作成
POST
/database/datapump/export
指定されたパラメータを使用してデータ・ポンプのエクスポート・ジョブを作成し、開始します。パラメータの詳細な説明は、Oracle Data Pumpのドキュメントを参照してください。クライアントは、このサービスを起動するにはSQL管理者ロールが必要です。
リクエスト
この操作のリクエスト・パラメータはありません。
先頭に戻るレスポンス
201レスポンス
作成されたデータ・ポンプのエクスポート・ジョブの説明。
例
次の例は、cURLを使用してRESTリソースに対するPOSTリクエストを発行することによって、Data Pumpエクスポート・ジョブを作成する方法を示しています。
curl -i -X POST -u username:password
-d @request_body.json
-H "Content-Type:application/json" https://rest_server_url/ords/orcl/pdbadmin/_/db-api/stable/database/datapump/export
リクエスト本文の例
ノート:
前述のコマンドで使用されるURL構造
https://rest_server_url/resource-path
には、次の要素があります。
rest_server_url
はOracle Rest Data Serverが実行されているRESTサーバーです- URLの残りの部分には、ORDSコンテキスト・ルート、データベース識別子、スキーマ識別子、使用するORDSデータベースAPIのバージョンおよびこの操作のパスが含まれます。
次に、EMPで始まるがEMPという名前ではない表をSCOTTスキーマからエクスポートするData Pumpリクエストを送信するためのリクエスト本文の例を示します。
{
"job_mode": "TABLE",
"name_expressions": [
{"expression": "!='EMP'"},
{"expression": "LIKE 'EMP%'"}
],
"schema_expressions": [
{"expression": "IN ('SCOTT')"}
]
}
レスポンス・ヘッダーの例
次の例に、レスポンス・ヘッダーを示します。Location
ヘッダーは、ジョブのステータスの表示に使用できるURIを返します。
HTTP/1.1 201 Created
Content-Type:"application/json"
Content-Location:"https://rest_server_url/ords/orcl/pdbadmin/_/db-api/stable/database/datapump/jobs/PDBADMIN,DATAPUMP_REST_EXPORT_20190706144505/"
ETag:""nXEnxxIZe/tJIO5rgD+qkCggJtIVIMvKJG6T2dqhJ8Wy2Cr5u+anrmgez/2+3BWR3FKx0TlVjR2RRfITHZnFxQ==""
Location:"https://rest_server_url/ords/orcl/pdbadmin/_/db-api/stable/database/datapump/jobs/PDBADMIN,DATAPUMP_REST_EXPORT_20190907144505/"
Transfer-Encoding:"chunked"
レスポンス本文の例
次の例は、JSON形式で返される201のレスポンス本文を示しています。
{
"job_name": "DATAPUMP_REST_EXPORT_20190706144505",
"owner_name": "PDBADMIN",
"operation": "EXPORT",
"job_mode": "TABLE",
"state": "EXECUTING",
"degree": 1,
"attached_sessions": 0,
"datapump_sessions": 2,
"job_state": "EXECUTING",
"links": [
{
"rel": "collection",
"href": "https://rest_server_url/ords/orcl/pdbadmin/_/db-api/stable/database/datapump/jobs/"
},
{
"rel": "describedby",
"href": "https://rest_server_url/ords/orcl/pdbadmin/_/db-api/stable/metadata-catalog/"
},
{
"rel": "related",
"href": "https://rest_server_url/ords/orcl/pdbadmin/_/db-api/stable/database/datapump/jobs/PDBADMIN,DATAPUMP_REST_EXPORT_20190706144505/EXPDAT-2019-07-06-14_45_05.LOG"
},
{
"rel": "self",
"href": "https://rest_server_url/ords/orcl/pdbadmin/_/db-api/stable/database/datapump/jobs/PDBADMIN,DATAPUMP_REST_EXPORT_20190706144505/"
}
]
}