membuat-pilih-meta-objek -

Perintah Membuat-Pilih-Meta-Objek digunakan untuk menanyakan informasi tentang objek target, seperti jumlah total baris, kolom, dan split dalam objek CSV. Jika informasi yang diminta tidak tersedia, sistem akan memindai seluruh objek untuk menganalisis dan menyimpan informasi tersebut. Saat Anda memanggil operasi API pada objek lagi, informasi yang tersimpan akan dikembalikan tanpa pemindaian ulang.

Catatan penggunaan

Secara default, akun Alibaba Cloud memiliki izin untuk mengelola objek. Mengelola objek sebagai pengguna RAM atau menggunakan Security Token Service (STS) memerlukan izin oss:PutObject. Untuk informasi lebih lanjut, lihat Lampirkan Kebijakan Kustom ke Pengguna RAM.

Sintaks perintah

ossutil api create-select-object-meta --bucket value --key value --select-meta-request value [flags]

Parameter	Tipe	Deskripsi
--bucket	string	Nama bucket.
--key	string	Jalur lengkap objek.
--select-meta-request	string	Kontainer yang menyimpan permintaan CreateSelectObjectMeta.

Catatan

Perintah create-select-object-meta sesuai dengan operasi CreateSelectObjectMeta. Untuk informasi lebih lanjut tentang parameter dalam operasi CreateSelectObjectMeta, lihat SelectObject.

--select-meta-request

Opsi konfigurasi --select-meta-request mendukung format XML dan JSON. Jika nilai opsi berisi awalan 'file://', parameter konfigurasi dibaca dari file yang ditentukan.

Format XML:

<SelectMetaRequest>
  <InputSerialization>
    <CompressionType>string</CompressionType>
    <CSV>
      <RecordDelimiter>string</RecordDelimiter>
      <FieldDelimiter>string</FieldDelimiter>
      <QuoteCharacter>string</QuoteCharacter>
      <CommentCharacter>string</CommentCharacter>
      <Range>string</Range>
      <AllowQuotedRecordDelimiter>boolean</AllowQuotedRecordDelimiter>
      <FileHeaderInfo>string</FileHeaderInfo>
    </CSV>
    <JSON>
      <Range>string</Range>
      <ParseJsonNumberAsString>boolean</ParseJsonNumberAsString>
      <Type>string</Type>
    </JSON>
  </InputSerialization>
  <OverwriteIfExists>boolean</OverwriteIfExists>
</SelectMetaRequest>

Format JSON:

{
  "InputSerialization": {
    "CompressionType": "string",
    "CSV": {
      "CommentCharacter": "string",
      "Range": "string",
      "AllowQuotedRecordDelimiter": boolean,
      "FileHeaderInfo": "string",
      "RecordDelimiter": "string",
      "FieldDelimiter": "string",
      "QuoteCharacter": "string"
    },
    "JSON": {
      "Type": "string",
      "Range": "string",
      "ParseJsonNumberAsString": boolean
    }
  },
  "OverwriteIfExists": boolean
}

Catatan

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

Contoh

Menanyakan informasi tentang exampleobject di examplebucket, seperti jumlah total baris, kolom, dan split. Operasi ini mendukung sintaks permintaan untuk objek CSV.

Buat file konfigurasi bernama select-meta-request.xml dan tambahkan kode berikut:

<?xml version="1.0"?>
<CsvMetaRequest>
    <InputSerialization>
        <CSV>
            <RecordDelimiter>Cg==</RecordDelimiter>
            <FieldDelimiter>LA==</FieldDelimiter>
            <QuoteCharacter>Ig==</QuoteCharacter>
        </CSV>
    </InputSerialization>
    <OverwriteIfExisting>false</OverwriteIfExisting>
</CsvMetaRequest>

Contoh perintah:

ossutil api create-select-object-meta --bucket examplebucket --key exampleobject --select-meta-request file://select-meta-request.xml

Buat file konfigurasi bernama select-meta-request.json dan tambahkan kode berikut:

{
  "InputSerialization": {
    "CSV": {
      "RecordDelimiter": "Cg==",
      "FieldDelimiter": "LA==",
      "QuoteCharacter": "Ig=="
    }
  },
  "OverwriteIfExisting": "false"
}

Contoh perintah:

ossutil api create-select-object-meta --bucket examplebucket --key exampleobject --select-meta-request file://select-meta-request.json

Konfigurasikan parameter dalam perintah berikut dalam format JSON:

ossutil api create-select-object-meta --bucket examplebucket --key exampleobject --select-meta-request "{\"InputSerialization\":{\"CSV\":{\"RecordDelimiter\":\"Cg==\",\"FieldDelimiter\":\"LA==\",\"QuoteCharacter\":\"Ig==\"}},\"OverwriteIfExisting\":\"false\"}"

Menanyakan informasi tentang exampleobject di examplebucket, seperti jumlah total baris, kolom, dan split. Operasi ini mendukung sintaks permintaan untuk objek JSON.

Buat file konfigurasi bernama select-request.xml dan tambahkan kode berikut:

<?xml version="1.0"?>
<JsonMetaRequest>
    <InputSerialization>
        <JSON>
            <Type>LINES</Type>
        </JSON>
    </InputSerialization>
    <OverwriteIfExisting>false</OverwriteIfExisting>
</JsonMetaRequest>

Contoh perintah:

ossutil api create-select-object-meta --bucket examplebucket --key exampleobject --select-meta-request file://select-meta-request.xml

Buat file konfigurasi bernama select-request.json dan tambahkan kode berikut:

{
  "InputSerialization": {
    "JSON": {
      "Type": "LINES"
    }
  },
  "OverwriteIfExisting": "false"
}

Contoh perintah:

ossutil api create-select-object-meta --bucket examplebucket --key exampleobject --select-meta-request file://select-meta-request.json

Konfigurasikan parameter dalam perintah berikut dalam format JSON:

ossutil api create-select-object-meta --bucket examplebucket --key exampleobject --select-meta-request "{\"InputSerialization\":{\"JSON\":{\"Type\":\"LINES\"}},\"OverwriteIfExisting\":\"false\"}"