Package org.apache.polaris.extension.metrics.jdbc

Class MetricsRecordConverter

java.lang.Object

org.apache.polaris.extension.metrics.jdbc.MetricsRecordConverter

public final class MetricsRecordConverter
extends Object

Converts Iceberg metrics reports to SPI record types using a fluent builder API.

This converter extracts all relevant metrics from Iceberg's ScanReport and CommitReport and combines them with context information to create persistence-ready records.

Example usage:

 ScanMetricsRecord record = MetricsRecordConverter.forScanReport(scanReport)
     .catalogId(catalog.getId())
     .tableId(tableEntity.getId())
     .build();
 

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final class	MetricsRecordConverter.CommitReportBuilder	Builder for converting CommitReport to CommitMetricsRecord.
static final class	MetricsRecordConverter.ScanReportBuilder	Builder for converting ScanReport to ScanMetricsRecord.

Field Summary

Fields

Modifier and Type	Field	Description
static final String	REPORT_TRACE_ID_KEY	Well-known metadata key for client-provided report trace ID.

Method Summary

Modifier and Type	Method	Description
static MetricsRecordConverter.CommitReportBuilder	forCommitReport(org.apache.iceberg.metrics.CommitReport commitReport)	Creates a builder for converting a CommitReport to a CommitMetricsRecord.
static MetricsRecordConverter.ScanReportBuilder	forScanReport(org.apache.iceberg.metrics.ScanReport scanReport)	Creates a builder for converting a ScanReport to a ScanMetricsRecord.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

REPORT_TRACE_ID_KEY

public static final String REPORT_TRACE_ID_KEY

Well-known metadata key for client-provided report trace ID.

See Also:

• Constant Field Values

Method Details

forScanReport

public static MetricsRecordConverter.ScanReportBuilder forScanReport(org.apache.iceberg.metrics.ScanReport scanReport)

Creates a builder for converting a ScanReport to a ScanMetricsRecord.

Parameters:

scanReport - the Iceberg scan report

Returns:

builder for configuring the conversion

forCommitReport

public static MetricsRecordConverter.CommitReportBuilder forCommitReport(org.apache.iceberg.metrics.CommitReport commitReport)

Creates a builder for converting a CommitReport to a CommitMetricsRecord.

Parameters:

commitReport - the Iceberg commit report

Returns:

builder for configuring the conversion