表格管理和安全规则

在 Apache Iceberg REST Catalog 端点中创建和管理表时,需要遵循以下位置、权限和安全加固规则:

表位置

表路径必须嵌套在父命名空间路径(例如 gs://{namespace_path}/.../{table_name})内。此限制是为了增强安全性并强化目录。

表格路径的行为变更:请注意,生成的表格位置(创建 metadata/ 文件夹的位置)会自动附加一个随机字符串作为后缀,以防止冲突并提高安全性:

  • 如果未提供具体位置,则生成的位置为 gs://{namespace_path}/{table_name}/{random_suffix}
  • 如果提供了具体位置(例如 gs://{namespace_path}/.../{table_name}),则生成的位置为 gs://{namespace_path}/.../{table_name}/{random_suffix}

表注册权限

BigLake 目录需要 biglake.tables.register 权限才能注册表。此权限仅限于 BigLake Admin (roles/biglake.admin) 角色,以确保只有管理员可以执行表注册。旧版 Cloud Storage 存储桶目录目前仍强制执行 biglake.tables.create 以进行表格注册,但在正式公告发布后,最终会过渡到新的注册权限。