全部產品
Search
文件中心

Image Search:大量操作

更新時間:Feb 05, 2024

Image Search可以通過大量操作功能大量匯入阿里雲OSS中的圖片,或大量刪除已經入庫的圖片,適用於較大規模的離線圖片資料操作,穩定性高、速度快、操作方便。本文為您介紹如何批量新增和刪除圖片。

大量操作流程

  1. 開通OSS服務
  2. 將圖片匯入到OSS中
  3. 建立increment.meta檔案
  4. Image Search服務授權
  5. 建立批量任務

開通OSS服務

如果您尚未開通OSS服務,請參見開通OSS服務進行開通。開通服務後,您還需要建立儲存空間Bucket,具體請參見控制台建立儲存空間
說明
  • 開通的OSS為獨立計費,具體計費方式請參見計費概述
  • 請確保開通的OSS服務與已購買的Image Search服務在同一地區,否則將無法使用大量操作功能。

將圖片匯入到OSS中

匯入圖片,具體操作請參見上傳檔案
說明 圖片存放路徑可以自訂,只需要在建立批量任務時設定圖片路徑即可。

建立increment.meta檔案

在OSS服務中存放圖片的路徑下,建立increment.meta檔案,該檔案用來儲存大量操作任務相關內容。
說明
  1. increment.meta檔案中涉及的圖片必須和increment.meta檔案在同一Bucket下,否則大量操作會失敗。
  2. increment.meta檔案名稱是固定的,Image Search將根據此檔案名稱讀取大量操作相關內容,不要擅自修改檔案名稱,否則會操作失敗。
  3. Image Search大量操作支援同一Bucket,不同路徑(path)圖片的大量操作,例如:Bucket為imagesearch,increment.meta檔案在此Bucket的根目錄下,path為girlCloth,圖片在此path目錄下,圖片名稱為girl_cloth8.jpg,則meta檔案中PicName應寫為“PicName":"girlCloth/girl_cloth8.jpg",注意:必須寫成"girlCloth/girl_cloth8.jpg",在girlCloth前面和girl_cloth8.jpg後面都不能加正斜線(/)。如果有多級目錄按照此邏輯依次類推。
  4. 在OSS中的圖片名稱尾碼必須填寫,例如圖片名稱為girl_cloth10.jpg,不能寫為"PicName":"girl_cloth10",必須寫為"PicName":"girl_cloth10.jpg",否則會處理失敗。
檔案參考樣本如下:
{"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": "ADD","ProductId": "1006","PicName": "girlCloth/girl_cloth10.jpg","CustomContent": "k1:v1,k2:v2,k3:v3"}
{"OperationType": "DELETE","ProductId": "1004","PicName": "fengyi.jpg"}
{"OperationType": "DELETE","ProductId": "1005"}
每個圖片由JSON格式表示,具體欄位含義如下表所示:
參數類型是否必選說明
OperationTypeString操作類型。
  • ADD:新增圖片。
  • DELETE:刪除圖片。
ProductIdString圖片唯一識別碼,最多支援512個字元。
PicNameString圖片名稱。OSS的Bucket中圖片名稱。最多支援512個字元。
重要
  1. 每行最多隻允許填寫1個圖片名稱。若同一個ProductId,對應多個PicName則需要填寫多行。
  2. 圖片名稱必須填寫尾碼,例如:girl_cloth.jpg,不能寫為girl_cloth,必須寫為girl_cloth.jpg,否則會處理失敗。
  3. 如果圖片具有相同的商品ID+圖片名稱,則以最後一次添加為準。即如果圖片具有相同的商品ID+圖片名稱,則不管圖片本身是否相同,後一張圖片都會覆蓋前一張圖片。
  4. 新增圖片具體要求如下
    • 圖片大小要求不超過4 MB。

    • 圖片格式:PNG、JPG、JPEG、BMP、GIF、WEBP、TIFF、PPM。

    • 傳輸等待時間不超過5秒。

    • 服務類型為商品圖片搜尋、通用圖片搜尋、傢具家居圖片搜尋、工業五金圖片搜尋時,圖片長和寬像素要求大於等於100且小於等於4096px。

    • 圖片中不能包含旋轉資訊。

CategoryIdInteger更多說明,請參見類目參考
  • 對於商品搜尋,如果設定類目,則以設定的為準,並且設定的類目必須在類目參考的範圍之內,否則會入庫失敗。
  • 如果不設定類目,將由系統進行類目預測,預測的類目結果可在Response中擷取。
  • 對於通用搜尋、著作權圖片搜尋、工業五金、傢具家居圖片搜尋,不論是否設定類目,系統會將類目設定為88888888。
CustomContentString使用者自訂內容。最多支援4096個字元。
說明

圖片的CustomContent會在搜尋結果中自動關聯出來。通過CustomContent欄位,您可以填寫圖片的URL地址,圖片額外附加資訊等,以便與您的業務關聯。

IntAttrInteger整數類型屬性。用於查詢時設定過濾。
說明

整數型別屬性與圖片查詢時的過濾條件組合使用,以起到過濾查詢的功能。請參考條件過濾

StrAttrString字串類型屬性。最多支援128字元。用於查詢時設定過濾。
說明

字串類型屬性與圖片查詢時的過濾條件組合使用,以起到過濾查詢的功能。請參考條件過濾

CropBoolean是否進行主體識別。預設為true。
  • true:系統自動進行主體識別,以識別的主體進行搜尋。
  • false:不進行主體識別,以整張圖進行搜尋。
RegionString圖片的主體地區。格式為x1,x2,y1,y2,其中x1和y1是左上方的點,x2和y2是右下角的點。
說明

若設定了該參數,則Crop參數不生效,以該設定為準。

Image Search服務授權

Image Search服務通過OSS來實現資料大量操作,首次使用需完成帳號一鍵授權。如已完成授權,可跳過此步驟。

  1. 登入Image Search控制台
  2. 選擇目標服務類型和目標執行個體。
  3. 單擊大量操作頁簽。
    大量操作
  4. 單擊建立批量任務,在對話方塊單擊確認一鍵授權
    一鍵授權
  5. 雲資源訪問授權頁面單擊同意授權
    同意授權

建立批量任務

  1. 登入Image Search控制台
  2. 選擇目標服務類型和目標執行個體。
  3. 單擊大量操作頁簽。
    大量操作
  4. 單擊建立批量任務
    建立批量任務
  5. 設定批量任務參數。
    • 所屬地區

      執行個體所在地區。

    • Bucket名稱
      OSS上建立的相應的Bucket名稱。
      重要 請確保開通的OSS服務與已購買的Image Search服務在同一個地區。
    • 資料路徑
      需要上傳的圖片和increment.meta檔案的儲存路徑。大量操作-資料路徑
    • meta檔案

      需要處理圖片的列表檔案,支援檢測是否存在,檔案名稱為increment.meta

    • 完成後資訊回調
      輸入回調地址,僅支援HTTP或者HTTPS開頭。
      {
        "finishTime": "2021-05-19 17:50:00",
        "instanceId": "imagesearch-cn-xxxx",
        "instanceName": "instanceName",
        "message": "success",
        "processResultUrl": "https://image-search-task-info.oss-cn-shanghai.aliyuncs.com/yyyyyyyyyy",
        "status": "NORMAL",
        "taskId": 111
      }
      欄位名描述
      finishTime完成時間,精確到秒。
      instanceNameImage Search執行個體名稱。
      instanceIdImage Search執行個體ID。
      status任務執行結果,NORMAL為正常,FAIL為執行失敗。
      taskId任務ID。
      message資訊描述;success為成功。
      processResultUrl錯誤結果下載。

後續步驟

在執行個體詳情頁,查看所有批量任務的資訊。批量任務狀態為成功後,使用者可以查看相應的提示資訊: