你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Library - Append

参考

Service:: Synapse

API Version:: 2020-12-01

将内容追加到使用创建操作创建的库资源。最大内容大小为 4MiB。大于 4MiB 的内容必须追加到 4MiB 区块中

PUT {endpoint}/libraries/{libraryName}?api-version=2020-12-01&comp=appendblock

URI 参数

名称	在	必需	类型	说明
endpoint	path	True	string uri	工作区开发终结点，例如 `https://myworkspace.dev.azuresynapse.net` 。
libraryName	path	True	string	要上传的文件名。文件名的最小长度应为 1（不包括扩展名长度）。
api-version	query	True	string	Synapse 客户端 API 版本。
comp	query	True	string

请求头

Media Types: "application/octet-stream"

名称	必需	类型	说明
x-ms-blob-condition-appendpos		integer int64	将此标头设置为应追加块的字节偏移量。仅当当前偏移量与此值匹配时，请求才会成功。否则，请求将失败并出现 AppendPositionConditionNotMet 错误 (HTTP 状态代码 412 – 先决条件失败)

请求正文

Media Types: "application/octet-stream"

名称	类型	说明
content	string	库文件区块。

响应

名称	类型	说明
201 Created		Created.
Other Status Codes	CloudError	从Azure Synapse服务收到的错误响应。

示例

Append Library

Sample Request

HTTP

PUT exampleWorkspace.dev.azuresynapse.net/libraries/exampleLibraryName.jar?api-version=2020-12-01&comp=appendblock


"file binary chunk"

Sample Response

Status code:: 201

Date: Fri, 23 Oct 2020 08:28:16 GMT
X-Content-Type-Options: nosniff
x-ms-ratelimit-remaining-subscription-writes: 1192
x-ms-request-id: e4c589b7-a9fe-4c28-981c-3855ec27d264
x-ms-correlation-request-id: e4c589b7-a9fe-4c28-981c-3855ec27d264

定义

CloudError

定义Azure Synapse错误响应结构的对象。

名称	类型	说明
error.code	string	错误代码。
error.details	CloudError[]	包含其他错误详细信息的数组。
error.message	string	错误消息。
error.target	string	与错误关联的请求中的属性名称/路径。

通过