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. |
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 }
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\"}"
-