为何出现‘module 'google.cloud.bigquery' has no attribute 'format_options'’错误？

问题根源 #

你调用的bigquery.format_options路径错误，format_options不属于顶层google.cloud.bigquery模块，同时也可能是客户端库版本过旧导致该模块未被包含。

正确用法 #

方案1：直接导入模块 #

from google.cloud.bigquery import format_options
parquet_options = format_options.ParquetOptions()

方案2：通过job子模块访问 #

from google.cloud.bigquery import job
parquet_options = job.format_options.ParquetOptions()

ParquetOptions 核心配置项（官方文档翻译） #

ParquetOptions用于配置Parquet格式数据的读写规则，关键参数包括：

• enable_list_inference: 布尔值，自动推断列表类型（默认开启）
• enum_as_string: 布尔值，将枚举类型转为字符串读取（默认关闭）
• decimal_target_types: 列表，指定Decimal类型映射到BigQuery的目标类型，可选NUMERIC/BIGNUMERIC/STRING

版本验证 #

确保客户端库是最新版，执行更新命令：

pip install --upgrade google-cloud-bigquery

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