CreateSelectObjectMeta
获取目标文件总的行数,总的列数(对于CSV文件),以及Splits个数。如果该信息不存在,则会扫描整个文件,分析并记录下CSV文件的上述信息。重复调用该API则会保存上述信息而不必重新扫描整个文件
服务地址:
华东1 金融云
输入参数
只看必填
bucketBucket名称
keyObject的完整路径
x-oss-process如果是csv文件
body保存CreateSelectObjec...
CsvMetaRequest保存SelectMetaRequest...
InputSerialization保存Select请求的容器
CompressionType指定文件压缩类型(可选)
CSV保存Select请求的容器
FileHeaderInfo指定CSV文件头信息(可选)
RecordDelimiter指定换行符
FieldDelimiter指定CSV列分隔符
QuoteCharacter指定CSV的引号字符
CommentCharacter指定CSV的注释符
Range指定查询文件的范围(可选)
AllowQuotedRecordDelimiter指定CSV内容是否含有在引号中的换行符
请选择布尔值
JSON保存Select请求的容器
Type指定输入JSON的类型
Range指定查询文件的范围(可选)
ParseJsonNumberAsString将JSON中的数字(整数和浮点数)解析...
请选择布尔值
OverwriteIfExists重新计算SelectMeta
请选择布尔值
插件下载了解更多
VS Code 插件
安装插件之前,确保已安装 VS Code安装插件之前,确保已安装 VS Code
Alibaba Cloud Developer Toolkit is a collection of extensions that can help access Alibaba Cloud services in Visual Studio Code.
JetBrains 插件
安装插件之前,确保已安装 JetBrains IDE安装插件之前,确保已安装 JetBrains IDE
The Alibaba Cloud Developer Toolkit for JetBrains makes it easier to access Alibaba Cloud services.

接口说明

  • CreateSelectObjectMeta操作要求您对该 Object 有写权限。

  • 如果该 API 执行正确,返回 200。如果目标文件不是合法 CSV 或者 JSON LINES 文件,或者指定的 CSV 分隔符和目标 CSV 不匹配,则返回 400。

请求语法

POST /{key} HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
<?xml version="1.0" encoding="UTF-8"?>
<CsvMetaRequest>
  <InputSerialization>
    <CompressionType>string</CompressionType>
    <CSV>
      <FileHeaderInfo>string</FileHeaderInfo>
      <RecordDelimiter>string</RecordDelimiter>
      <FieldDelimiter>string</FieldDelimiter>
      <QuoteCharacter>string</QuoteCharacter>
      <CommentCharacter>string</CommentCharacter>
      <Range>string</Range>
      <AllowQuotedRecordDelimiter>boolean</AllowQuotedRecordDelimiter>
    </CSV>
    <JSON>
      <Type>string</Type>
      <Range>string</Range>
      <ParseJsonNumberAsString>boolean</ParseJsonNumberAsString>
    </JSON>
  </InputSerialization>
  <OverwriteIfExists>boolean</OverwriteIfExists>
</CsvMetaRequest>

路径参数

字段名称字段详情
keystring

Object 的完整路径。

示例值:exampledir/exampleobject.png

请求参数

字段名称字段详情
bucketstring

Bucket 名称。

示例值:examplebucket
x-oss-processstring

如果是 csv 文件,该值需要设置为 csv/meta;如果是 json 文件,则需要设置为 json/meta。

示例值:csv/meta
bodyobject

保存 CreateSelectObjectMeta 请求的容器。

返回参数

字段名称字段详情
Offsetinteger<int64>

8 位整数,扫描结束时的文件偏移。

注意 请注意,该值为 Long 类型,在某些语言中可能存在精度丢失的风险,请小心使用。
示例值:0x0000000000000065
TotalScannedBytesinteger<int64>

8 位整数,最终扫描过的数据大小。

注意 请注意,该值为 Long 类型,在某些语言中可能存在精度丢失的风险,请小心使用。
示例值:0x0000000000000065
Statusinteger<int64>

4 位整数,最终的 status。

注意 请注意,该值为 Long 类型,在某些语言中可能存在精度丢失的风险,请小心使用。
示例值:0x000000c8
SplitsCountinteger<int64>

4 位整数,总 split 个数。

注意 请注意,该值为 Long 类型,在某些语言中可能存在精度丢失的风险,请小心使用。
示例值:0x00000001
RowsCountinteger<int64>

8 位整数,总行数。

注意 请注意,该值为 Long 类型,在某些语言中可能存在精度丢失的风险,请小心使用。
示例值:0x0000000000000003
ColsCountinteger<int64>

4 位整数,总列数。

注意 请注意,该值为 Long 类型,在某些语言中可能存在精度丢失的风险,请小心使用。
示例值:0x00000004
ErrorMessagestring

详细的错误信息。如果无错误,则 error_message 为空。

示例值:The body size in select request exceeds the max allowed size.
变更历史
暂无变更历史