Skip to main content

Manage Catalogs

Catalogs are connections to Iceberg metadata stores. This guide covers adding, configuring, and removing catalogs.

Add a Catalog​

  1. Navigate to Iceberg > Catalogs
  2. Click Add New Catalog
  3. Select the Catalog type (Hadoop, Hive, JDBC, AWS Glue, REST, or Nessie)
  4. Enter a Name for the catalog
  5. Select a Warehouse — the storage location for the catalog's data files
  6. Fill in the type-specific Properties — the form pre-populates defaults for the selected type. See Catalog Type Reference for the full property list.
  7. Optionally add Notes to describe the catalog's purpose
  8. Click Create

Import Properties from Configuration Store​

If your Symphony instance has a Configuration Store with pre-configured catalog properties, you can import them instead of filling in each property manually:

  1. On the new catalog form, click Import from Configuration Store
  2. Select the configuration set to import
  3. The properties will be populated automatically
  4. Review and adjust as needed, then click Create

Configuration sets backed by an external secret store (HashiCorp Vault, AWS, Azure, GCP) keep their values in the backend rather than in Symphony. Ice Flow fetches those values when you preview or import the set. Open the detail view to inspect the resolved properties, click Refresh to re-fetch them, and Import to copy them into the catalog form. The properties column shows — for external sets because their values are read on demand.

Edit Catalog Properties​

  1. Open the catalog from Iceberg > Catalogs
  2. Click the Settings tab
  3. Modify properties, notes, or authentication settings
  4. Use Add property to add new key-value properties
  5. Click the delete icon next to a property to remove it
  6. Changes are saved when you click Save

Configure Authentication​

Catalogs support two authentication modes:

  • None (default) — no additional authentication
  • Kerberos — per-catalog Kerberos authentication for secured Hadoop/Hive clusters

To enable Kerberos, set the Authentication field to Kerberos on the catalog creation or settings page. See Configure Kerberos for the full setup guide.

Delete a Catalog​

  1. Open the catalog from Iceberg > Catalogs
  2. Click the Settings tab
  3. Click Delete Catalog

A catalog cannot be deleted if it has active monitors or replications. Stop and remove those first, then retry.

View Catalog Activity​

Each catalog has three tabs that show related activity:

Content Tab​

Browse the catalog's namespaces and tables. See Browse Catalog Content for details.

Monitoring Tab​

Shows which monitors are observing this catalog and their current status (Monitoring, Stopped, or Enforced).

Replication Tab​

Shows which replications use this catalog as a source or target, providing a consolidated view of all replication activity for the catalog.