Mengeksekusi kueri terhadap objek yang memenuhi kondisi tertentu dan mencantumkan informasi tentang objek berdasarkan bidang tertentu serta metode pengurutan - Object Storage Service

Perintah do-meta-query mengeksekusi kueri terhadap objek yang memenuhi kondisi tertentu dan mencantumkan informasi objek berdasarkan bidang serta metode pengurutan menggunakan fitur pengindeksan metadata dari sebuah bucket.

Catatan

Secara default, Akun Alibaba Cloud memiliki izin untuk mengeksekusi kueri terhadap objek yang memenuhi kondisi tertentu. Jika Anda ingin menambah atau memodifikasi izin menggunakan Pengguna RAM atau Layanan Token Keamanan (STS), Anda harus memiliki izin oss:DoMetaQuery. Untuk informasi lebih lanjut, lihat Memberikan izin kustom kepada Pengguna RAM.

Sintaks perintah

ossutil api do-meta-query --bucket value --meta-query value [flags]

Parameter	Tipe	Deskripsi
--bucket	string	Nama bucket.
--meta-query	string	Kontainer untuk kondisi kueri.
--meta-query-mode	string	Mode pengambilan. Nilai valid: basic (default): pengambilan skalar semantic: pengambilan vektor

Catatan

Perintah do-meta-query sesuai dengan operasi DoMetaQuery. Untuk informasi lebih lanjut tentang parameter dalam API, lihat DoMetaQuery.

--meta-query

Opsi konfigurasi --meta-query mendukung format XML dan JSON. Jika nilai opsi tersebut mengandung awalan file://, ossutil akan membaca konfigurasi dari file konfigurasi.

Format XML:

<MetaQuery>
  <Query>string</Query>
  <Sort>string</Sort>
  <Order>string</Order>
  <Aggregations>
    <Aggregation>
      <Field>string</Field>
      <Operation>string</Operation>
    </Aggregation>
    ...
  </Aggregations>
  <MediaTypes>
    <MediaType>string</MediaType>
    ...
  </MediaTypes>
  <SimpleQuery>string</SimpleQuery>
  <NextToken>string</NextToken>
  <MaxResults>integer</MaxResults>
</MetaQuery>

Format JSON:

{
  "Query": "string",
  "Sort": "string",
  "Order": "string",
  "Aggregations": {
    "Aggregation": [
      {
        "Field": "string",
        "Operation": "string"
      },
      ...
    ]
  },
  "MediaTypes": {
    "MediaType": ["string", ...]
  },
  "SimpleQuery": "string",
  "NextToken": "string",
  "MaxResults": integer
}

Catatan

Untuk informasi lebih lanjut tentang opsi baris perintah global yang didukung, lihat Opsi Baris Perintah Global yang Didukung.

Contoh

Contoh berikut menunjukkan cara mengeksekusi kueri terhadap objek yang memenuhi kondisi tertentu di bucket examplebucket menggunakan mode skalar dari pengindeksan data.

Buat file konfigurasi bernama meta-query.xml dan tambahkan kode berikut ke dalam file konfigurasi:

<?xml version="1.0" encoding="UTF-8"?>
<MetaQuery>
    <NextToken></NextToken>
    <MaxResults>5</MaxResults>
    <Query>{"Field": "Size","Value": "1048576","Operation": "gt"}</Query>
    <Sort>Size</Sort>
    <Order>asc</Order>
    <Aggregations>
        <Aggregation>
            <Field>Size</Field>
            <Operation>sum</Operation>
        </Aggregation>
        <Aggregation>
            <Field>Size</Field>
            <Operation>max</Operation>
        </Aggregation>
    </Aggregations>
</MetaQuery>

Pernyataan contoh:

ossutil api do-meta-query --bucket examplebucket --meta-query file://meta-query.xml

Buat file konfigurasi bernama meta-query.json dan tambahkan kode berikut ke dalam file konfigurasi:

{
  "MaxResults": "5",
  "Query": "{\"Field\": \"Size\",\"Value\": \"1048576\",\"Operation\": \"gt\"}",
  "Sort": "Size",
  "Order": "asc",
  "Aggregations": {
    "Aggregation": [
      {
        "Field": "Size",
        "Operation": "sum"
      },
      {
        "Field": "Size",
        "Operation": "max"
      }
    ]
  }
}

Pernyataan contoh:

ossutil api do-meta-query --bucket examplebucket --meta-query file://meta-query.json

Gunakan parameter JSON di baris perintah:

ossutil api do-meta-query --bucket examplebucket --meta-query file://meta-query.json

Contoh berikut menunjukkan cara mengeksekusi kueri terhadap objek yang memenuhi kondisi tertentu di bucket examplebucket menggunakan mode vektor dari pengindeksan data.

Buat file konfigurasi bernama meta-query.xml dan tambahkan kode berikut ke dalam file konfigurasi:

<?xml version="1.0" encoding="UTF-8"?>
<MetaQuery>
    <Query>Overlooking the snow covered forest</Query>
    <MediaTypes>
        <MediaType>image</MediaType>
    </MediaTypes>
    <SimpleQuery>{"Operation":"gt", "Field": "Size", "Value": "1"}</SimpleQuery>
</MetaQuery>

Pernyataan contoh:

ossutil api do-meta-query --bucket examplebucket --meta-query file://meta-query.xml  --meta-query-mode semantic

Buat file konfigurasi bernama meta-query.json dan tambahkan kode berikut ke dalam file konfigurasi:

{
    "Query": "Overlooking the snow covered forest",
    "MediaTypes": {
      "MediaType": "image"
    },
    "SimpleQuery": "{\"Operation\":\"gt\", \"Field\": \"Size\", \"Value\": \"1\"}"
}

Pernyataan contoh:

ossutil api do-meta-query --bucket examplebucket --meta-query file://meta-query.json --meta-query-mode semantic

Gunakan parameter JSON di baris perintah:

ossutil api do-meta-query --bucket examplebucket --meta-query "{\"Query\":\"Overlooking the snow covered forest\",\"MediaTypes\":{\"MediaType\":\"image\"},\"SimpleQuery\":\"{\\\"Operation\\\":\\\"gt\\\", \\\"Field\\\": \\\"Size\\\", \\\"Value\\\": \\\"1\\\"}\"}" --meta-query-mode semantic