创建BigLake托管表报错“BigLake managed tables are not supported”求助

问题重现 #

执行以下SQL创建BigLake托管Iceberg表时触发错误：

CREATE OR REPLACE TABLE `${project_id}.biglake_managed_tables.iceberg_mt_random_name`
(
string_field_0 STRING
)
CLUSTER BY string_field_0
WITH CONNECTION `${project_id}.us.biglake-connection`
OPTIONS (
file_format = 'PARQUET',
table_format = 'ICEBERG',
storage_uri = 'gs://${biglake_managed_tables_bucket_name}/biglake-managed-tables/iceberg_mt_random_name');

错误提示：BigLake managed tables are not supported，且已尝试多区域（US、EU）及特定区域（us-central1、europe-west1）均无效。

解决建议 #

• 确认BigQuery版本与功能启用
  BigLake托管Iceberg表仅支持BigQuery Enterprise Edition，需确保项目已升级至该版本，同时启用BigLake API与Iceberg表相关功能。

• 修正SQL语法
  托管Iceberg表由BigQuery直接管理存储，无需指定WITH CONNECTION子句（该子句用于外部表），正确的创建语法如下：

  CREATE OR REPLACE TABLE `${project_id}.biglake_managed_tables.iceberg_mt_random_name`
  (
    string_field_0 STRING
  )
  CLUSTER BY string_field_0
  OPTIONS (
    table_format = 'ICEBERG',
    storage_uri = 'gs://${biglake_managed_tables_bucket_name}/biglake-managed-tables/iceberg_mt_random_name'
  );
  

  注意：托管Iceberg表不需要指定file_format，BigQuery会自动处理存储格式。

• 确保区域与资源匹配
  需保证数据集区域、存储桶区域、BigQuery作业区域完全一致，避免跨区域配置导致的兼容性问题。

• 验证权限配置
  执行SQL的账号需具备以下权限：

  • bigquery.tables.create（针对目标数据集）
  • storage.objects.create、storage.objects.get（针对指定GCS存储桶）
  • biglake.tables.create（BigLake相关权限）

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