Object Storage Service:create-select-object-meta

Notes d'utilisation

Par défaut, un compte Alibaba Cloud dispose des autorisations nécessaires pour gérer les objets. Pour gérer les objets via un utilisateur RAM ou le service Security Token Service (STS), l'autorisation oss:PutObject est requise. Pour plus d'informations, consultez la rubrique Accorder une stratégie personnalisée.

Syntaxe de la commande

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

--select-meta-request

L'option de configuration --select-meta-request prend en charge les formats XML et JSON. Si la valeur de l'option commence par le préfixe file://, les paramètres de configuration sont lus depuis le fichier spécifié.

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

Exemples

• Interrogez les métadonnées de l'objet exampleobject dans le bucket examplebucket, telles que le nombre total de lignes, de colonnes et de partitions. Cette opération prend en charge la syntaxe de requête pour les objets CSV.

  • Créez un fichier de configuration nommé select-meta-request.xml et ajoutez le code suivant :

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

    Exemple de commande :

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

  • Créez un fichier de configuration nommé select-meta-request.json et ajoutez le code suivant :

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

    Exemple de commande :

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

  • Configurez les paramètres directement dans la commande au 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\"}"

• Interrogez les métadonnées de l'objet exampleobject dans le bucket examplebucket, telles que le nombre total de lignes, de colonnes et de partitions. Cette opération prend en charge la syntaxe de requête pour les objets JSON.

  • Créez un fichier de configuration nommé select-request.xml et ajoutez le code suivant :

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

    Exemple de commande :

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

  • Créez un fichier de configuration nommé select-request.json et ajoutez le code suivant :

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

    Exemple de commande :

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

  • Configurez les paramètres directement dans la commande au format JSON :

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