如何用Python客户端库在Cloud Spanner插入Timestamp值？CSV导入报错求助

1. 检查Timestamp格式是否符合Spanner要求 #

Cloud Spanner的Timestamp类型严格遵循RFC3339标准格式，例如2023-10-05T14:48:00Z。如果CSV中的时间格式是2023/10/05 14:48、10-05-2023 下午2:48这类非标准格式，直接导入必然触发类型错误。

解决方式：读取CSV时将原始时间字符串转换为标准格式，以Python为例：

from datetime import datetime

# 假设CSV中时间格式为"%Y/%m/%d %H:%M:%S"
raw_timestamp = "2023/10/05 14:48:00"
# 转换为RFC3339格式
formatted_ts = datetime.strptime(raw_timestamp, "%Y/%m/%d %H:%M:%S").isoformat() + "Z"

2. 确认空值处理是否彻底 #

如果CSV中用""、"N/A"、"NULL"（大小写敏感）等多种占位符表示空值，仅替换Null为None会遗漏其他情况，这些未处理的字符串会被当成无效Timestamp值传入Spanner。

解决方式：扩大空值判断范围，确保所有空占位符都转为None：

ts_value = row["your_timestamp_column"]
# 覆盖常见空值场景
if ts_value.strip() in ("Null", "", "N/A", "NULL"):
    ts_value = None
else:
    # 先清洗字符串再转格式
    ts_value = datetime.strptime(ts_value.strip(), "%Y-%m-%d %H:%M:%S").isoformat() + "Z"

3. 优先传递datetime对象而非字符串 #

使用Spanner客户端库（如Python的google-cloud-spanner）时，直接传递带时区的datetime对象比字符串更可靠，客户端会自动完成类型映射，避免格式解析偏差。

解决方式：转换为UTC时区的datetime对象后插入：

ts_obj = datetime.strptime(raw_timestamp, "%Y/%m/%d %H:%M:%S").replace(tzinfo=datetime.timezone.utc)
# 执行插入时直接传入对象
transaction.execute_update(
    "INSERT INTO your_table (timestamp_col) VALUES (@ts)",
    params={"ts": ts_obj},
)

4. 排查隐藏字符问题 #

部分CSV中的时间字符串可能包含空格、换行符等隐藏字符，导致格式看起来正确但实际不符合标准。可以通过打印原始字符串的repr形式排查：

print(repr(ts_value))  # 若输出为"\n2023-10-05T14:48:00Z"，说明存在换行符

解决方式：先清洗字符串：

ts_value = ts_value.strip()

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