本教程详细讲解了在使用 php google bigquery 客户端库获取查询结果时，因未指定作业执行区域而导致 404 错误的常见问题。文章提供了明确的解决方案，即通过 `getqueryresults` 方法的第三个参数传入 `location` 选项，确保客户端能够正确检索到特定区域的 bigquery 作业结果，从而避免“job not found”错误。
Google BigQuery 是一项强大的、高度可扩展的无服务器数据仓库服务。在 BigQuery 中执行的任何查询或数据加载操作都被视为一个“作业”（Job）。这些作业通常在特定的地理区域（如 us-central1、europe-west1 或 asia-east1）内执行。即使在提交查询时没有显式指定区域，BigQuery 也会根据项目配置或默认设置在一个区域中运行该作业。
理解 BigQuery 作业的区域性至关重要，因为后续对该作业的任何操作（例如检查其状态、获取查询结果）都可能需要知道它是在哪个区域执行的。如果尝试从错误的区域或未指定区域检索作业，BigQuery 服务将无法找到它，从而导致错误。
在使用 PHP 的 Google BigQuery 客户端库（google/cloud-bigquery 或旧版 google/apiclient）时，开发者可能会遇到一个常见的 404 "Not found: Job" 错误，尤其是在尝试通过 getQueryResults 方法检索已成功提交的查询作业结果时。
例如，以下代码片段展示了提交 BigQuery 查询作业的典型流程：
立即学习“PHP免费学习笔记（深入）”；
<?php
require 'vendor/autoload.php';
use Google\Client;
use Google\Service\Bigquery;
use Google\Service\Bigquery\Job;
use Google\Service\Bigquery\JobConfiguration;
use Google\Service\Bigquery\JobConfigurationQuery;
// 初始化 Google 客户端
$client = new Client();
$client->setApplicationName('Google-BigQuery');
// 假设运行在 App Engine 或其他支持应用默认凭据的环境中
$client->useApplicationDefaultCredentials();
$client->addScope('https://www.googleapis.com/auth/bigquery');
$client->addScope('https://www.googleapis.com/auth/devstorage.read_write'); // 如果需要存储读写权限
$bq = new Bigquery($client);
$projectId = 'my-project'; // 替换为你的项目ID
// 构造查询作业配置
$query = "SELECT * FROM `my-project.my_dataset.my_table` LIMIT 100"; // 你的SQL查询
$queryConfig = new JobConfigurationQuery();
$queryConfig->setQuery($query);
$config = new JobConfiguration();
$config->setQuery($queryConfig);
$job = new Job();
$job->setConfiguration($config);
try {
// 提交查询作业
$submittedJob = $bq->jobs->insert($projectId, $job);
$jobReference = $submittedJob->getJobReference();
$jobId = $jobReference->getJobId();
$jobLocation = $jobReference->getLocation(); // 尝试获取作业的执行区域
echo "Job submitted successfully. Job ID: " . $jobId . ", Location: " . $jobLocation . PHP_EOL;
// 尝试获取查询结果 - 问题通常发生在这里
// 假设作业在 'europe-west1' 区域执行，但此处未指定
$queryResults = $bq->jobs->getQueryResults($projectId, $jobId); // 可能会导致 404 错误
} catch (\Google\Service\Exception $e) {
echo "Error submitting or fetching job: " . $e->getMessage() . PHP_EOL;
// 错误信息可能包含 "Not found: Job my-project:job-id"
// 或者 "Not found: Job my-project:job-id"
}
?>尽管作业提交（$bq->jobs->insert）可能成功，并且通过 BigQuery 控制台可以查看到该作业及其结果，但上述代码中的 $bq->jobs->getQueryResults($projectId, $jobId) 调用却经常返回 404 "Not found: Job" 错误。
这种错误的根本原因在于，BigQuery 作业的完整标识不仅包括项目 ID 和作业 ID，还可能隐含或明确包含其执行的区域信息。当客户端尝试不带区域信息去检索一个在特定区域执行的作业时，BigQuery 服务无法在默认或当前区域找到该作业，从而返回 404 错误。
解决此问题的关键是，在调用 getQueryResults 方法时，明确告知 BigQuery 作业所在的区域。getQueryResults 方法接受一个可选的第三个参数，用于传递额外的查询选项，其中就包括 location。
你需要创建一个包含 location 键值对的关联数组，并将其作为第三个参数传递。例如，如果你的 BigQuery 作业在 europe-west1 区域执行，修正后的代码应如下所示：
<?php
// ... (之前的初始化和作业提交代码保持不变) ...
try {
$submittedJob = $bq->jobs->insert($projectId, $job);
$jobReference = $submittedJob->getJobReference();
$jobId = $jobReference->getJobId();
$jobLocation = $jobReference->getLocation(); // 获取作业的实际执行区域
echo "Job submitted successfully. Job ID: " . $jobId . ", Location: " . $jobLocation . PHP_EOL;
// 构造包含 location 参数的选项数组
$options = ['location' => $jobLocation]; // 使用实际获取到的区域
// 使用带有 location 参数的 options 数组来获取查询结果
$queryResults = $bq->jobs->getQueryResults($projectId, $jobId, $options);
// 成功获取结果后，可以进一步处理 $queryResults
echo "Successfully fetched query results." . PHP_EOL;
// 例如，打印行数
echo "Total rows: " . $queryResults->getTotalRows() . PHP_EOL;
} catch (\Google\Service\Exception $e) {
echo "Error submitting or fetching job: " . $e->getMessage() . PHP_EOL;
}
?>通过这种方式，BigQuery 服务会知道在 $jobLocation 指定的区域查找 $jobId 这个作业，从而成功检索到结果。
在实际应用中，你需要知道 BigQuery 作业是在哪个区域执行的。有几种方法可以确定这一点：
在 PHP 中使用 Google BigQuery 客户端库处理作业时，明确指定作业的执行区域是避免 404 "Job not found" 错误的关键。通过在 getQueryResults 方法中传递 location 参数，可以确保客户端能够准确地定位并检索到 BigQuery 作业的结果。理解 BigQuery 的区域性是成功管理和操作其数据流的重要一环。始终从 jobReference 对象获取实际的作业区域，并将其用于后续的 API 调用，是处理这类问题的最佳实践。
以上就是解决 PHP 中 BigQuery 查询结果 404 错误：区域定位的重要性的详细内容，更多请关注php中文网其它相关文章！
PHP怎么学习？PHP怎么入门？PHP在哪学？PHP怎么学才快？不用担心，这里为大家提供了PHP速学教程(入门到精通)，有需要的小伙伴保存下载就能学习啦！
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号
215
收藏
