GCP从存储桶导入CSV成功但Cloud SQL表仍为空的问题与解决

我之前也碰到过一模一样的棘手情况——盯着操作日志显示Import from gs://container/a.csv succeeded.，结果查数据库表还是空空如也，折腾了好一会儿才揪出问题根源：外键约束导致的导入顺序错误。

问题本质 #

当目标表存在外键关联时，Cloud SQL导入CSV时如果遇到外键值在关联表中不存在的情况，数据库会默默拒绝插入这些数据（但不会在导入日志里抛出错误，这就很容易误导人），最终表看起来就是空的。外键约束的核心要求是：被关联的表（外键指向的那张表）必须先有对应数据，依赖它的表才能成功插入数据。

可行解决办法 #

• 调整导入顺序（最优方案）：先导入被关联的基础表，确保它的数据全部到位后，再导入依赖它的表。比如表orders的user_id外键关联users表，那必须先导入users的CSV，再导入orders的CSV，这样外键约束就能正常通过，数据也能成功插入。
• 临时禁用外键约束（谨慎使用）：如果实在没办法调整导入顺序，可以临时关闭目标表的外键约束，导入完成后再重新开启。操作命令如下：

  -- 临时禁用外键检查
  SET FOREIGN_KEY_CHECKS = 0;
  -- 执行Cloud SQL的CSV导入操作
  -- 导入完成后重新开启外键检查
  SET FOREIGN_KEY_CHECKS = 1;
  

  注意：这个方法存在数据不一致风险，导入后一定要仔细验证数据的关联性是否正确。

• 校验CSV数据格式：额外确认CSV里的外键值和关联表中的值完全匹配（比如数据类型、大小写、是否含多余空格等），有时候格式不匹配也会导致插入失败但日志无报错。

按照这个思路调整后，你应该就能看到数据成功出现在目标表中了。

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