Select 概述

最近更新时间:2019-09-19 11:24:36

COS Select 功能通过结构化查询语句(SQL)筛选存储在 COS 上的对象,以便检索对象并获取用户所需的数据。通过 COS Select 功能筛选对象数据,您可以减少 COS 传输的数据量,这将降低检索此数据所需的成本和延迟。

COS Select 功能目前支持检索以 CSV、JSON 格式存储的对象,支持检索通过 GZIP 或 BZIP2 压缩的对象(仅对于 CSV 和 JSON 对象)。此外,COS Select 功能还支持将结果的格式指定为 CSV 或 JSON,并且可以确定结果中记录的分隔方式。

您可以在请求中将 SQL 表达式传递给 COS。COS Select 目前只支持部分 SQL 表达式。有关 COS Select 支持的 SQL 表达式的更多信息,请参见 SQL 函数 文档。

您可以使用 COS SDK、API、COSCMD 或 COS 控制台等方式执行 SQL 查询。需要注意,使用 COS 控制台进行文件检索存在一定限制:最大支持检索128M文件,返回的数据量限定为40MB。若需检索更多数据,请使用其他方式进行。

说明:

COS Select 所支持的数据类型和当前的保留字段,请参见 数据类型保留字段 了解详情。

使用限制

使用 COS Select 时存在以下限制:

  • 您必须拥有所查询对象的 cos:GetObject 权限,主账号默认拥有该权限。
  • 仅支持标准存储类型的对象检索。
  • SQL 表达式的最大长度为256KB。
  • 检索结果中单条记录的最大长度为1MB。

COS Select 功能目前支持的 SQL 子句:

  • SELECT 语句
  • FROM 子句
  • WHERE 子句
  • LIMIT 子句
说明:

有关 SQL 子句的详细信息,请参见 Select 命令

COS Select 目前支持的函数如下:

  • 聚合函数:如 AVG 函数、COUNT 函数、MAX 函数、MIN 函数、SUM 函数。
  • 条件函数:如 COALESCE 函数、NULLIF 函数。
  • 转换函数:如 CAST 函数。
  • 日期函数:如 DATE_ADD 函数、DATE_DIFF 函数、EXTRACT 函数、TO_STRING 函数、TO_TIMESTAMP 函数、UTCNOW 函数。
  • 字符串函数:如 CHAR_LENGTH 函数、CHARACTER_LENGTH 函数、LOWER 函数、SUBSTRING 函数、TRIM 函数、UPPER 函数。
说明:

有关 SQL 函数的详细信息,请参见 SQL 函数

COS Select 目前支持以下运算符:

  • 逻辑运算符:AND,NOT,OR
  • 比较运算符:<,>,<=,>=,=,<>,!=,BETWEEN,IN
  • 模式匹配运算符:LIKE
  • 数学运算符:+,-,*,%
说明:

有关运算符的详细信息,您可以参见 运算符

发起检索请求

您可以使用控制台、API、SDK 等多种方式发起检索请求:

常见问题

如果在尝试执行查询时遇到问题,COS Select 将返回错误代码和关联的错误消息。有关错误代码和描述的列表,请参见 特殊错误码