MainTargetsIceberg

Iceberg Setup

Prerequisites

  • Catalog endpoint and credentials
  • Storage credentials (S3 or GCS)
  • Target namespace

Setup

Catalog

Configure your Iceberg catalog connection.

FieldDescription
URICatalog endpoint (e.g., https://catalog.example.com)
WarehouseStorage location identifier
AuthenticationOAuth2, Bearer, or Basic

Target Namespace

Specify where tables will be created. Use comma-separated values for multi-level namespaces.

Example: my_database, my_schema creates tables under my_database.my_schema

Storage Credentials

FieldDescription
Access Key IDAWS access key
Secret Access KeyAWS secret key
RegionAWS region (e.g., us-east-1)
EndpointCustom endpoint for S3-compatible storage
Path Style AccessEnable for MinIO and similar
FieldDescription
Credentials JSONService account key (base64-encoded)
Project IDGCP project identifier

Write Options

FieldDefaultDescription
Spec VersionV3Iceberg table format version
Write ModeAppendHow updates and deletes are handled
Flush Interval10000 msCommit frequency

Authentication

MethodFieldsUse Case
OAuth2Token endpoint, client ID, client secret, scopeProduction environments
BearerTokenService accounts, CI/CD
BasicUsername, passwordDevelopment, JDBC catalogs

Last updated on

On this page