COS Select 功能通过结构化查询语句(SQL)筛选存储在对象存储(Cloud Object Storage,COS)上的对象,以便检索对象并获取用户所需的数据。通过 COS Select 功能筛选对象数据,您可以减少 COS 传输的数据量,这将降低检索此数据所需的成本和延迟。
COS Select 功能目前支持检索以 CSV、JSON 和 Parquet 格式存储的对象,支持检索通过 GZIP 或 BZIP2 压缩的对象(仅对于 CSV、JSON 格式的对象)。此外,COS Select 功能还支持将结果的格式指定为 CSV 或 JSON,并且可以确定结果中记录的分隔方式。
您可以在请求中将 SQL 表达式传递给 COS。COS Select 目前只支持部分 SQL 表达式。有关 COS Select 支持的 SQL 表达式的更多信息,请参见 SQL 函数 文档。 您可以使用 COS 控制台、API、SDK、COSCMD 等方式执行 SQL 查询。需要注意,使用 COS 控制台进行文件检索存在一定限制:最大支持检索128M文件,返回的数据量限定为40MB。若需检索更多数据,请使用其他方式进行。
说明
COS Select 所支持的数据类型和当前的保留字段,请参见 数据类型 和 保留字段 了解详情。 目前检索功能仅支持中国大陆公有云地域,其他地域暂不支持此功能。
使用限制
使用 COS Select 时存在以下限制:
您必须拥有所查询对象的 cos:GetObject
权限,主账号默认拥有该权限。
仅支持标准存储类型的对象检索。
SQL 表达式的最大长度为256KB。
检索结果中单条记录的最大长度为1MB。
COS Select 功能目前支持的 SQL 子句:
SELECT 语句
FROM 子句
WHERE 子句
LIMIT 子句
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 函数。
COS Select 目前支持以下运算符:
逻辑运算符:AND,NOT,OR
比较运算符:<,>,<=,>=,=,<>,!=,BETWEEN,IN
模式匹配运算符:LIKE
数学运算符:+,-,*,%
发起检索请求
您可以使用控制台、API、SDK 等多种方式发起检索请求:
使用 SDK,您可以前往 SDK 概览 选择所需的 SDK 接口。 常见问题
如果在尝试执行查询时遇到问题,COS Select 将返回错误代码和关联的错误消息。有关错误代码和描述的列表,请参见 特殊错误码。
本页内容是否解决了您的问题?