Pencarian Gambar memungkinkan Anda mengimpor dan menghapus gambar secara massal melalui operasi batch. Anda mendefinisikan operasi tersebut dalam file manifest (increment.meta) yang disimpan di Object Storage Service (OSS), dan Pencarian Gambar memprosesnya sebagai satu tugas.
Sebelum memulai
| Prasyarat | Deskripsi |
|---|---|
| Aktifkan OSS | Jika belum diaktifkan, aktifkan OSS dan buat bucket. OSS ditagih secara terpisah. Untuk informasi selengkapnya, lihat Ikhtisar penagihan. |
| Persyaratan wilayah yang sama | Bucket OSS dan instans Pencarian Gambar Anda harus berada di wilayah yang sama. |
| Unggah gambar | Unggah gambar ke bucket OSS. Untuk informasi selengkapnya, lihat Unggah objek. |
| Persyaratan gambar | Ukuran maksimum: 4 MB. Format yang didukung: PNG, JPG, JPEG, BMP, GIF, WEBP, TIFF, PPM. Resolusi: 100 x 100 hingga 4096 x 4096 piksel (untuk pencarian gambar produk dan pencarian gambar generik). Gambar tidak boleh berisi informasi rotasi. Latensi transmisi harus kurang dari 5 detik. |
Langkah 1: Buat file increment.meta
Buat file bernama increment.meta di bucket OSS Anda. File manifest ini memberi tahu Pencarian Gambar gambar mana yang akan diimpor atau dihapus. Setiap baris berisi satu objek JSON yang menjelaskan satu operasi.
Aturan file
| Aturan | Detail |
|---|---|
| Lokasi | File increment.meta dan gambar yang direferensikannya harus berada di bucket yang sama. |
| Nama file | Harus tepat increment.meta. Jangan mengganti namanya. |
| Format | Satu objek JSON per baris. Beberapa entri dalam satu baris menyebabkan operasi gagal. |
| Nama gambar | Harus menyertakan ekstensi file (misalnya, girl_cloth10.jpg, bukan girl_cloth10). |
| Subdirektori | Gunakan path relatif tanpa garis miring di awal (misalnya, girlCloth/girl_cloth8.jpg). |
Contoh file 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": "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"}Referensi parameter
Parameter wajib
| Parameter | Tipe | Deskripsi |
|---|---|---|
| OperationType | String | Tipe operasi. ADD: impor gambar ke Pencarian Gambar. DELETE: hapus gambar dari Pencarian Gambar. |
| ProductId | String | ID unik gambar. ID dapat memiliki panjang hingga 256 karakter. |
| PicName | String | Nama gambar yang disimpan di bucket OSS. Nama dapat memiliki panjang hingga 256 karakter. Sertakan ekstensi file dan gunakan path relatif untuk gambar di subdirektori. |
| CustomContent | String | Konten yang ditentukan pengguna yang dikembalikan dalam hasil pencarian. Nilainya dapat memiliki panjang hingga 4.096 karakter. Anda dapat menggunakan bidang ini untuk menyimpan metadata seperti URL gambar atau informasi bisnis lainnya. |
Parameter opsional
| Parameter | Tipe | Default | Deskripsi |
|---|---|---|---|
| CategoryId | Integer | Diprediksi otomatis | Kategori gambar. Untuk informasi selengkapnya, lihat Referensi kategori. Untuk pencarian gambar produk, kategori yang ditentukan memiliki prioritas dan harus berada dalam rentang valid yang dijelaskan dalam topik referensi kategori. Jika Anda tidak menentukan kategori, sistem akan memprediksi satu dan mengembalikan hasilnya dalam respons. Untuk pencarian gambar generik, nilai ini diatur ke 88888888 terlepas dari input. |
| IntAttr | Integer | - | Atribut integer untuk memfilter gambar dalam kueri pencarian. Untuk informasi selengkapnya, lihat Filter berdasarkan kondisi. |
| StrAttr | String | - | Atribut string untuk memfilter gambar dalam kueri pencarian. Nilainya dapat memiliki panjang hingga 128 karakter. Karakter khusus seperti \, ¥, $, &, dan % tidak didukung. Untuk informasi selengkapnya, lihat Filter berdasarkan kondisi. |
| Crop | Boolean | true | Menentukan apakah akan mengidentifikasi subjek dalam gambar dan melakukan pencarian berdasarkan subjek yang teridentifikasi. Atur ke false untuk mencari berdasarkan seluruh gambar. |
| Region | String | - | Bidang subjek gambar, ditentukan sebagai x1,x2,y1,y2 di mana x1 dan y1 merepresentasikan pojok kiri atas, sedangkan x2 dan y2 merepresentasikan pojok kanan bawah. Jika ditentukan, nilai ini memiliki prioritas dibanding parameter Crop.Catatan Jika Anda mengatur parameter ini, parameter `Crop` akan diabaikan. |
Setiap baris dalam file hanya boleh berisi satu nama gambar. Jika satu ProductId sesuai dengan beberapa nama gambar, tambahkan baris terpisah untuk setiap gambar.
Jika Anda mengimpor gambar dengan
ProductIddanPicNameyang sama dengan gambar yang sudah ada, gambar baru akan menimpa gambar yang ada.
Langkah 2: Otorisasi Pencarian Gambar untuk mengakses OSS
Saat pertama kali menggunakan operasi batch, Anda harus mengotorisasi akun Pencarian Gambar untuk mengakses OSS. Jika otorisasi ini telah dilakukan sebelumnya, lewati langkah ini.
Masuk ke Konsol Pencarian Gambar.
Pilih tipe layanan dan klik nama instans yang ingin Anda kelola.
Klik tab Batch Operation.
Klik Create Batch Task. Pada kotak dialog yang muncul, klik Confirm the authorization.
Di halaman Cloud Resource Access Authorization, klik Confirm Authorization Policy.
Langkah 3: Buat tugas batch
Masuk ke Konsol Pencarian Gambar.
Pilih tipe layanan dan klik nama instans yang ingin Anda kelola.
Klik tab Batch Operation.
Klik Create Batch Task.
Konfigurasikan parameter berikut:
| Parameter | Deskripsi |
|---|---|
| Region | Wilayah tempat instans Pencarian Gambar Anda dideploy. |
| Bucket Name | Nama bucket OSS. Pastikan bucket berada di wilayah yang sama dengan instans Pencarian Gambar Anda. |
| Path | Path tempat gambar dan file increment.meta disimpan. |
| META files | File manifest increment.meta. Klik ikon Refresh untuk memverifikasi bahwa file tersebut ada. |
| Callbacks after the operation completes | (Opsional) URL callback yang dimulai dengan HTTP atau HTTPS. Pencarian Gambar mengirimkan hasil tugas ke URL ini setelah tugas selesai. |
Format respons callback
Saat URL callback dikonfigurasi, Pencarian Gambar mengirimkan muatan JSON berikut setelah tugas selesai:
{
"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
}| Bidang | Deskripsi |
|---|---|
| finishTime | Waktu saat tugas selesai, akurat hingga detik. |
| instanceName | Nama instans Pencarian Gambar. |
| instanceId | ID instans Pencarian Gambar. |
| status | Hasil tugas. NORMAL menunjukkan sukses. FAIL menunjukkan gagal. |
| taskId | ID tugas batch. |
| message | Deskripsi hasil. success menunjukkan tugas telah selesai. |
| processResultUrl | URL untuk mengunduh informasi kegagalan detail jika ada gambar yang gagal diproses. |
Batalkan tugas batch
Anda dapat membatalkan tugas yang berada dalam status Processing:
Di tab Batch Operation, temukan tugas tersebut dan klik Cancel.
Di kotak dialog konfirmasi, klik OK.
Setelah pembatalan, bagian yang telah selesai tetap dipertahankan dan status tugas berubah menjadi Stop. Klik Download Results untuk melihat detail eksekusi.
Lihat hasil tugas batch
Di tab Batch Operation pada halaman Detail Instans, Anda dapat melihat semua tugas batch yang dibuat untuk instans tersebut. Tugas yang sedang berjalan menampilkan indikator progres. Jika tugas batch berada dalam status Imported, Anda dapat melihat deskripsi hasil tugas di kolom Error Message.
Filter tugas berdasarkan bucket name atau path.
Jika kolom Error Message menampilkan Some of the images cannot be processed and are isolated., artinya beberapa gambar gagal diproses selama tugas inkremental. Klik Download Report untuk melihat detail kegagalan.