跳至主要內容
翻譯頁面

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

如何使用 StackQL 查詢 AWS EC2 執行個體

EC2 執行個體以資料表 aws.ec2.instances 的形式公開。EC2 DescribeInstances API 傳回的任何欄位都是可查詢的資料行,而由於該 API 是區域性的,region 是必要的 WHERE 述詞。

必要條件​

基本查詢​

列出單一區域中的執行個體及其類型與位址資訊:

SELECT
instance_id,
instance_type,
private_ip_address,
public_ip_address,
launch_time
FROM aws.ec2.instances
WHERE region = 'us-east-1';

先探索 schema​

兩個中繼資料命令讓資源能夠自我描述,不需要查閱 AWS 文件:

DESCRIBE aws.ec2.instances;
SHOW METHODS IN aws.ec2.instances;

DESCRIBE 會列出可用的資料行。SHOW METHODS 會列出各項作業(describe_instances SELECT 方法、terminate_instances DELETE 方法,以及 start_instances、stop_instances、reboot_instances 等 EXEC 生命週期方法)及每項作業的必要參數。這些命令無需憑證即可運作。

多區域彙總​

region IN (...) 述詞會為每個區域平行執行一次 API 呼叫並彙總結果,讓區域性服務能像全域資料表一樣查詢:

SELECT region, instance_type, COUNT(*) as num_instances
FROM aws.ec2.instances
WHERE region IN ('us-east-1','us-west-2','eu-west-1','ap-southeast-2')
GROUP BY region, instance_type;

此模式是全帳戶資源清單與漂移基準的基礎:結果是即時的答案,而非快照。

依屬性篩選​

標準 SQL 述詞適用於任何資料行。例如,暴露於網際網路的執行個體:

SELECT instance_id, instance_type, public_ip_address
FROM aws.ec2.instances
WHERE region = 'us-east-1'
AND public_ip_address IS NOT NULL;

state 和 tags 等結構化資料行會傳回 JSON,可使用所設定 SQL 後端的 JSON 函式加以拆解。