create-select-object-meta - Object Storage Service - Centro de documentación de Alibaba Cloud

El comando create-select-object-meta sirve para consultar información de los objetos destino. Por ejemplo, permite obtener el número total de filas y columnas en objetos CSV, así como la cantidad de splits. Si esta información no existe en el objeto, el sistema lo analiza por completo para calcularla y guardarla. En las siguientes llamadas a la API sobre el mismo objeto, se devuelve directamente la información guardada sin necesidad de analizarlo de nuevo.

Notas de uso

De forma predeterminada, una cuenta de Alibaba Cloud tiene los permisos necesarios para gestionar objetos. Para gestionarlos con un usuario de RAM o mediante Security Token Service (STS), se requiere el permiso oss:PutObject. Para más información, consulte Grant a custom policy.

Sintaxis del comando

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

Parámetro	Tipo	Descripción
--bucket	string	Nombre del bucket.
--key	string	Ruta completa del objeto.
--select-meta-request	string	Contenedor que almacena la solicitud CreateSelectObjectMeta.

Nota

El comando create-select-object-meta corresponde a la operación CreateSelectObjectMeta. Para más información sobre los parámetros de esta operación, consulte SelectObject.

--select-meta-request

La opción de configuración --select-meta-request es compatible con los formatos XML y JSON. Si su valor incluye el prefijo 'file://', los parámetros de configuración se leen del archivo 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 más información sobre las opciones globales de línea de comandos compatibles, consulte Command-line options.

Ejemplos

Consulte la información de exampleobject en examplebucket, como el número total de filas, columnas y la cantidad de splits. Esta operación es compatible con la sintaxis de solicitud para objetos CSV.

Cree un archivo de configuración llamado select-meta-request.xml y agregue a continuación el siguiente 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 ejemplo:

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

Cree un archivo de configuración llamado select-meta-request.json y agregue a continuación el siguiente código:

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

Comando de ejemplo:

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

Configure los parámetros del siguiente comando en 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\"}"

Cree un archivo de configuración llamado select-request.xml y agregue a continuación el siguiente código:

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

Comando de ejemplo:

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

Cree un archivo de configuración llamado select-request.json y agregue a continuación el siguiente código:

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

Comando de ejemplo:

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

Configure los parámetros del siguiente comando en formato JSON:

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