stackql

环境要求

• 支持 Windows、macOS、Linux 三种操作系统
• Linux/macOS 通过 ZIP 包安装时需要 curl 与 unzip
• 使用 Docker 方式需本机已安装 Docker
• 无需预先安装数据库，StackQL 不依赖外部数据库

安装与启动步骤

1. 1macOS 安装

   用 Homebrew 安装，同时支持 amd64 与 arm64；也可改用下方 tap 形式安装。也可下载 PKG 安装包按提示安装。

   brew install stackql

   复制

2. 2Windows 安装

   先安装 Chocolatey，再执行命令安装；也可下载 MSI 安装包运行，或解压 ZIP 后把目录加入 PATH。

   choco install stackql

   复制

3. 3Linux 安装

   下载最新 Linux ZIP 包并解压出 stackql 文件，放到任意目录，可选把该目录加入 PATH。

   curl -L https://bit.ly/stackql-zip -O && unzip stackql-zip

   复制

4. 4或拉取 Docker 镜像

   不想本地安装可拉取官方镜像使用，DockerHub 上还有 stackql-jupyter-demo 等其他镜像可选。

   docker pull stackql/stackql

   复制

5. 5进入交互式 Shell

   启动 REPL 交互式查询环境，用 --auth 传入云厂商认证信息后即可逐条执行 SQL。

   stackql shell --auth="${AUTH}"

   复制

6. 6执行单条或脚本查询

   用 exec 执行 SQL 语句或用 -i 指定 .iql 脚本文件，可通过 --output 指定输出格式。

   stackql exec --auth="${AUTH}" "SELECT id, status FROM aws.ec2.instances WHERE region = 'us-east-1'"

   复制

7. 7以服务方式运行

   启动服务器，通过 Postgres 有线协议对外提供查询服务，psycopg2 等客户端可连接。

   stackql srv --auth="${AUTH}"

   复制

关键配置

如何确认成功

执行 stackql shell --auth="${AUTH}" 能进入交互式 REPL，或 exec 一条查询后正常返回查询结果，即安装使用成功。

常见问题

注意事项

• macOS 除 Homebrew 外还提供 PKG 安装包，Windows 另提供 MSI 与 ZIP 两种安装方式。
• Linux 解压出的 stackql 文件所在目录可选加入 PATH 环境变量，方便全局调用。
• GitHub Actions 中可使用 setup-stackql 与 stackql-exec 两个官方 Action 做自动化。
• 除标准镜像外还有 stackql-jupyter-demo 镜像，标准镜像也可一条命令执行只读的跨云安全与 FinOps 审计。