如何将Pub/Sub推送的BigQuery表恢复至备份版本

要解决Cannot rename my-dataset.my-table because it has streaming data.的报错，核心是确保待重命名的表没有活跃的流式写入任务，且流式缓冲区完全清空，具体步骤如下：

• 步骤1：彻底暂停Pub/Sub推送订阅
  直接将Pub/Sub的推送订阅设置为暂停状态（而非改为拉取类型），这会立刻停止向BigQuery表推送新数据，避免新的流式写入产生。

• 步骤2：确认BigQuery流式缓冲区已清空
  通过查询INFORMATION_SCHEMA视图检查目标表的流式缓冲区状态，直到缓冲区完全为空：

  SELECT table_name, streaming_buffer
  FROM `my-dataset.INFORMATION_SCHEMA.STREAMING_TABLES`
  WHERE table_name = 'my-table';
  

  当查询结果中streaming_buffer字段为NULL时，说明缓冲区已无待处理的流式数据。

• 步骤3：执行表重命名操作
  此时可以安全执行重命名：

  ALTER TABLE `my-dataset.my-table` RENAME TO `my-dataset.my-table-old`;
  ALTER TABLE `my-dataset.my-table-backup` RENAME TO `my-dataset.my-table`;
  

• 步骤4：恢复Pub/Sub推送订阅
  将Pub/Sub订阅恢复为推送状态，确保其指向恢复后的my-dataset.my-table，完成数据流的恢复。

额外说明 #

• 暂停Pub/Sub订阅期间，主题中的消息会被保留在订阅队列中，恢复推送后会继续向目标表投递，不会丢失数据。
• 若无法等待缓冲区清空，且可以接受丢弃缓冲区中的未持久化数据，可先执行ALTER TABLE my-dataset.my-table SET OPTIONS(streaming_buffer_timeout_ms=60000)将缓冲区超时设置为1分钟，加速缓冲区数据的持久化，之后再执行上述步骤。

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