跳到主要内容
翻译页面

本页面由 AI 辅助从英文翻译而来。如两者存在差异，以英文版本为准。

什么是 StackQL？

StackQL 是一种开源的查询语言和运行时，将云与 SaaS Provider 的 API 公开为关系表，可使用标准 SQL 查询。它把每个云资源（虚拟机、存储桶、IAM 策略、GitHub 仓库、Snowflake 数据仓库）都视为表中的一行，把每个 API 操作都视为 SELECT、INSERT、UPDATE 或 DELETE。

工作原理​

典型的基础设施工具将云状态读入本地文件（Terraform 的状态文件），生成计划，然后应用该计划。StackQL 完全跳过状态文件。当你运行查询时，StackQL 向相关 Provider 发起实时 API 调用，规范化响应的结构，并将结果以行的形式返回。除非用户要求，否则两次调用之间不会缓存任何内容。

接口之所以是 SQL，是因为 SQL 是一种稳定且广为理解的查询语言，拥有成熟的工具（客户端、驱动程序、BI 集成、AI 智能体工具包），这些工具对 StackQL 全都“直接可用”。StackQL 在服务器模式下实现了 PostgreSQL 线协议，这意味着任何能与 Postgres 通信的工具（psql、DBeaver、Tableau、Power BI、pandas、LangChain SQL 智能体、MCP 服务器）都能与 StackQL 通信。

示例​

列出某个区域中的所有 EC2 实例及其类型和公网 IP 地址：

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

该查询针对实时的 AWS EC2 API 运行。没有需要刷新的状态文件，没有需要失效的缓存快照，也没有需要学习的特定于 Provider 的 SDK。同样的形式适用于任何 Provider：将 aws.ec2.instances 换成 github.repos.repos 或 azure.compute.virtual_machines，查询模型完全相同。

为什么存在​

StackQL 建立在这样一个前提之上：云基础设施应当是可查询的接口面，而不是静态制品。过去 10 年主导基础设施即代码的状态文件模型，是为人工驱动、受变更控制的工作流设计的：编写代码、plan、评审、apply。该模型在 2 种压力下难以为继：

  1. 多云现实。 每个大型组织都在多个 Provider 上运行工作负载。状态文件按 Provider、按工具、按团队分散存在。跨 AWS、Azure、GitHub 和 Snowflake 回答“我们在生产环境中运行着什么？”，是一项手工汇总工作。
  2. AI 智能体。 智能体需要以实时、结构化的方式访问基础设施状态，才能对其进行推理。状态文件是错误的原语：它在写入的那一刻就已陈旧，并且其格式因工具而异。针对实时 API 的 SQL 接口才是正确的原语：智能体懂 SQL，schema 稳定，数据始终是最新的。

StackQL 的存在是为了让云基础设施像数据库一样可查询，跨越各个 Provider，既面向人类运维人员，也面向 AI 智能体。