Todos os produtos
Search
Central de documentação

Object Storage Service:create-select-object-meta

Última atualização: Jul 03, 2026

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 a quantidade de splits. Se essas informações não existirem no objeto, o sistema verifica todo o conteúdo para analisar e salvar os dados mencionados. Em chamadas subsequentes à API para o mesmo objeto, o sistema retorna as informações salvas sem verificar o objeto inteiro novamente.

Observações de uso

Por padrão, uma conta Alibaba Cloud tem permissões para gerenciar objetos. Para gerenciar objetos como usuário RAM ou com o Security Token Service (STS), é necessária a permissão oss:PutObject. Para 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 mais detalhes sobre os parâmetros dessa operação, consulte SelectObject.

--select-meta-request

A opção de configuração --select-meta-request aceita os formatos XML e JSON. Se o valor da opção contiver 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 mais informações sobre as opções globais de linha de comando compatíveis, consulte Opções de linha de comando.

Exemplos

  • Consulte informações sobre exampleobject em examplebucket, incluindo o número total de linhas, colunas e a quantidade de splits. Esta operação aceita 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 diretamente no comando usando o 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 informações sobre exampleobject em examplebucket, incluindo o número total de linhas, colunas e a quantidade de splits. Esta operação aceita 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 diretamente no comando usando o formato JSON:

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