Last updated:|... min read
| Parameter | Sample Value | Description |
|---|---|---|
jdbc_url required | jdbc:postgresql://<DB_URL>:5432/iceberg | JDBC connection string for the catalog database. Replace <DB_URL> with your database host or use host.docker.internal for local Docker containers. |
jdbc_username required | iceberg | Database username for JDBC catalog authentication. |
jdbc_password required | password | Database password for JDBC catalog authentication. |
iceberg_s3_path required | s3://warehouse | S3 bucket path where Iceberg table data and metadata files will be stored. |
aws_region required | us-east-1 | AWS Region where your S3 bucket exist. Required so OLake Go calls the correct regional S3 endpoints. |
| catalog_name | olake_iceberg | Name of the Iceberg catalog OLake Go registers tables under. Defaults to olake_iceberg if left empty. |
| s3_endpoint | https://glue.ap-south-1.amazonaws.com | S3 API endpoint for writing Iceberg data files. Optional for AWS S3 but required for S3-compatible storage like MinIO. |
| s3_use_ssl | false/true | Controls whether OLake Go uses HTTPS when connecting to the S3 API for writing Iceberg files. Set to false when S3 Endpoint uses http:// (for example, local MinIO). Set to true when the endpoint uses https:// (for example, AWS S3 or TLS-enabled MinIO). |
| s3_path_style | false/true | Controls how OLake Go formats S3 request URLs. Path-style puts the bucket name in the URL path instead of the hostname. This is required for MinIO and other S3-compatible storage that do not support AWS-style virtual-hosted URLs. |
| aws_access_key | XXX | AWS access key ID for authentication. Optional if using IAM roles or instance profiles. If using IAM: Docker Compose: add the required IAM environment variables under x-envs in your compose file. See Service Environment Variables for setup details.Kubernetes: set up pod IAM in Cloud IAM Integration. |
| aws_secret_key | XXX | AWS secret access key for authentication. Optional if using IAM roles or instance profiles. If using IAM: Docker Compose: add the required IAM environment variables under x-envs in your compose file. See Service Environment Variables for setup details.Kubernetes: set up pod IAM in Cloud IAM Integration. |
| arrow_writes | false/true | Writes data and delete files using Apache Arrow based writer and registers them in Iceberg. |