tencent cloud

对象存储

动态与公告
产品动态
产品公告
产品简介
产品概述
功能概览
应用场景
产品优势
基本概念
地域和访问域名
规格与限制
产品计费
计费概述
计费方式
计费项
免费额度
计费示例
查看和下载账单
欠费说明
常见问题
快速入门
控制台快速入门
COSBrowser 快速入门
用户指南
创建请求
存储桶
对象
数据管理
批量处理
全球加速
监控与告警
运维中心
数据处理
内容审核
智能工具箱
数据工作流
应用集成
工具指南
工具概览
环境安装与配置
COSBrowser 工具
COSCLI 工具
COSCMD 工具
COS Migration 工具
FTP Server 工具
Hadoop 工具
COSDistCp 工具
HDFS TO COS 工具
GooseFS-Lite 工具
在线辅助工具
自助诊断工具
实践教程
概览
访问控制与权限管理
性能优化
使用 AWS S3 SDK 访问 COS
数据容灾备份
域名管理实践
图片处理实践
COS 音视频播放器实践
工作流实践
数据直传
内容审核实践
数据安全
数据校验
大数据实践
COS 成本优化解决方案
在第三方应用中使用 COS
迁移指南
本地数据迁移至 COS
第三方云存储数据迁移至 COS
以 URL 作为源地址的数据迁移至 COS
COS 之间数据迁移
Hadoop 文件系统与 COS 之间的数据迁移
数据湖存储
云原生数据湖
元数据加速
数据加速器 GooseFS
数据处理
数据处理概述
图片处理
媒体处理
内容审核
文件处理
文档处理
故障处理
获取 RequestId 操作指引
通过外网上传文件至 COS 缓慢
访问 COS 时返回403错误码
资源访问异常
POST Object 常见异常
API 文档
简介
公共请求头部
公共响应头部
错误码
请求签名
操作列表
Service 接口
Bucket 接口
Object 接口
批量处理接口
数据处理接口
任务与工作流
内容审核接口
云查毒接口
SDK 文档
SDK 概览
准备工作
Android SDK
C SDK
C++ SDK
.NET(C#) SDK
Flutter SDK
Go SDK
iOS SDK
Java SDK
JavaScript SDK
Node.js SDK
PHP SDK
Python SDK
React Native SDK
小程序 SDK
错误码
鸿蒙(Harmony) SDK
终端 SDK 质量优化
安全与合规
数据容灾
数据安全
访问管理
常见问题
热门问题
一般性问题
计费计量问题
域名合规问题
存储桶配置问题
域名和 CDN 问题
文件操作问题
日志监控问题
权限管理问题
数据处理问题
数据安全问题
预签名 URL 问题
SDK 类问题
工具类问题
API 类问题
服务协议
Service Level Agreement
隐私政策
数据处理和安全协议
联系我们
词汇表

Select 概述

PDF
聚焦模式
字号
最后更新时间: 2026-03-26 11:21:31
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 子句
说明
有关 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 等多种方式发起检索请求:
使用控制台,您可参见 检索数据 文档进行操作。
使用 API,请参见 SELECT Object Content API 文档。
使用 SDK,您可以前往 SDK 概览 选择所需的 SDK 接口。

常见问题

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

帮助和支持

本页内容是否解决了您的问题?

填写满意度调查问卷,共创更好文档体验。

文档反馈