本文介紹如何將映像上傳到Image Search服務。

背景信息

Image Search提供兩種方式上傳圖片,一種是通過Image Search產品API或者SDK,另一種方式是通過OSSImport工具。

  • 如果您僅上傳少量圖片,建議您使用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查看任務啟動並執行狀態。