CREATE EXTERNAL CATALOG
功能
该语句用于创建 External Catalog。创建后,无需数据导入或创建外部表即可 查询外部数据。当前支持创建如下 External Catalog:
- Hive catalog:用于查询 Apache Hive™ 集群中的数据。
- Iceberg catalog:用于查询 Apache Iceberg 集群中的数据。
- Hudi catalog:用于查询 Apache Hudi 集群中的数据。
- Delta Lake catalog:用于查询 Delta Lake 中的数据。
- JDBC catalog:用于查询 JDBC 数据源中的数据。
- Elasticsearch catalog:用于查询 Elasticsearch 中的数据。该特性自 3.1 版本起支持。
- Paimon catalog:用于查询 Apache Paimon 中的数据。该特性自 3.1 版本起支持。
- Unified catalog:把 Hive、Iceberg、Hudi 和 Delta Lake 作为一个融合的数据源,从中查询数据。该特性自 3.2 版本起支持。
注意
- 在 3.0 及以后版本,使用该语句需要有 System 级 CREATE EXTERNAL CATALOG 权限。
- 在创建 External Catalog 前,需要根据数据源的存储系统(如 AWS S3)、元数据服务(如 Hive metastore)和认证方式(如 Kerberos)在 StarRocks 中做相应的配置。详细信息,请参见以上各个 External Catalog 文档中的「前提条件」小节。
语法
CREATE EXTERNAL CATALOG [IF NOT EXISTS] <catalog_name>
[COMMENT <comment>]
PROPERTIES ("key"="value", ...)
参数说明
参数 | 必选 | 说明 |
---|---|---|
catalog_name | 是 | External catalog 的名称,命名要求参见系统限制。 |
comment | 否 | External catalog 的描述。 |
PROPERTIES | 是 | External catalog 的属性,不同的 external catalog 需要设置不同属性。详细配置信息,请参见 Hive catalog、Iceberg catalog、Hudi catalog、Delta Lake catalog 和 JDBC Catalog。 |