如何将仅含表头的CSV导入BigQuery生成带列名的空表？

针对你遇到的问题，这里提供几种可行的解决方式：

方法1：提前定义表结构，导入时跳过表头 #

先根据CSV的表头创建目标表的结构，再执行导入时跳过表头行：

-- 先创建匹配表头的表结构
CREATE OR REPLACE TABLE [DBNAME].[TABLENAME] (
  列名1 STRING,
  列名2 INT64,
  列名3 FLOAT64,
  -- 按CSV表头依次定义所有列的名称和数据类型
);

-- 执行导入，跳过表头行
LOAD DATA OVERWRITE [DBNAME].[TABLENAME]
FROM FILES (
  format = 'CSV',
  uris = ['gs://xxxx/yyyy/file.csv'],
  field_delimiter = '\t',
  allow_quoted_newlines = true,
  skip_leading_rows = 1
);

当CSV只有表头行时，skip_leading_rows=1会跳过这一行，OVERWRITE模式下最终得到结构正确的空表。

方法2：通过外部表自动识别表头，生成空表 #

如果不想提前手动定义表结构，可以借助外部表自动解析表头，再生成空表：

-- 创建指向CSV文件的外部表，自动识别表头为列名
CREATE OR REPLACE EXTERNAL TABLE [DBNAME].[EXTERNAL_TMP_TABLE]
OPTIONS (
  format = 'CSV',
  uris = ['gs://xxxx/yyyy/file.csv'],
  field_delimiter = '\t',
  allow_quoted_newlines = true,
  skip_leading_rows = 1
);

-- 基于外部表的结构创建空的目标表
CREATE OR REPLACE TABLE [DBNAME].[TABLENAME]
AS SELECT * FROM [DBNAME].[EXTERNAL_TMP_TABLE]
WHERE 1=0;

外部表会自动读取CSV表头作为列名，WHERE 1=0的条件会确保只复制表结构，不导入任何数据，最终得到符合预期的空表。

方法3：前置校验文件内容（脚本化处理） #

如果需要自动化处理，可以用脚本（比如Python、Cloud Functions）先检查CSV文件的行数：

• 若文件只有1行（仅表头），则根据表头创建空表；
• 若文件有数据行，再执行原有的LOAD DATA语句。

比如用Python检查GCS上的CSV文件：

from google.cloud import storage

def check_csv_rows(bucket_name, file_path):
    storage_client = storage.Client()
    bucket = storage_client.bucket(bucket_name)
    blob = bucket.blob(file_path)
    content = blob.download_as_text()
    rows = content.splitlines()
    return len(rows)

# 调用示例
row_count = check_csv_rows("xxxx", "yyyy/file.csv")
if row_count == 1:
    # 执行创建空表的逻辑（可通过BigQuery API执行CREATE TABLE语句）
    pass
else:
    # 执行原有的LOAD DATA语句
    pass

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