Google BigQuery API执行COUNT(*)返回0，控制台查询结果正常的问题

问题背景 #

在分析NOAA强风暴数据集时，通过Python API遍历1960-2022年的分年份表，统计有财产损失的风暴数量。执行COUNT(*)查询后，打印结果显示Row((552,), {'ct': 0})这类内容，看似count值为0，但在BigQuery控制台执行相同查询能得到正确结果；改为SELECT *查询时，API返回结果也正常。

原代码如下：

from google.cloud import bigquery
client = bigquery.Client.from_service_account_json("secret.json")

for year in range(1960, 2023):
    query = f"""
    SELECT count(*) AS ct
    FROM `bigquery-public-data.noaa_historic_severe_storms.storms_{year}`
    WHERE damage_property > 0
    """
    query_job = client.query(query).result()
    for row in query_job:
       print(row)

打印结果示例：

Row((552,), {'ct': 0})
Row((620,), {'ct': 0})
Row((401,), {'ct': 0})

原因分析 #

这是对BigQuery Python客户端Row对象的显示逻辑误解：

• 第一个元组(552,)是实际查询返回的字段值，也就是正确的count结果；
• 后面的字典{'ct': 0}是字段名到索引的映射，表示ct字段对应的是元组中索引为0的位置，并非字段值为0。

直接打印Row对象时会同时展示这两部分信息，导致误以为count值为0，实际上查询本身是正确的。

解决方案 #

不要直接打印Row对象，而是提取具体的字段值，有两种常用方式：

方式1：通过字段名访问 #

修改打印逻辑，直接调用row.ct获取统计值：

from google.cloud import bigquery
client = bigquery.Client.from_service_account_json("secret.json")

for year in range(1960, 2023):
    query = f"""
    SELECT count(*) AS ct
    FROM `bigquery-public-data.noaa_historic_severe_storms.storms_{year}`
    WHERE damage_property > 0
    """
    query_job = client.query(query).result()
    for row in query_job:
       print(f"年份{year}: 有财产损失的风暴数量: {row.ct}")

方式2：通过索引访问 #

如果不确定字段名，也可以通过索引（对应字典里的映射值）获取：

# 打印部分替换为
print(f"年份{year}: 有财产损失的风暴数量: {row[0]}")

执行修改后的代码，就能得到和控制台一致的正确统计结果。

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