xStore IceBerg Catalog

Monitor and explore Iceberg catalogs, namespaces, tables, schemas, partitions, properties, and version history from the xStore Iceberg Catalog interface.

Navigation

1. In the xObserve UI, go to xStore from the left navigation pane.
2. Select xStore > Iceberg Catalog.
3. Select the desired cluster from the cluster selector in the top-right corner.
4. Select an Iceberg catalog from the Catalogs pane.
5. Select a namespace from the Namespace drop-down list.

The list of tables available in the selected catalog and namespace is displayed.

View Iceberg Tables

• The Iceberg Catalog page displays all tables available in the selected catalog and namespace.
• You can use the Search Table Name field to search for a specific table.

The table list includes the following information:

• Table Name: Displays the Iceberg table name.
• Owner: Displays the user who created the table.
• Updated At: Displays the date and time when the table was last updated.
• Snapshots: Displays the number of snapshots available for the table.

Select a table name to view detailed metadata and version history.

View Table Details

• The Table Details page provides comprehensive information about the selected Iceberg table.
• The page displays the following sections in the order shown.

Schema

The Schema section displays the table structure and column definitions.

The schema includes the following details:

• #: Displays the column position within the table.
• Column Name: Displays the column name.
• Field Type: Displays the data type of the column.
• Required: Indicates whether the column is required or optional.
• Description: Displays the column description, if available.

Use this section to review table structure and validate column definitions.

Partitions

The Partitions section displays the partition configuration for the table.

Use this section to:

• Review partitioning strategy.
• Understand how data is organized within the table.
• Analyze partition-based optimization settings.

Properties

• The Properties section displays metadata and configuration settings associated with the table.
• The information is organized into the following categories.

Table Info

The Table Info section displays general metadata about the table.

Available properties may include:

• format-version: Displays the Iceberg table format version.
• table-id: Displays the unique table identifier.
• location: Displays the storage location of the table.
• last-updated: Displays the date and time of the most recent update.
• records: Displays the total number of records in the table.
• data-files: Displays the number of data files associated with the table.
• size-bytes: Displays the table size in bytes.

Write

• The Write section displays write-related table properties.
• Available properties may include:
  • write.format.default: Displays the default file format used for writes.
  • write.parquet.compression-codec: Displays the compression codec used for Parquet files.
  • write.distribution-mode: Displays the configured write distribution mode.

Other

The Other section displays additional table properties.

Available properties may include:

• provider: Displays the table provider.
• comment: Displays any user-defined comments associated with the table.

Use the Properties section to review table metadata, storage settings, and write configurations.

History

The History section displays the snapshot history of the selected Iceberg table.

You can use the search field to search snapshots by ID or operation.

The snapshot history includes the following information:

• Operation: Displays the operation that created the snapshot, such as append or overwrite.
• Current: Identifies the current active snapshot.
• ID: Displays the snapshot identifier.
• Timestamp: Displays the date and time when the snapshot was created.
• # Records: Displays the number of records included in the snapshot.
• Size: Displays the snapshot size.
• Data Files: Displays the number of data files associated with the snapshot.
• Partitions: Displays the number of partitions included in the snapshot.

Use this section to:

• Track table changes over time.
• Review historical versions of the table.
• Analyze data growth and update operations.
• Validate snapshot creation activities.

Best Practices

• Verify that the correct catalog and namespace are selected before reviewing table information.
• Use the search functionality to quickly locate tables in large namespaces.
• Review schema definitions before querying or modifying table data.
• Monitor table properties to understand storage format and compression settings.
• Review snapshot history regularly to track data modifications and growth patterns.
• Use partition information to understand table organization and optimize query performance.