如何使用PHP连接BigQuery？已按官方指南配置仍存疑问

嘿，刚配置完BigQuery的PHP开发环境却不知道下一步怎么走？太正常了，我当初入门的时候也懵过～咱们直接从运行第一个简单查询开始，不需要找什么现成的神秘文件，自己写几行代码就能搞定，一步步来：

第一步：确认基础配置是否到位 #

先快速检查两个关键环节，避免踩坑：

• 你已经通过Composer安装了Google Cloud BigQuery客户端库吧？如果没装，再跑一遍：

  composer require google/cloud-bigquery
  

• 服务账号密钥的环境变量已经设置好了吗？比如在终端里（Windows用set，Mac/Linux用export）：

  # Mac/Linux
  export GOOGLE_APPLICATION_CREDENTIALS="/path/to/your-service-account-key.json"
  
  # Windows
  set GOOGLE_APPLICATION_CREDENTIALS=C:\path\to\your-service-account-key.json
  

第二步：写极简查询脚本 #

直接新建一个bigquery-test.php文件，把下面的代码粘进去——这是一个查询BigQuery公开数据集的例子（不用你自己建表，就能直接看到结果）：

<?php

require __DIR__ . '/vendor/autoload.php';

use Google\Cloud\BigQuery\BigQueryClient;

// 初始化BigQuery客户端
$bigQuery = new BigQueryClient([
    'projectId' => '你的GCP项目ID', // 替换成你自己的项目ID
]);

// 构建查询语句：这里查的是公开的美国天气数据集
$query = <<<SQL
    SELECT name, state, temperature
    FROM `bigquery-public-data.ghcn_d.ghcnd_2023`
    WHERE state = 'CA' AND temperature > 30
    LIMIT 10
SQL;

// 执行查询
$queryJobConfig = $bigQuery->query($query);
$queryResults = $bigQuery->runQuery($queryJobConfig);

// 输出查询结果
if ($queryResults->isComplete()) {
    $rows = $queryResults->rows();
    foreach ($rows as $row) {
        printf("城市：%s，州：%s，温度：%d\n", $row['name'], $row['state'], $row['temperature']);
    }
} else {
    echo "查询还在执行中，请稍后再试～";
}

第三步：运行脚本并验证结果 #

在终端里跑这个脚本：

php bigquery-test.php

如果一切正常，你会看到来自加州的10条温度超过30度的天气记录。

一些实用小提示 #

• 如果报错说找不到服务账号密钥，先检查环境变量路径是否正确，或者也可以直接在代码里指定密钥路径（不推荐生产环境用，但测试方便）：

  $bigQuery = new BigQueryClient([
      'projectId' => '你的GCP项目ID',
      'keyFilePath' => '/path/to/your-service-account-key.json'
  ]);
  

• 想查询你自己的数据集？只需要把SQL语句里的bigquery-public-data.ghcn_d.ghcnd_2023替换成你自己的项目ID.数据集ID.表名就行。
• 入门阶段先把查询跑通最关键，后续如果需要做创建表、导入数据等操作，再去探索客户端库的进阶功能就好。

内容的提问来源于stack exchange，提问作者Pankaj