批量操作_用户指南_视频内容检索

本文档介绍如何批量新增、删除和查询视频。

视频内容检索有两种批量操作方式：OSS批量操作和数据文件批量操作。OSS批量操作需结合阿里云OSS服务使用，将存储在OSS中的视频批量导入到视频内容检索实例中，同时也可以批量删除已经入库的视频和批量检索视频。如果视频并没有存放在阿里云OSS中，只有视频URL，则可以使用数据文件批量操作功能，同样实现视频批量导入、删除和查询。

OSS批量操作流程

标号	功能介绍
1	新建批量任务
2	批量任务查询：支持按照bucket和数据路径查询。
3	批量任务列表：- 导入方式：支持OSS导入和数据文件导入。- 区域：目前仅支持华北2（北京）。- bucket名称：OSS中bucket名称。- 数据路径：OSS中bucket下的数据路径。- 任务状态：包含排队中、处理中、已完成、失败、部分失败，5种状态。- 上次修改时间：记录任务状态变化的时间节点。- 提示信息：任务状态执行后的日志信息。

开通OSS服务。
将视频导入到OSS中。
新建meta文件。
授予视频内容检索服务访问OSS的权限。
在视频内容检索中创建批量任务。

1、开通OSS服务

如果您尚未开通OSS服务，请参见开通OSS服务进行开通。开通服务后，您还需要创建存储空间Bucket，具体请参见创建存储空间。

说明

开通的OSS为独立计费，具体计费方式请参见计费概述。
请确保开通的OSS服务与已购买的视频内容检索服务在同一地域，否则将无法使用批量操作功能。

2、将视频导入到OSS中

导入视频具体操作请参见上传文件。

说明视频存放路径可以自定义，只需要在创建批量任务时设置视频路径即可。

3、新建meta文件

在OSS服务中存放视频的路径下，新建meta文件，该文件用来存储批量任务相关内容。本文示例文件名称为:videosearch.meta

说明 meta文件中涉及的视频必须和meta文件在同一路径下，否则批量操作会失败。

文件参考实例如下：

{"OperationType":"ADD","VideoId":"000bdfbf1cb24215a8fea8b40a493726","VideoName":"电影123.mp4","VideoDesc":"影视剧-体育-新闻", "VideoTags": "movie","CallbackUrl": "www.aliyun.com"}
{"OperationType":"DELETE","VideoId":"000bdfbf1cb24215a8fea8b40a493726","CallbackUrl": "www.aliyun.com"}
{"OperationType":"SEARCH","VideoName":"短视频123.mp4","VideoDesc":"短视频相似推荐123","CallbackUrl":"www.aliyun.com"}
{"OperationType":"SEARCH","VideoName":"短视频456.mp4","VideoDesc":"短视频查询并入库","VideoId":"10065","StorageType":1,"SearchType":1,"CallbackUrl": "www.aliyun.com"}
{"OperationType":"SEARCH","VideoName":"短视频789.mp4","VideoDesc":"短视频查询并去重入库","VideoId":"10065","VideoTags":"shortVideo","QueryTags":"movie","StorageType":2,"ReplaceStorageThreshold":"0.75","SearchType":1,"ReturnVideoNumber":15,"CallbackUrl": "www.aliyun.com"}
{"OperationType":"SEARCH","VideoName":"人物1.jpg","VideoDesc":"图搜视频-人物1","SearchType":2,"ReturnVideoNumber":15,"CallbackUrl":"www.aliyun.com"}

每个操作由JSON格式表示，具体字段含义如下表所示：

参数	类型	是否必选	说明
OperationType	String	是	操作类型。 - ADD：新增视频。- SEARCH：查询视频。- DELETE：删除视频。
SearchType	Integer	否	检索类型。- 1：视频搜视频（默认）。- 2：图片搜视频。
VideoName	String	是	视频或图片文件的名称。OSS的Bucket中的视频或图片文件的名称。OSS批量操作时有效。说明- 当OperationType=ADD, SEARCH时，必填。- 当OperationType=DELETE时，不需要填写。
VideoUrl	String	是	视频或者图片的URL，数据文件批量操作时有效。说明- 当OperationType=ADD, SEARCH时，必填。- 当OperationType=DELETE时，不需要填写。
VideoDesc	String	否	视频或图片描述。
VideoTags	String	否	视频标签：表示与视频相关的标签信息，会和视频数据一起进行索引，可以与视频一起被搜索，并可用于查询时的条件过滤
VideoId	String	是	即业务key，表示视频的唯一id。说明- 当OperationType=ADD时，必填。- 当OperationType=SEARCH并且SearchStorageType=1或2时，必填。- 当OperationType=DELETE时，必填。
QueryTags	String	否	查询条件，与视频标签对应，多个查询条件使用竖线（,）分割。说明- 仅当OperationType=SEARCH时有效。
StorageType	Integer	否	检索入库类型，仅当SearchType=1时有效。- 1：直接入库。- 2：去重入库。- 3：不入库（默认）。
ReplaceStorageThreshold	float	否	去重入库阈值。- 当StorageType=2（去重入库）时生效，当检索结果中所有视频的置信度都小于该值时，进行数据入库。- 默认：0.9
ReturnVideoNumber	Integer	否	检索结果中返回的最大相似视频数量。说明- 默认：20
CallbackUrl	String	否	任务结束时的回调url，仅支持http请求

4、授予视频内容检索服务访问OSS的权限

视频内容检索服务通过OSS来实现数据批量操作，需要您通过STS（Security Token Service）为视频内容检索服务账号授权。

创建RAM角色。
1. 登录RAM控制台。
2. 单击RAM角色管理 > 创建RAM角色。
3. 角色类型选择阿里云服务。
4. 配置角色信息。
  - 角色类型：选择为普通服务角色。
  - 角色名称：自定义设置。本文示例设置为videosearch-test。
  - 选择受信服务：选择为视频内容检索。
创建权限策略。
1. 单击**权限管理 > 权限策略管理**。
2. 单击创建权限策略。
3. 编辑权限策略内容。
  - 设置策略名称。
  - 选择配置模式为脚本配置。策略内容如下：
```
{
  "Version": "1",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "oss:GetObject"
      ],
      "Resource": [
        "acs:oss:*:*:${bucket}/${path}/*"
      ]
    }
  ]
}
```
  - ${bucket}：表示您在OSS上创建的Bucket。例如videosearch-batchoperation。
  - ${path}：表示您的增量文件存储的路径。例如/increment。
进行授权。
1. 在RAM控制台单击RAM角色管理。
2. 单击创建的RAM角色。
3. 单击添加权限。
4. 单击自定义策略并选择已创建的权限策略。
5. 在详情页可以看到已经添加的自定义权限策略。

5、在视频内容检索中创建批量任务。

登录视频内容检索控制台。
选择目标服务类型和目标实例。
单击批量操作页签。
单击新建批量任务。
设置批量任务参数。
- 资源名称（Arn）
- 查看方式如下所示。
- Bucket名称OSS上创建的相应的Bucket名称。
  说明请确保开通的OSS服务与已购买的视频内容检索服务在同一个地域。
- 数据路径需要上传的视频和increment.meta文件的存储路径。
  说明路径以/开头，例如/videosearch。

数据文件批量操作流程

新建meta文件。
在视频内容检索中创建批量任务。

说明当视频并没有存放在oss中，只有视频URL时，推荐使用数据文件批量操作方式。

1、新建meta文件

该文件用来存储批量任务相关内容。本文示例文件名称为:videosearch.meta

{"OperationType":"ADD","VideoId":"000bdfbf1cb24215a8fea8b40a493726","VideoUrl":"www.aliyun.com/电影123.mp4","VideoDesc":"影视剧-体育-新闻", "VideoTags": "movie","CallbackUrl": "www.aliyun.com"}
{"OperationType":"DELETE","VideoId":"000bdfbf1cb24215a8fea8b40a493726","CallbackUrl": "www.aliyun.com"}
{"OperationType":"SEARCH","VideoUrl":"www.aliyun.com/短视频123.mp4","VideoDesc":"短视频相似推荐123","CallbackUrl":"www.aliyun.com"}
{"OperationType":"SEARCH","VideoUrl":"www.aliyun.com/短视频456.mp4","VideoDesc":"短视频查询并入库","VideoId":"10065","StorageType":1,"SearchType":1,"CallbackUrl": "www.aliyun.com"}
{"OperationType":"SEARCH","VideoUrl":"www.aliyun.com/短视频789.mp4","VideoDesc":"短视频查询并去重入库","VideoId":"10065","VideoTags":"shortVideo","QueryTags":"movie","StorageType":2,"ReplaceStorageThreshold":"0.75","SearchType":1,"ReturnVideoNumber":15,"CallbackUrl": "www.aliyun.com"}
{"OperationType":"SEARCH","VideoUrl":"www.aliyun.com/人物1.jpg","VideoDesc":"图搜视频-人物1","SearchType":2,"ReturnVideoNumber":15,"CallbackUrl":"www.aliyun.com"}

2、在视频内容检索中创建批量任务

登录视频内容检索控制台。
选择目标服务类型和目标实例。
单击批量操作页签。
单击新建批量任务，选择数据文件导入。

后续步骤

在实例详情页，查看所有增量任务的信息。增量任务状态为成功后，用户可以查看相应的提示信息：

如果提示信息为“部分视频处理失败，已为您分离，点击下载”，则表明该增量任务中有部分任务处理失败，用户可以下载相应文件查看处理失败的原因。
如果提示信息为成功，则表明该任务中所有的视频均已处理成功。