本文介紹如何將映像上傳到Image Search服務。
背景信息
Image Search提供兩種方式上傳圖片,一種是通過Image Search產品API或者SDK,另一種方式是通過OSSImport工具。
OSSImport介紹
OSSImport是阿里雲OSS提供的一款將資料移轉至OSS儲存空間(Bucket)的工具。您可以將OSSImport部署在本機伺服器或雲上ECS執行個體內,輕鬆將您本地或其它雲端儲存的資料移轉到OSS。
使用OSSImport上傳圖片具有以下優勢:
- 保持圖片快速更新到Image Search引擎。
- 同一個OSS儲存空間可供不同環境使用,像開發專案,線上專案等。
- 根據業務需要,更好地組織和管理多種圖片的來源。
- 更好地管理複雜環境的專案,例如開發專案,UAT專案等。
- 最佳化使用網路頻寬:一次上傳,多次使用。
- 使用這個工具,您可以將Image Search管理產業化。
圖片限制
- 單張圖片大小不超過4 MB。
- 圖片的長和寬解析度要求大於100小於等於4096。
操作流程
步驟一:下載OSSImport工具
OSSImport有單機模式和分布式模式兩種部署方式。
- 單機模式:當您需要遷移的資料小於30TB時,推薦部署單機模式。您可以將OSSImport部署在任意一台可以訪問待遷移資料的機器上,且可以訪問OSS的機器上。單擊OSSImport下載。
- 分布式模式:當您需要遷移的資料大於30TB時,推薦使用分布式模式。您可以將OSSImport部署在任意多台可以訪問您待遷移資料,且可以訪問OSS的機器上。單擊OSSImport下載。
说明 當您遷移的資料過大時,為了節約時間,您可以將OSSImport部署到與您OSS相同地區的ECS執行個體上,並通過專線將來源資料存放的伺服器掛載到阿里雲VPC網路中。多台ECS執行個體將資料通過內網遷移至OSS,會極大的提升資料移轉效率。
步驟二:開通Object Storage Service
具體操作步驟請參見開通OSS服務進行開通。
步驟三:建立儲存空間(bucket)
具體操作步驟請參見建立儲存空間。
说明 請確保開通的OSS服務以及建立的Bucket與已購買的Image Search服務在同一個地區。
步驟四:匯入increment.meta 資料
在OSS服務中存放圖片的路徑下,建立increment.meta檔案,該檔案用來儲存批量任務相關內容。
檔案參考樣本如下:
说明 increment.meta檔案中涉及的圖片必須和increment.meta檔案在同一路徑下,否則大量操作會失敗。
{"OperationType": "ADD","ProductId": "1000","PicName": "girl_cloth1.jpg","CategoryId": 0,"IntAttr": 0,"StrAttr": "value1","CustomContent": "k1:v1,k2:v2,k3:v3","Region": "20,40,60,80"}
{"OperationType": "ADD","ProductId": "1000","PicName": "girl_cloth2.jpg","CategoryId": 0,"IntAttr": 0,"StrAttr": "value2","CustomContent": "k1:v1,k2:v2,k3:v3","Region": "20,40,60,80"}
{"OperationType": "ADD","ProductId": "1001","PicName": "girl_cloth3.jpg","CategoryId": 1,"CustomContent": "k1:v1,k2:v2,k3:v3"}
{"OperationType": "ADD","ProductId": "1002","PicName": "girl_cloth4.jpg","CategoryId": 0,"CustomContent": "k1:v1,k2:v2,k3:v3","Crop": false}
{"OperationType": "ADD","ProductId": "1003","PicName": "girl_cloth7.jpg","CustomContent": "https://www.aliyun.com/imagesearch/girl_cloth7.jpg"}
{"OperationType": "ADD","ProductId": "1003","PicName": "girl_cloth6.jpg","CustomContent": "k1:v1,k2:v2,k3:v3"}
{"OperationType": "DELETE","ProductId": "1004","PicName": "fengyi.jpg"}
{"OperationType": "DELETE","ProductId": "1005"}
步驟五:授予Image Search服務訪問OSS的許可權。
步驟六:上傳圖片
执行结果
- 如果運行失敗,單擊查看增量歷史獲得詳細資料。更多資訊請參見增量任務提交失敗的原因都有哪些?
- 圖片上傳成功之後,您可以單擊執行個體ID,然後單擊圖片搜尋進行測試。