GetUploadDocumentJob - 获取上传文档任务 - 云原生数据仓库AnalyticDB PostgreSQL版

通过JobId获取异步上传文档的任务的进度和结果。

接口说明

此接口为 UploadDocumentAsync 的相关接口。可通过 UploadDocumentAsync 创建一个上传任务，并得到一个 JobId，然后通过此接口查看 Job 的执行信息。

说明使用建议

按照文档复杂度和切分后的向量条数评估超时，一般不超过 2 小时。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

当前API暂无授权信息透出。

请求参数

名称	类型	必填	描述	示例值
DBInstanceId	string	是	开启了向量引擎优化的实例 ID。说明您可以调用 DescribeDBInstances 接口查看目标地域下所有的 AnalyticDB PostgreSQL 实例的详情，包括实例 ID。	gp-xxxxxxxxx
Namespace	string	否	命名空间，用于租户隔离，默认为 public。说明可以通过 CreateNamespace 创建，通过 ListNamespaces 接口查看列表。	mynamespace
Collection	string	是	文档库名称。说明由 CreateDocumentCollection 接口创建。您可以调用 ListDocumentCollections 接口查看已经创建的文档库。	document
RegionId	string	是	实例所在地域 ID。	cn-hangzhou
NamespacePassword	string	是	命名空间对应的密码。说明本值为 CreateNamespace 接口指定。	testpassword
JobId	string	是	上传文档的任务 ID，由`UploadDocumentAsync`接口获得。	bf8f7bc4-9276-44f7-9c22-1d06edc8dfd1

返回参数

名称	类型	描述	示例值
	object
RequestId	string	请求 ID。	ABB39CC3-4488-4857-905D-2E4A051D0521
Message	string	接口返回详细信息。	success
Status	string	此接口状态，取值说明： success：成功。 fail：失败。	success
Job	object	上传文档的任务的详细信息。
Id	string	Job ID。	231460f8-75dc-405e-a669-0c5204887e91
Completed	boolean	操作是否完成。	false
CreateTime	string	任务创建时间。	2024-01-08 16:52:04.864664
UpdateTime	string	任务更新时间。	2024-01-08 16:53:04.864664
Status	string	任务状态。取值说明： Success：成功。 Failed：失败，失败原因可查看 Error 字段。 Cancelling：正在取消中。 Cancelled：已取消。 Start：开始。 Running：执行中。 Pending：等待中。	Running
Error	string	当前操作异常或者失败时的错误信息。	Failed to connect database.
Progress	integer	上传进度，此数值为进度百分比，值为 100 时表示完成。	20
ChunkResult	object	切分结果。
ChunkFileUrl	string	切分后的文件链接，有效期为 2h。文件格式为 JSONL，每一行的格式为`{"page_content":"***", "metadata": {"":"*","":"***"}`	http://xxx/test.jsonl
PlainChunkFileUrl	string	切分后的不带 metadata 的文件链接，有效期为 2h。文件格式为纯文本，每一行为一条切分块。此文件可方便的用于 embedding。	http://xxx/test.txt
Usage	object	文档理解或 Embedding 消耗的 token 或条数。
EmbeddingTokens	integer	向量化时使用的 token 数。说明 token 是指将输入的文本分割成的最小单位；token 可以是一个单词、一个词组、一个标点符号、一个字符等。	475

示例

正常返回示例

JSON格式

{
  "RequestId": "ABB39CC3-4488-4857-905D-2E4A051D0521",
  "Message": "success",
  "Status": "success",
  "Job": {
    "Id": "231460f8-75dc-405e-a669-0c5204887e91",
    "Completed": false,
    "CreateTime": "2024-01-08 16:52:04.864664",
    "UpdateTime": "2024-01-08 16:53:04.864664",
    "Status": "Running",
    "Error": "Failed to connect database.",
    "Progress": 20
  },
  "ChunkResult": {
    "ChunkFileUrl": "http://xxx/test.jsonl",
    "PlainChunkFileUrl": "http://xxx/test.txt"
  },
  "Usage": {
    "EmbeddingTokens": 475,
    "EmbeddingEntries": 0
  }
}

错误码

访问错误中心查看更多错误码。

变更历史

变更时间

变更内容概要

操作

2024-01-18

OpenAPI 返回结构发生变更

看变更集

变更项	变更内容
出参	OpenAPI 返回结构发生变更。