开始更改

HTTP_PATCH_VERBOSE 和 HTTP_PATCH_BLOB_VERBOSE

HTTP_PATCH_VERBOSE开始更改 或 HTTP_PATCH_BLOB_VERBOSE结束更改 表函数通过 HTTP PATCH 请求更新指定 URL 下的文本资源。 它返回一个单行表,其中包含 HTTP 对请求的正常响应和从 HTTP 请求返回的头信息。

读取语法图跳过可视语法图HTTP_PATCH_VERBOSEHTTP_PATCH_BLOB_VERBOSE(url ,请求消息,选项)
URL
返回内置字符串或图形字符串数据类型的表达式,用于指定所访问资源的 URL。
URL 中唯一支持的协议是 http://https://. HTTP URL 中不能指定 @ 形式的基本身份验证。 https://userid:password 相反,必须使用 basicAuth 选项来指定基本身份验证的用户名和密码。
请求-消息
表达式,用于指定在指定 URL 处更新的数据。
对于 HTTP_PATCH_VERBOSE ,它必须是内置字符串或图形字符串数据类型。
开始更改对于 HTTP_PATCH_BLOB_VERBOSE ,它必须是内置二进制字符串数据类型。结束更改
选项
返回内置字符串或图形字符串数据类型的表达式。 此字符串必须格式化为包含请求的选项 (包括头) 的 JSON 对象。 有关选项列表,请参见 HTTP 选项
如果未提供任何选项,那么将使用缺省选项。

此函数的结果是包含具有下表中所示格式的单行的表。

表 1. HTTP_PATCH_VERBOSE 和 HTTP_PATCH_BLOB_VERBOSE 结果表
列名 数据类型 描述
响应信息
CLOB (2G) CCSID 1208 (对于
HTTP_PATCH_VERBOSE开始更改
) 或
BLOB (2G) (对于
HTTP_PATCH_BLOB_VERBOSE结束更改
)
HTTP 对请求的回复。
response_http_header CLOB (2G) CCSID 1208 HTTP 请求返回的头信息,格式由 verboseResponseHeaderFormat 选项指定。

注意

有关使用 HTTP 功能的更多信息,请参阅 HTTP 功能概述

示例

  • 向 https://www.example.com/users 发送 HTTP PATCH 请求,发送 "ABC "并使用证书存储 /home/javaTrustStore/fromJava.KDB。 返回结果和头信息。
    SELECT * FROM TABLE(QSYS2.HTTP_PATCH_VERBOSE(
                       'https://www.example.com/users',
                       'ABC',
                       '{"sslCertificateStoreFile":"/home/javaTrustStore/fromJava.KDB"}'));
结束更改