HTTPPUTBLOB和HTTPPUTCLOB

HTTPPUTBLOB和HTTPPUTCLOB REST函数通过 HTTP PUT请求在指定的 URL 下创建或更新二进制或基于文本的资源。 服务器的响应消息以BLOB形式返回,用于HTTPPUTBLOB,或以CLOB形式返回,用于HTTPPUTCLOB。 必要时,字符集将转换为数据库代码页。

提示: 更改开始示例 HTTP 用户定义函数旨在用于 Db2 SQL应用程序中,通过SQL语句访问远程非Db2 REST服务。 不要将它们与 Db2 原生REST服务混淆,后者支持使用基于REST的接口与来自网络、移动和云应用的 Db2 数据进行交互。更改结束
阅读语法图跳过可视化语法图HTTPPUTBLOBHTTPPUTCLOB( 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。 分开 headerAttributeheaderAttributeValue 单空格组合。
name
标题名称。
标题值。
<输入 >
指定要在指定的 URL 上创建或更新的数据。 对于HTTPPUTBLOB,此参数定义为BLOB( 5M );对于HTTPPUTCLOB,此参数定义为CLOB( 5M )。