create-select-object-meta - Object Storage Service: Central de Documentação do Alibaba Cloud

O comando create-select-object-meta consulta informações sobre objetos de destino, como o número total de linhas e colunas em objetos CSV e o número de splits. Se as informações solicitadas não existirem no objeto, o sistema examina todo o objeto para analisar e salvar esses dados. Ao chamar a operação da API no objeto novamente, o sistema retorna as informações salvas, sem examinar todo o objeto.

Notas de uso

Por padrão, uma conta Alibaba Cloud tem permissão para gerenciar objetos. Gerenciar objetos como usuário RAM ou por meio do Security Token Service (STS) requer a permissão oss:PutObject. Para obter mais informações, consulte Conceder uma política personalizada.

Sintaxe do comando

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

Parâmetro	Tipo	Descrição
--bucket	string	Nome do bucket.
--key	string	Caminho completo do objeto.
--select-meta-request	string	Contêiner que armazena a solicitação CreateSelectObjectMeta.

Nota

O comando create-select-object-meta corresponde à operação CreateSelectObjectMeta. Para obter mais informações sobre os parâmetros da operação CreateSelectObjectMeta, consulte SelectObject.

--select-meta-request

A opção de configuração --select-meta-request suporta os formatos XML e JSON. Se o valor da opção incluir o prefixo 'file://', o sistema lê os parâmetros de configuração do arquivo especificado.

Formato 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>

Formato 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
}

Nota

Para obter mais informações sobre as opções globais de linha de comando suportadas, consulte Opções de linha de comando.

Exemplos

Consulte as informações sobre exampleobject em examplebucket, como o número total de linhas, colunas e o número de splits. Esta operação suporta a sintaxe de solicitação para objetos CSV.

Crie um arquivo de configuração chamado select-meta-request.xml e adicione o seguinte código:

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

Comando de exemplo:

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

Crie um arquivo de configuração chamado select-meta-request.json e adicione o seguinte código:

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

Comando de exemplo:

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

Configure os parâmetros no comando a seguir no formato JSON:

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

Consulte as informações sobre exampleobject em examplebucket, como o número total de linhas, colunas e o número de splits. Esta operação suporta a sintaxe de solicitação para objetos JSON.

Crie um arquivo de configuração chamado select-request.xml e adicione o seguinte código:

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

Comando de exemplo:

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

Crie um arquivo de configuração chamado select-request.json e adicione o seguinte código:

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

Comando de exemplo:

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

Configure os parâmetros no comando a seguir no formato JSON:

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