コピー アクティビティで REST を構成する

この記事では、パイプラインでコピー アクティビティを使用して、REST エンドポイントとの間でデータをコピーする方法について説明します。

具体的には、この汎用 REST コネクタは次をサポートします。

• GET メソッドまたは POST メソッドを使用して REST エンドポイントからデータをコピーし、POST、PUT、または PATCH メソッドを使用して REST エンドポイントにデータをコピーする。
• REST API でのページネーション。
• REST をソースとして使用する場合は、REST JSON 応答 as-is コピーするか、スキーマ マッピングを使用して解析します。 JSON の応答ペイロードのみがサポートされています。

サポートされている構成

コピー アクティビティの下の各タブの構成については、それぞれ次のセクションを参照してください。

• 全般
• ソース
• 行き先
• マッピング
• [設定]

全般

[ 全般 ] タブの構成については、[ 全般] に移動します。

情報源

コピー アクティビティの [ ソース ] タブの REST では、次のプロパティがサポートされています。

次の最初の 3 つのプロパティが 必要です。

• 接続: 接続リストから REST 接続を選択します。 接続が存在しない場合は、[ 新規] を選択して新しい REST 接続を作成します。
• 接続の種類: REST を選択します。
• 相対 URL: データを含むリソースへの相対 URL。 このプロパティを指定しない場合は、接続定義で指定されている URL のみが使用されます。 HTTP コネクタは、結合された URL ( [URL specified in connection]/[relative URL specified]) からデータをコピーします。

[詳細設定] では、次のフィールドを指定できます。

• 要求メソッド: HTTP メソッド。 使用できる値は 、GET (既定値) と POST です。

  

• 要求タイムアウト: HTTP 要求が応答を取得するためのタイムアウト (期間の値)。 この値は応答を取得するためのタイムアウトであり、応答データを読み取るためのタイムアウトではありません。 既定値は 00:01:40 です。

• 要求間隔 (ミリ秒): 複数のページに対する異なる要求間の間隔 (ミリ秒)。 要求間隔の値は、[10, 60000] の間の数値にする必要があります。

• 追加のヘッダー: 追加の HTTP 要求ヘッダー。

  

• 改ページ規則: 次のページ要求を作成するための改ページ規則。 詳細については、ページネーション サポート セクションを参照してください。

  

• その他の列: ソース ファイルの相対パスまたは静的な値を格納するデータ列を追加します。 静的な値を使用している場合は、 カスタム式を 使用して生成できます。

  

行き先

コピー アクティビティの [ 宛先 ] タブの REST では、次のプロパティがサポートされています。

次の最初の 3 つのプロパティが 必要です。

• 接続: 接続の一覧から REST 接続を選択します。 接続が存在しない場合は、[ 新規] を選択して新しい REST 接続を作成します。
• 接続の種類: REST を選択します。
• 相対 URL: データを含むリソースへの相対 URL。 このプロパティを指定しない場合は、接続定義で指定されている URL のみが使用されます。 HTTP コネクタは、結合された URL ( [URL specified in connection]/[relative URL specified]) からデータをコピーします。

[詳細設定] では、次のフィールドを指定できます。

• 要求メソッド: HTTP メソッド。 使用できる値は POST (既定値)、 PUT、 PATCH です。

• 要求タイムアウト: HTTP 要求が応答を取得するためのタイムアウト (期間の値)。 この値は、データを書き込むタイムアウトではなく、応答を取得するためのタイムアウトです。 既定値は 00:01:40 です。

• 要求間隔 (ミリ秒): 複数のページに対する異なる要求間の間隔 (ミリ秒)。 要求間隔の値は、[10, 60000] の間の数値にする必要があります。

• 書き込みバッチ サイズ: バッチごとに REST 宛先に書き込むレコードの数。 既定値は 10000 です。

• Http 圧縮の種類: 最適な圧縮レベルでデータを送信するときに使用する HTTP 圧縮の種類。 使用できる値は None と GZip です。

• 追加のヘッダー: 追加の HTTP 要求ヘッダー。

  

地図作成

[ マッピング ] タブの構成については、[ マッピング] タブの [マッピングの構成] に移動します。ソースと宛先の両方が階層データである場合、マッピングはサポートされません。

設定

[設定] タブの構成については、[設定] タブの [その他の設定の構成] に移動します。

表の概要

次の表に、REST でのコピー アクティビティの詳細を示します。

ソース情報

宛先情報

関連コンテンツ

• REST 接続を作成する方法