Iceberg Catalog
引入或更新: v1.2.668
Databend 支持集成 Apache Iceberg 目录,增强了其数据管理和分析的兼容性和多功能性。这通过无缝整合 Apache Iceberg 强大的元数据和存储管理能力,扩展了 Databend 的功能。
数据类型映射
下表展示了 Apache Iceberg 和 Databend 之间的数据类型映射。请注意,Databend 目前不支持表中未列出的 Iceberg 数据类型。
Apache Iceberg | Databend |
---|---|
BOOLEAN | BOOLEAN |
INT | INT32 |
LONG | INT64 |
DATE | DATE |
TIMESTAMP/TIMESTAMPZ | TIMESTAMP |
FLOAT | FLOAT |
DOUBLE | DOUBLE |
STRING/BINARY | STRING |
DECIMAL | DECIMAL |
ARRAY<TYPE> | ARRAY, 支持嵌套 |
MAP<KEYTYPE, VALUETYPE> | MAP |
STRUCT<COL1: TYPE1, COL2: TYPE2, ...> | TUPLE |
LIST | ARRAY |
管理目录
Databend 提供了以下命令来管理目录:
CREATE CATALOG
在 Databend 查询引擎中定义并建立一个新的目录。
语法
CREATE CATALOG <catalog_name>
TYPE = <catalog_type>
CONNECTION = (
METASTORE_ADDRESS = '<hive_metastore_address>'
URL = '<data_storage_path>'
<connection_parameter> = '<connection_parameter_value>'
<connection_parameter> = '<connection_parameter_value>'
...
)
参数 | 是否必需 | 描述 |
---|---|---|
TYPE | 是 | 目录类型:'HIVE' 表示 Hive 目录,'ICEBERG' 表示 Iceberg 目录。 |
METASTORE_ADDRESS | 否 | Hive Metastore 地址。仅对 Hive 目录必需。 |
URL | 是 | 与此目录关联的外部存储位置。这可以是桶或桶内的文件夹。例如,'s3://databend-toronto/'。 |
connection_parameter | 是 | 用于与外部存储建立连接的连接参数。所需的参数因特定的存储服务和认证方法而异。请参阅 连接参数 获取详细信息。 |
备注
要从 HDFS 读取数据,您需要在启动 Databend 之前设置以下环境变量。这些环境变量确保 Databend 可以访问必要的 Java 和 Hadoop 依赖项,以有效与 HDFS 交互。请确保将 "/path/to/java" 和 "/path/to/hadoop" 替换为 Java 和 Hadoop 安装的实际路径,并调整 CLASSPATH 以包含所有必需的 Hadoop JAR 文件。
export JAVA_HOME=/path/to/java
export LD_LIBRARY_PATH=${JAVA_HOME}/lib/server:${LD_LIBRARY_PATH}
export HADOOP_HOME=/path/to/hadoop
export CLASSPATH=/all/hadoop/jar/files
SHOW CREATE CATALOG
返回指定目录的详细配置,包括其类型和存储参数。
语法
SHOW CREATE CATALOG <catalog_name>;
SHOW CATALOGS
显示所有已创建的目录。
语法
SHOW CATALOGS [LIKE '<pattern>']
USE CATALOG
将当前会话切换到指定的目录。
语法
USE CATALOG <catalog_name>
使用示例
此示例演示了创建一个目录,该目录配置为与位于 MinIO 的 's3://databend/iceberg/' 的 Iceberg 数据存储进行交互。
CREATE CATALOG iceberg_ctl
TYPE = ICEBERG
CONNECTION = (
URL = 's3://databend/iceberg/'
AWS_KEY_ID = 'minioadmin'
AWS_SECRET_KEY = 'minioadmin'
ENDPOINT_URL = 'http://127.0.0.1:9000'
REGION = 'us-east-2'
);
SHOW CREATE CATALOG iceberg_ctl;
┌─────────────┬─────────┬────────────────────────────────────────────────────────────────────────────────────────┐
│ Catalog │ Type │ Option │
├─────────────┼─────────┼────────────────────────────────────────────────────────────────────────────────────────┤
│ iceberg_ctl │ iceberg │ STORAGE PARAMS s3 | bucket=databend, root=/iceberg/, endpoint=http://127.0.0.1:9000 │
└─────────────┴─────────┴────────────────────────────────────────────────────────────────────────────────────────┘