Connect Doris to Iceberg REST
Introduction
Apache Gravitino exposes an Iceberg REST catalog endpoint that any Iceberg-compatible engine can connect to directly. This page describes how to configure Apache Doris to use Gravitino's Iceberg REST (IRC) endpoint.
Prerequisites
- Apache Gravitino running with the Iceberg REST service enabled. See Iceberg REST catalog service for setup instructions.
- The Gravitino IRC endpoint is accessible from your Doris environment. The default port is
9001.
Configuration
Point a Doris catalog at the Gravitino IRC
CREATE CATALOG iceberg PROPERTIES (
"uri" = "http://{gravitino_host}:9001/iceberg/",
"type" = "iceberg",
"iceberg.catalog.type" = "rest",
"s3.endpoint" = "http://s3.{region}.amazonaws.com",
"s3.region" = "{region}",
"s3.access_key" = "{access_key}",
"s3.secret_key" = "{secret_key}"
);
Examples
Create and query a table
SWITCH iceberg;
CREATE DATABASE db;
USE db;
CREATE TABLE t(a int);
INSERT INTO t VALUES (1);
SELECT * FROM t;
Gravitino connector vs. Iceberg REST
| Feature | Gravitino Engine Connector | Iceberg REST |
|---|---|---|
| Engine plugin required | Yes | No |
| Gravitino access control | Yes | Yes |
| Supported engines | Trino, Spark, Flink, Daft | Any Iceberg-compatible engine |
| Credential vending | Varies | Yes (S3, GCS, OSS, ADLS) |