Topik ini menjelaskan bidang dan operator yang tersedia untuk pengambilan skalar OSS.
Catatan
Kueri sederhana mendukung operator berikut: eq (sama dengan), gt (lebih besar dari), gte (lebih besar dari atau sama dengan), lt (kurang dari), lte (kurang dari atau sama dengan), match (kueri fuzzy), dan prefix (kueri awalan). Operasi agregat mendukung operator berikut: min (minimum), max (maksimum), average (rata-rata), sum (jumlah), count (hitungan), distinct (hitungan tanpa duplikat), dan group (hitungan berkelompok).
Untuk mencari file menggunakan bidang
OSSUserMeta.*, ganti tanda bintang (*) dengan kunci metadata yang ditentukan pengguna. Sistem akan mencari file berdasarkan pasangan kunci-nilai dari metadata yang ditentukan pengguna. Kunci tidak peka huruf besar-kecil, sedangkan nilai peka huruf besar-kecil.Sebagai contoh, Anda dapat mencari file dengan metadata pengguna
x-oss-meta-location=hangzhoudengan menetapkan kondisi kueri menjadi{"Field": "OSSUserMeta.x-oss-meta-location", "Value": "hangzhou", "Operation": "eq"}.Untuk mencari file menggunakan bidang
OSSTagging.*, ganti tanda bintang (*) dengan kunci tag objek. Sistem akan mencari file berdasarkan pasangan kunci-nilai dari tag objek. Baik kunci maupun nilai dari tag objek bersifat peka huruf besar-kecil.Sebagai contoh, untuk mencari file yang memiliki tag
owner=John, tetapkan kondisi kueri menjadi{"Field": "OSSTagging.owner", "Value": "John", "Operation": "eq"}.
Daftar dukungan
Tabel berikut mencantumkan bidang yang tersedia untuk kueri sederhana, operasi agregat, dan pengurutan. Tabel ini juga menentukan operator yang didukung oleh setiap bidang.
Dalam tabel, ✓ menunjukkan bahwa bidang mendukung operator tersebut, dan × menunjukkan bahwa bidang tidak mendukung operator tersebut.
Bidang | Deskripsi | Operator (dalam kondisi kueri sederhana) | Operator (dalam operasi agregat) | Urutkan | |||
eq, gt, gte, lt, lte | match | prefix | min, max, sum, average | count, distinct, group | |||
ETag | Mengidentifikasi konten objek. | ✓ | × | ✓ | × | ✓ | ✓ |
FileModifiedTime | Waktu terakhir dimodifikasi objek. | ✓ | × | × | × | ✓ | ✓ |
Filename | Nama objek, termasuk jalur lengkap dan nama file. | ✓ | ✓ | ✓ | × | ✓ | ✓ |
ObjectACL | Daftar kontrol akses (ACL) objek. | ✓ | × | ✓ | × | ✓ | ✓ |
OSSCRC64 | Nilai CRC-64 64-bit objek. | ✓ | × | ✓ | × | ✓ | ✓ |
OSSObjectType | Jenis objek. | ✓ | × | ✓ | × | ✓ | ✓ |
OSSStorageClass | Kelas penyimpanan objek. | ✓ | × | ✓ | × | ✓ | ✓ |
OSSTagging.* | Tag objek. | ✓ | × | ✓ | × | × | × |
OSSTaggingCount | Jumlah tag objek. | ✓ | × | × | ✓ | ✓ | ✓ |
Size | Ukuran objek. | ✓ | × | × | ✓ | ✓ | ✓ |