跳至主要內容
翻譯頁面

本頁面由英文在 AI 協助下翻譯而成。若兩者有出入,請以英文版本為準。

如何使用 StackQL 查詢 S3 儲存貯體

S3 儲存貯體以兩個相關的資料表公開:aws.s3.buckets 列出帳戶中的儲存貯體,aws.s3.bucket(單數)則傳回由 data__Identifier 識別之單一儲存貯體的完整設定。這種清單與詳細資料的區分,反映了這些資料表所依據的 AWS Cloud Control API。

必要條件​

列出儲存貯體​

SELECT bucket_name
FROM aws.s3.buckets
WHERE region = 'us-east-1';

region 述詞是底層 API 呼叫的必要路由參數;us-east-1 會傳回帳戶的儲存貯體。

檢查單一儲存貯體​

詳細資料表會傳回指定儲存貯體的設定屬性:

SELECT
bucket_name,
bucket_location,
bucket_encryption,
versioning_configuration,
public_access_block_configuration
FROM aws.s3.bucket
WHERE region = 'us-east-1'
AND data__Identifier = 'my-bucket-name';

設定資料行會傳回結構化 JSON;DESCRIBE aws.s3.bucket 會列出所有可用的資料行,包括 logging_configuration、lifecycle_configuration、object_lock_configuration、tags 和 arn。

稽核模式:先列舉,再檢查​

整個帳戶的設定稽核會結合這兩個資料表:先列出儲存貯體名稱,再針對每個儲存貯體查詢詳細資料表。在指令碼中使用時(shell 迴圈,或透過 pystackql 使用 Python),逐一處理清單結果並收集詳細資料列;「是否已啟用版本控制?」或「公開存取封鎖是否完整?」等個別儲存貯體的檢查,就成為對收集結果套用的資料列述詞。這是 StackQL AWS 教學中記載的 S3 資源清單模式。

建立儲存貯體​

可寫入屬性的探索方式與可讀取屬性相同:

SHOW INSERT INTO aws.s3.buckets;

這會產生涵蓋資源可寫入欄位(期望狀態文件和 region)的 INSERT 範本。若只要包含必要欄位,請使用 /*+ REQUIRED */ 查詢提示。