Powerdrill 不支持直接调用 PHP 函数，PHP 需通过 HTTP 接口与其通信；必须用 curl 发送含 query 字段的 JSON 请求，设置 Content-Type 和认证头，响应字段为 rows/columns，注意类型转换、空结果及时间精度问题。
Powerdrill 不支持直接调用 PHP 函数
Powerdrill 是 Google 内部演进出来的高性能列式分析引擎（现以开源形式提供），它本身不运行 PHP，也不提供 PHP SDK 或原生扩展。所谓“PHP 与 Powerdrill 集成”，实际是 PHP 作为调度/胶水层，通过 HTTP 接口与 Powerdrill 服务通信。
常见错误现象：Call to undefined function powerdrill_query()、Class 'PowerdrillClient' not found——这些都源于误以为存在官方 PHP 客户端库。
- Powerdrill 官方只提供
curl命令示例和 Python 参考客户端 - PHP 必须自己构造 HTTP 请求，目标地址通常是
https://your-powerdrill-host:8443/v1/query - 请求头必须包含
Content-Type: application/json和有效的认证凭据（如Authorization: Bearer <token></token>）
PHP 发起 Powerdrill 查询的最小可行代码
绕过 SDK，用原生 curl 发送 JSON 查询最稳妥。注意：Powerdrill 的查询体是纯 SQL 字符串，不是嵌套结构。
示例中容易漏掉的关键点：
立即学习“PHP免费学习笔记（深入）”；
-
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode(['query' => 'SELECT COUNT(*) FROM logs']))—— 必须是query字段，不是sql或statement - 必须显式设置
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: application/json'])，否则返回415 Unsupported Media Type - 响应体是 JSON，但字段名是
rows（二维数组）、columns（列名列表），不是标准的data或results
curl -X POST \
https://pd.example.com:8443/v1/query \
-H "Authorization: Bearer abc123" \
-H "Content-Type: application/json" \
-d '{"query":"SELECT user_id, COUNT(*) FROM events GROUP BY user_id LIMIT 10"}'
查询失败时优先检查这三处
90% 的 PHP 调用失败不是语法问题，而是基础设施层卡点。
- Powerdrill 服务是否启用 HTTPS？PHP 的
cURL默认校验证书，若用自签名证书，需加curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false)（仅测试环境） - 查询超时：Powerdrill 默认
timeout_ms=30000，PHP 的curl_setopt($ch, CURLOPT_TIMEOUT, 35)必须略大于它，否则 PHP 层先中断 - SQL 中用了 Powerdrill 不支持的函数，比如
DATE_FORMAT()或CONCAT_WS()—— 它只认format_datetime()、concat()等有限函数集，报错信息里会明确写"Unknown function: DATE_FORMAT"
PHP 处理 Powerdrill 响应的典型陷阱
Powerdrill 返回的 rows 是扁平数组，没有字段类型标注，PHP 拿到全是字符串，连数字都是 "123" 类型。
- 不要直接
json_decode($response, true)['rows'][0]['count'] + 1—— 会触发 PHP 警告（string + int） - 列顺序严格对应
columns数组，不能靠键名；例如['user_id', 'cnt']对应['U123', '42']，得用索引对齐 - 空结果集返回
{"columns":[...], "rows":[], "stats":{...}}，别假设rows一定非空
真正麻烦的是时间字段：Powerdrill 输出 "2024-05-22T14:30:00Z"，PHP DateTime 能解析，但毫秒精度可能被截断，如果业务依赖微秒级，得手动补零或改用 DateTimeImmutable::createFromFormat()。
