SuperAPI AI 工具集

querying-aws-s3

部署与运维

查看项目

更新于 10-15 17:23

技能介绍

用途:通过 Amazon Athena 查询 AWS 托管的只读 Iceberg 系统表,替代低效的 list-objects-v2 / head-object 调用,用于统计对象数量、追踪上传删除、审计操作者、按标签或元数据查找对象、搜索注解内容及分析存储指标。

主要能力:S3 Metadata 系统表(命名空间 b_<bucket-name>)含 journal(近实时事件日志,含 requester、source_ip_address、删除事件)、inventory(每对象一行,含 object_tags、storage_class)、annotation(text_value 存全文)。Storage Lens 表(命名空间 lens_<config-id>_exp)含 default_storage_metrics、default_activity_metrics、bucket_property_metrics,日粒度。

必要用法:查询语法为 "s3tablescatalog/aws-s3"."<namespace>"."<table>"。先确认配置:aws s3api get-bucket-metadata-configuration --bucket <BUCKET> --region <REGION>;未启用则用 create-bucket-metadata-configuration 开启,可用 get-storage-lens-configuration 检查导出。需 Athena 执行权限、S3 Tables 读权限及已注册的 s3tablescatalog Glue 联邦目录,Athena 工作组须对结果启用 SSE-KMS。

适用场景:桶规模统计、写入与删除审计、标签检索、注解全文或 JSON 字段搜索、存储类分布与桶级趋势;单对象注解查询或写注解应改用 get-object-annotation、put-object-annotation。

限制:所有表只读,不支持 INSERT/UPDATE/DELETE;inventory 可能处于 BACKFILLING,更新约 1 小时;Storage Lens 首次交付最长 48 小时且无历史回填;桶名中的点号在命名空间转为下划线;journal 结果可能含敏感 IP 与账户标识;CATALOG_NOT_FOUND 需先启用 S3 Tables 与 Glue 集成。缺失信息暂未提供。