オブジェクトのインポート このリソースとエクスポートリソースを一緒に使用して、オブジェクトを1つの組織から別の組織へと移行します。
オブジェクトのインポートには、一連の要求および応答が含まれます。オブジェクトをインポートするには、次のタスクを実行します。
1 2 Informatica Intelligent Cloud Services により、インポートジョブのジョブIDが返されます。
3 Informatica Intelligent Cloud Services では、「実行中」や「成功」などのインポートステータスを返すか、エラーメッセージを返します。また、応答にはエクスポートパッケージを作成した組織のソース組織IDも含まれます。
4 Informatica Intelligent Cloud Services では、インポートジョブのステータスと、要求に応じてパッケージ内の各オブジェクトのステータスを返します。
インポートパッケージのアップロード POST要求を使用してインポートパッケージをアップロードします。
POST要求 インポートパッケージをアップロードするには、次のURIを使用します。
/public/core/v3/import/package
Content-Typeの場合、次を使用します。
multipart/form-data
要求本文には、package の名前の部分を含めます。そのコンテンツでは、インポートするエクスポートZIPファイルを使用します。
Informatica Intelligent Cloud Services では、エクスポートZIPファイルの内容が作成後に変更されていないことを確認するためのチェックサム検証がデフォルトで使用されます。変更されたエクスポートZIPファイルを含むインポートパッケージをアップロードする場合は、relaxChecksumパラメータを含めて値をTrueに設定します。
次の図に、Postmanの要求本文の例を示します。
POST応答 成功した場合、インポートジョブの次の情報が返されます。
フィールド
タイプ
説明
jobId
String
インポートジョブのID。
jobStatus
Collection
パッケージのアップロードステータス。
state
String
ステータスのオブジェクトで返されます。
「実行中」、「成功」、「失敗」などインポートジョブのステータス。
message
String
ステータスのオブジェクトで返されます。
インポートジョブのステータスメッセージ。
checksumValid
Boolean
インポートパッケージのチェックサムが有効かどうかを示します。
POST応答の例 次の例のような応答を受信します。
{
インポートジョブの開始 POST要求を使用して、インポートジョブを指定して開始します。アセット、接続、Secure Agentの設定、スケジュールなどのオブジェクトをインポートできます。
POST要求 要求には、インポートするオブジェクトのリストと、発生する可能性のある競合を解決するためのパラメータを含めます。競合の解決の例としては、ターゲット組織にある別のアセットと同じ名前を持つアセットをインポートしようとする場合が挙げられます。
コネクタのタイプとバージョンが同じであれば、ターゲット組織に存在するランタイム環境をソースランタイム環境の代わりに使用するように指定できます。ターゲット組織のランタイム環境のリストを検索するには、ルックアップリソースを使用します。
データ統合 の共有シーケンス、または入出力パラメータまたはシーケンスを含むマッピングタスクをインポートする場合は、パーシステント値を保持、リセット、または上書きすることができます。
インポートオブジェクトを指定し、インポートジョブを開始するには、次のURIを使用します。
/public/core/v3/import/<id>
<id>は、インポートパッケージのアップロードのPOST応答で受信されるインポートジョブIDです。
要求に含めるオブジェクトIDを取得するには、ルックアップリソースを使用します。詳細については、
ルックアップ を参照してください。
要求に次のフィールドを含めます。
フィールド
タイプ
必須
説明
name
String
○
インポートジョブの名前。
デフォルトの名前はjob-<currentTimeInMilliseconds>です。
importSpecification
複合型
-
インポート仕様を指定するために使用します。指定しない場合、インポートパッケージ内のすべてのオブジェクトがインポートに含まれ、デフォルトの競合解決設定が使用されます。
defaultConflictResolution
String
-
importSpecificationオブジェクトに含まれます。
既存のオブジェクトをインポートファイル内のすべてのオブジェクトで上書きするかどうかを示します。以下のオプションが含まれます。
includeObjects
Collection<String>
-
importSpecificationオブジェクトに含まれます。
インポートに含めるオブジェクト。lookupリソースを使用して、オブジェクトIDを検索できます。
指定しない場合、インポートパッケージ内のすべてのオブジェクトがインポートに含まれます。
指定したオブジェクトがプロジェクトの場合、そのプロジェクトに属するすべてのアセットと、ターゲット組織にまだ存在しないすべての依存オブジェクトがインポートに含まれます。
指定されたオブジェクトがアセットの場合、アセットのコンテナ（プロジェクト、フォルダ）が存在しないときはインポートによってこれらが作成されます。
注: 1つのインポートジョブに含めるオブジェクトは1000個以内にすることをお勧めします。
objectSpecification
Collection<複合型>
-
importSpecificationオブジェクトに含まれます。
オブジェクトのプロパティを指定します。プロパティが特定のオブジェクトに対して指定されていない場合、インポートではデフォルトの競合の解決設定を使用します。
conflictResolution
String
-
objectSpecificationオブジェクトに含まれます。
既存のアセットをインポートファイルのアセットで上書きするかどうかを示します。以下のオプションが含まれます。
- - データ統合マッピングタスク、アプリケーション統合ガイド、B2B Gatewayサプライヤ、Data Quality ディクショナリなどのアセットに適用できます。プロジェクト、フォルダ、ランタイム環境、または接続には使用しないでください。
注: ターゲット組織に存在しない場合、インポートには、アセットに関連付けられた接続およびランタイム環境が含まれます。
sourceObjectId
String
○
objectSpecificationオブジェクトに含まれます。
エクスポートパッケージファイルのオブジェクトID。
objectSpecificationが存在する場合は必須です。
targetObjectId
String
-
objectSpecificationオブジェクトに含まれます。
コンテナ間マッピング、および一部のアセット間マッピングに使用されます。
ターゲット組織内に存在する接続またはランタイム環境を指定するために使用します。ターゲットオブジェクトで使用するコネクタのタイプとバージョンは、ソースオブジェクトで使用されているものと同じである必要があります。
mergeTags
ブール
-
objectSpecificationオブジェクトに含めます。
受信アセットタグをターゲットプロジェクトのアセットタグとマージするかどうかを指定します。
デフォルトはFalseです。
additionalProviderFlags
Collection<複合型>
-
追加のオブジェクト指定。
データ統合 の共有シーケンス、または入出力パラメータやシーケンスを含むマッピングタスクをインポートするときに、キーと値のペアを使用して、永続化された値を保持、リセット、または上書きします。
新しいアセットの場合は、キー「mapping_conflict_new」と次のいずれかの値を使用します。
- - 既存のアセットの場合は、キー「mapping_conflict_existing」と次のいずれかの値を使用します。
- - -
POST要求の例 次の例のような要求を使用できます。
POST <baseApiUrl>/public/core/v3/import/2oZb7vFI2QQg4ncd4AyCGn
POST応答 成功した場合、インポートジョブの次の情報が返されます。
フィールド
タイプ
説明
jobId
String
インポートジョブのID。
createTime
String
インポートジョブが作成された時刻。
updateTime
String
インポートジョブの最終更新時刻。
name
String
インポートジョブの名前。
startTime
String
インポートジョブの開始時刻。
endTime
String
インポートジョブの終了時刻。
status
Collection
パッケージのアップロードステータス。
state
String
ステータスのオブジェクトで返されます。
「実行中」、「成功」、「失敗」など個々のオブジェクトのインポート状態。
message
String
ステータスのオブジェクトで返されます。
インポートジョブのステータスメッセージ。
objects
Collection
インポートジョブに含まれるオブジェクト。
sourceOrgId
String
インポートされたエクスポートパッケージを作成した組織の組織ID。
POST応答の例 成功した場合、次の例のような応答を受信します。
{
エラーを受信した場合、次の例のような応答が表示されます。
{
インポートジョブのステータスの取得 GET要求を使用して、インポートジョブのステータスを取得するか、インポートジョブのログをダウンロードします。
GET要求 インポートジョブのステータスを取得するには、次のいずれかのURIを使用します。<id>はインポートジョブのIDです。
• /public/core/v3/import/<id>
• /public/core/v3/import/<id>?expand=objects
インポートジョブのログをダウンロードするには、次のURIを使用します。
/public/core/v3/import/<id>/log
GET応答 インポートジョブのログを要求すると、ログがテキストファイルで返されます。
ステータスを要求すると、次のようなインポートステータス情報が返されます。
フィールド
タイプ
説明
id
String
インポートジョブのID。
createTime
String
インポートジョブが作成された時刻。
updateTime
String
インポートジョブの最終更新時刻。
name
String
インポートジョブの名前。
startTime
String
インポートジョブの開始時刻。
endTime
String
インポートジョブの終了時刻。
status
複合型
パッケージのアップロードステータス。
state
String
ステータスのオブジェクトで返されます。
「実行中」、「成功」、「失敗」などインポートジョブのステータス。
message
String
ステータスのオブジェクトで返されます。
インポートジョブのステータスメッセージ。
sourceOrgId
String
インポートされたエクスポートパッケージを作成した組織のID。
objects
コレクション
インポートに含まれるオブジェクト。
sourceObject
コレクション
objectsオブジェクトで返されます。
インポートに含まれるオブジェクト。
id
String
sourceObjectオブジェクトで返されます。
インポートに含まれるオブジェクトのグローバル一意識別子。
name
String
sourceObjectオブジェクトで返されます。
インポートに含まれるオブジェクトの名前。
path
String
sourceObjectオブジェクトで返されます。
インポートに含まれるオブジェクトの完全なパス。
type
String
sourceObjectオブジェクトで返されます。
インポートに含まれるオブジェクトのタイプ。
description
String
sourceObjectオブジェクトで返されます。
インポートに含まれるオブジェクトの説明。
targetObject
Collection
objectsオブジェクトで返されます。
ターゲットオブジェクト。
id
String
targetObjectオブジェクトで返されます。
ターゲットオブジェクトのグローバル一意識別子。
name
String
targetObjectオブジェクトで返されます。
ターゲットオブジェクトの名前。
path
String
targetObjectオブジェクトで返されます。
ターゲットオブジェクトの完全なパス。
type
String
targetObjectオブジェクトで返されます。
ターゲットオブジェクトのタイプ
description
String
targetObjectオブジェクトで返されます。
ターゲットオブジェクトの説明。
status
String
targetObjectオブジェクトで返されます。
ターゲットオブジェクトのステータス。
status
複合型
objectsオブジェクトで返されます。
個々のオブジェクトのインポートステータス。
state
String
ステータスのオブジェクトで返されます。
「実行中」、「成功」、「失敗」など個々のオブジェクトのインポート状態。
message
String
ステータスのオブジェクトで返されます。
個々のオブジェクトのインポートステータスメッセージ。
GET応答の例 インポートジョブのステータスに対する要求が成功すると、次の例のような応答を受け取ります。
{
要求に個々のオブジェクトのインポートステータスが含まれていた場合、成功時の応答は次の例のようになります。
{
インポートジョブのログを要求した場合、返されるテキストファイルの内容は次の例のようになります。
> OIE_002 INFO 2019-02-07T01:02:24.986Z Starting import operation.
