SelectDB Enterprise
参考手册
SQL 函数
表值函数
ICEBERG_META

ICEBERG_META

描述

iceberg_meta 表函数(table-valued-function,tvf),可以用于读取 iceberg 表的各类元数据信息,如操作历史、生成的快照、文件元数据等。

语法

ICEBERG_META(
    "table" = "<table>", 
    "query_type" = "<query_type>"
  );

必填参数

iceberg_meta 表函数 tvf 中的每一个参数都是一个 "key"="value"

FieldDescription
<table>完整的表名,需要按照目录名。库名.表名的格式,填写需要查看的 iceberg 表名。
<query_type>元数据类型,目前仅支持 snapshots

示例(Examples)

  • 读取并访问 iceberg 表格式的 snapshots 元数据。

    select * from iceberg_meta("table" = "ctl.db.tbl", "query_type" = "snapshots");
  • 可以配合desc function使用

    desc function iceberg_meta("table" = "ctl.db.tbl", "query_type" = "snapshots");
  • 查看 iceberg 表的 snapshots

    select * from iceberg_meta("table" = "iceberg_ctl.test_db.test_tbl", "query_type" = "snapshots");
    +------------------------+----------------+---------------+-----------+-------------------+------------------------------+
    |      committed_at      |  snapshot_id   |   parent_id   | operation |   manifest_list   |            summary           |
    +------------------------+----------------+---------------+-----------+-------------------+------------------------------+
    |  2022-09-20 11:14:29   |  64123452344   |       -1      |  append   | hdfs:/path/to/m1  | {"flink.job-id":"xxm1", ...} |
    |  2022-09-21 10:36:35   |  98865735822   |  64123452344  | overwrite | hdfs:/path/to/m2  | {"flink.job-id":"xxm2", ...} |
    |  2022-09-21 21:44:11   |  51232845315   |  98865735822  | overwrite | hdfs:/path/to/m3  | {"flink.job-id":"xxm3", ...} |
    +------------------------+----------------+---------------+-----------+-------------------+------------------------------+
  • 根据 snapshot_id 字段筛选

    select * from iceberg_meta("table" = "iceberg_ctl.test_db.test_tbl", "query_type" = "snapshots") where snapshot_id = 98865735822;
    +------------------------+----------------+---------------+-----------+-------------------+------------------------------+
    |      committed_at      |  snapshot_id   |   parent_id   | operation |   manifest_list   |            summary           |
    +------------------------+----------------+---------------+-----------+-------------------+------------------------------+
    |  2022-09-21 10:36:35   |  98865735822   |  64123452344  | overwrite | hdfs:/path/to/m2  | {"flink.job-id":"xxm2", ...} |
    +------------------------+----------------+---------------+-----------+-------------------+------------------------------+
© 2025 北京飞轮数据科技有限公司 京ICP备2022004029号 | Apache、Apache Doris 以及相关开源项目名称均为 Apache 基金会商标