HTTPPOSTBLOB および HTTPPOSTCLOB

HTTPPOSTBLOB 関数および HTTPPOSTCLOB REST 関数は、HTTP POST 要求を介して指定の URL のバイナリーまたはテキスト・ベースのリソースを更新します。 サーバーからの応答メッセージは、HTTPPOSTBLOB の場合には BLOB として、HTTPPOSTCLOB の場合には CLOB として戻されます。 文字セットは、必要な場合にはデータベース・コード・ページに変換されます。

ヒント： 変更の開始サンプルの HTTP ユーザー定義関数は、 Db2 SQLアプリケーション内で使用し、SQLステートメントを通じて、リモートにある非Db2 RESTベースのサービスにアクセスすることを目的としています。 Db2 のネイティブRESTサービスと混同しないでください。このサービスは、ウェブ、モバイル、クラウドアプリケーションから Db2 のデータとやりとりする際に、RESTベースのインターフェースを使用することをサポートしています。変更の終わり
構文図を読むビジュアルシンタックスダイアグラムをスキップするHTTPPOSTBLOBHTTPPOSTCLOB( url,httpHeader, <input>)

スキーマは DB2XML です。

url
データを更新する場所の URL を指定します。 この引数は VARCHAR(2048) 値として定義されます。
httpHeader
オプションのヘッダー XML 文書を指定します。 この引数は、CLOB(10K) 値として定義されます。

XML ヘッダー文書は、以下の形式で追加の HTTP ヘッダー値を指定できます。

<httpHeader headerAttribute="headerAttributeValue">
        <header name="name" value="value" />
</httpHeader>
headerAttribute
以下のオプション属性のいずれかを指定します。
変更の開始connectTimeout変更の終わり
ミリ秒単位で接続タイムアウトしきい値の整数値を指定します。
readTimeout
ミリ秒単位で読み取りタイムアウトしきい値の整数値を指定します。
followRedirects
リダイレクトが続くかどうかを指定します。 これはブール値です。
useCaches
キャッシュを使用するかどうかを指定します。 これはブール値です。
変更の開始responseMsgFormat変更の終わり
変更の開始サーバーがユーザー定義関数にエラー・メッセージを返すときに、ユーザー定義関数が呼び出し元に以下の値を戻すことを示す、ヘッダー属性値の errorTagged を指定します。
  • SQLCODE 0
  • サーバーからのエラー・メッセージの形式は、以下のとおりです。
    <error httprc="{HTTP-status-code}">
  {error-message-returned-from-server}
</error>
変更の終わり
headerAttributeValue
headerAttribute の値を指定します。 シングル・スペースで headerAttribute と headerAttributeValue の組み合わせを区切ります。
名前
ヘッダー名。
value
ヘッダー値。
<入力>
指定された URL で更新するデータを指定します。 この引数は、HTTPPOSTBLOB の場合は BLOB(5M) として、HTTPPOSTCLOB の場合は CLOB(5M) として定義されます。