package table

Import Path
	github.com/polarsignals/iceberg-go/table (on go.dev)

Dependency Relation
	imports 24 packages, and imported by 2 packages

Involved Source Files

	    hdfs.go
	    maintenance.go
	    metadata.go
	    metadata_builder.go
	    refs.go
	    snapshots.go
	    sorting.go
	    table.go
	    writer.go
Package-Level Type Names (total 20)

	/* sort by: alphabet | popularity */
	 type Identifier = ([])
	 type Metadata (interface)
		Metadata for an iceberg table as specified in the Iceberg spec
		
		https://iceberg.apache.org/spec/#iceberg-table-spec

		Methods (total 24)
			( Metadata) CurrentSchema() *iceberg.Schema
				CurrentSchema returns the table's current schema.

			( Metadata) CurrentSnapshot() *Snapshot
				CurrentSnapshot returns the table's current snapshot.

			( Metadata) DefaultPartitionSpec() int
				DefaultPartitionSpec is the ID of the current spec that writers should
				use by default.

			( Metadata) GetMetadataLog() []MetadataLogEntry
				GetMetadataLog is a list of metadata log entries. This is used to track

			( Metadata) GetSnapshotLog() []SnapshotLogEntry
				GetSnapshotLog is a list of snapshot log entries. This is used to track

			( Metadata) LastColumnID() int
				LastColumnID returns the highest assigned column ID for the table.
				This is used to ensure fields are always assigned an unused ID when
				evolving schemas.

			( Metadata) LastPartitionSpecID() *int
				LastPartitionSpecID is the highest assigned partition field ID across
				all partition specs for the table. This is used to ensure partition
				fields are always assigned an unused ID when evolving specs.

			( Metadata) LastUpdatedMillis() int64
				LastUpdatedMillis is the timestamp in milliseconds from the unix epoch when
				the table was last updated. Each table metadata file should update this
				field just before writing.

			( Metadata) Location() string
				Location is the table's base location. This is used by writers to determine
				where to store data files, manifest files, and table metadata files.

			( Metadata) PartitionSpec() iceberg.PartitionSpec
				PartitionSpec returns the current partition spec that the table is using.

			( Metadata) PartitionSpecs() []iceberg.PartitionSpec
				PartitionSpecs returns the list of all partition specs in the table.

			( Metadata) Properties() iceberg.Properties
				Properties is a string to string map of table properties. This is used
				to control settings that affect reading and writing and is not intended
				to be used for arbitrary metadata. For example, commit.retry.num-retries
				is used to control the number of commit retries.

			( Metadata) SchemaID() int
				SchemaID returns the ID of the current schema.

			( Metadata) Schemas() []*iceberg.Schema
				Schemas returns the list of schemas, stored as objects with their
				schema-id.

			( Metadata) SnapshotByID(int64) *Snapshot
				SnapshotByID find and return a specific snapshot by its ID. Returns
				nil if the ID is not found in the list of snapshots.

			( Metadata) SnapshotByName(name string) *Snapshot
				SnapshotByName searches the list of snapshots for a snapshot with a given
				ref name. Returns nil if there's no ref with this name for a snapshot.

			( Metadata) SnapshotID() *int64
				SnapshotID returns the ID of the current snapshot.

			( Metadata) SnapshotRefs() map[string]SnapshotRef
				SnapshotRefs is a map of snapshot ref names to snapshot refs. This is used to

			( Metadata) Snapshots() []Snapshot
				Snapshots returns the list of valid snapshots. Valid snapshots are
				snapshots for which all data files exist in the file system. A data
				file must not be deleted from the file system until the last snapshot
				in which it was listed is garbage collected.

			( Metadata) SortOrder() SortOrder
				SortOrder returns the table's current sort order, ie: the one with the
				ID that matches the default-sort-order-id.

			( Metadata) SortOrderID() int
				SortOrderID returns the ID of the current sort order.

			( Metadata) SortOrders() []SortOrder
				SortOrders returns the list of sort orders in the table.

			( Metadata) TableUUID() uuid.UUID
				TableUUID returns a UUID that identifies the table, generated when the
				table is created. Implementations must throw an exception if a table's
				UUID does not match the expected UUID after refreshing metadata.

			( Metadata) Version() int
				Version indicates the version of this metadata, 1 for V1, 2 for V2, etc.

		Implemented By (at least 3)
			*MetadataV1
			 MetadataV1Builder
			*MetadataV2
		As Outputs Of (at least 5)
			func ParseMetadata(r io.Reader) (Metadata, error)
			func ParseMetadataBytes(b []byte) (Metadata, error)
			func ParseMetadataString(s string) (Metadata, error)
			func (*MetadataV1Builder).Build() Metadata
			func Table.Metadata() Metadata
		As Inputs Of (at least 3)
			func CloneMetadataV1(m Metadata) *MetadataV1Builder
			func New(ident Identifier, meta Metadata, location string, bucket objstore.Bucket) Table
			func NewHDFSTable(ver int, ident Identifier, meta Metadata, location string, bucket objstore.Bucket) Table

	 type MetadataLogEntry (struct)

		Fields (total 2)
			MetadataFile string
			TimestampMs int64
		As Outputs Of (at least one exported)
			func Metadata.GetMetadataLog() []MetadataLogEntry
		As Inputs Of (at least one exported)
			func (*MetadataV1Builder).WithMetadataLog(metadataLog []MetadataLogEntry) *MetadataV1Builder

	 type MetadataV1 (struct)

		Fields (total 20)
			commonMetadata.CurrentSchemaID int
			commonMetadata.CurrentSnapshotID *int64
			commonMetadata.DefaultSortOrderID int
			commonMetadata.DefaultSpecID int
			commonMetadata.FormatVersion int
			commonMetadata.LastColumnId int
			commonMetadata.LastPartitionID *int
			commonMetadata.LastUpdatedMS int64
			commonMetadata.Loc string
			commonMetadata.MetadataLog []MetadataLogEntry
			commonMetadata.Props iceberg.Properties
			commonMetadata.Refs map[string]SnapshotRef
			commonMetadata.SchemaList []*iceberg.Schema
			commonMetadata.SnapshotList []Snapshot
			commonMetadata.SnapshotLog []SnapshotLogEntry
			commonMetadata.SortOrderList []SortOrder
			commonMetadata.Specs []iceberg.PartitionSpec
			commonMetadata.UUID uuid.UUID
			Partition []iceberg.PartitionField
			Schema *iceberg.Schema
		Methods (total 26)
			(*MetadataV1) CurrentSchema() *iceberg.Schema
			(*MetadataV1) CurrentSnapshot() *Snapshot
			(*MetadataV1) DefaultPartitionSpec() int
			(*MetadataV1) GetMetadataLog() []MetadataLogEntry
			(*MetadataV1) GetSnapshotLog() []SnapshotLogEntry
			(*MetadataV1) LastColumnID() int
			(*MetadataV1) LastPartitionSpecID() *int
			(*MetadataV1) LastUpdatedMillis() int64
			(*MetadataV1) Location() string
			(*MetadataV1) PartitionSpec() iceberg.PartitionSpec
			(*MetadataV1) PartitionSpecs() []iceberg.PartitionSpec
			(*MetadataV1) Properties() iceberg.Properties
			(*MetadataV1) SchemaID() int
			(*MetadataV1) Schemas() []*iceberg.Schema
			(*MetadataV1) SnapshotByID(id int64) *Snapshot
			(*MetadataV1) SnapshotByName(name string) *Snapshot
			(*MetadataV1) SnapshotID() *int64
			(*MetadataV1) SnapshotRefs() map[string]SnapshotRef
			(*MetadataV1) Snapshots() []Snapshot
			(*MetadataV1) SortOrder() SortOrder
			(*MetadataV1) SortOrderID() int
			(*MetadataV1) SortOrders() []SortOrder
			(*MetadataV1) TableUUID() uuid.UUID
			(*MetadataV1) ToV2() MetadataV2
			(*MetadataV1) UnmarshalJSON(b []byte) error
			(*MetadataV1) Version() int
		Implements (at least 3)
			*MetadataV1 : Metadata
			*MetadataV1 : github.com/goccy/go-json.Unmarshaler
			*MetadataV1 : encoding/json.Unmarshaler

	 type MetadataV1Builder (struct)

		Fields (total 21)
			MetadataV1 *MetadataV1
			MetadataV1.commonMetadata.CurrentSchemaID int
			MetadataV1.commonMetadata.CurrentSnapshotID *int64
			MetadataV1.commonMetadata.DefaultSortOrderID int
			MetadataV1.commonMetadata.DefaultSpecID int
			MetadataV1.commonMetadata.FormatVersion int
			MetadataV1.commonMetadata.LastColumnId int
			MetadataV1.commonMetadata.LastPartitionID *int
			MetadataV1.commonMetadata.LastUpdatedMS int64
			MetadataV1.commonMetadata.Loc string
			MetadataV1.commonMetadata.MetadataLog []MetadataLogEntry
			MetadataV1.commonMetadata.Props iceberg.Properties
			MetadataV1.commonMetadata.Refs map[string]SnapshotRef
			MetadataV1.commonMetadata.SchemaList []*iceberg.Schema
			MetadataV1.commonMetadata.SnapshotList []Snapshot
			MetadataV1.commonMetadata.SnapshotLog []SnapshotLogEntry
			MetadataV1.commonMetadata.SortOrderList []SortOrder
			MetadataV1.commonMetadata.Specs []iceberg.PartitionSpec
			MetadataV1.commonMetadata.UUID uuid.UUID
			MetadataV1.Partition []iceberg.PartitionField
			MetadataV1.Schema *iceberg.Schema
		Methods (total 44)
			(*MetadataV1Builder) Build() Metadata
			( MetadataV1Builder) CurrentSchema() *iceberg.Schema
			( MetadataV1Builder) CurrentSnapshot() *Snapshot
			( MetadataV1Builder) DefaultPartitionSpec() int
			( MetadataV1Builder) GetMetadataLog() []MetadataLogEntry
			( MetadataV1Builder) GetSnapshotLog() []SnapshotLogEntry
			( MetadataV1Builder) LastColumnID() int
			( MetadataV1Builder) LastPartitionSpecID() *int
			( MetadataV1Builder) LastUpdatedMillis() int64
			( MetadataV1Builder) Location() string
			( MetadataV1Builder) PartitionSpec() iceberg.PartitionSpec
			( MetadataV1Builder) PartitionSpecs() []iceberg.PartitionSpec
			( MetadataV1Builder) Properties() iceberg.Properties
			( MetadataV1Builder) SchemaID() int
			( MetadataV1Builder) Schemas() []*iceberg.Schema
			( MetadataV1Builder) SnapshotByID(id int64) *Snapshot
			( MetadataV1Builder) SnapshotByName(name string) *Snapshot
			( MetadataV1Builder) SnapshotID() *int64
			( MetadataV1Builder) SnapshotRefs() map[string]SnapshotRef
			( MetadataV1Builder) Snapshots() []Snapshot
			( MetadataV1Builder) SortOrder() SortOrder
			( MetadataV1Builder) SortOrderID() int
			( MetadataV1Builder) SortOrders() []SortOrder
			( MetadataV1Builder) TableUUID() uuid.UUID
			( MetadataV1Builder) ToV2() MetadataV2
			( MetadataV1Builder) UnmarshalJSON(b []byte) error
			( MetadataV1Builder) Version() int
			(*MetadataV1Builder) WithCurrentSchemaID(currentSchemaID int) *MetadataV1Builder
				WithCurrentSchemaID sets the optional current-schema-id field of the metadata.

			(*MetadataV1Builder) WithCurrentSnapshotID(currentSnapshotID int64) *MetadataV1Builder
				WithCurrentSnapshotID sets the optional current-snapshot-id field of the metadata.

			(*MetadataV1Builder) WithDefaultSortOrderID(defaultSortOrderID int) *MetadataV1Builder
				WithDefaultSortOrderID sets the optional default-sort-order-id field of the metadata.

			(*MetadataV1Builder) WithDefaultSpecID(defaultSpecID int) *MetadataV1Builder
				WithDefaultSpecID sets the optional default-spec-id field of the metadata.

			(*MetadataV1Builder) WithFormatVersion(version int) *MetadataV1Builder
			(*MetadataV1Builder) WithLastPartitionID(lastPartitionID int) *MetadataV1Builder
				WithLastPartitionID sets the optional last-partition-id field of the metadata.

			(*MetadataV1Builder) WithLastUpdatedMs(lastUpdatedMs int64) *MetadataV1Builder
			(*MetadataV1Builder) WithLocation(location string) *MetadataV1Builder
			(*MetadataV1Builder) WithMetadataLog(metadataLog []MetadataLogEntry) *MetadataV1Builder
				WithMetadataLog sets the optional metadata-log field of the metadata.

			(*MetadataV1Builder) WithPartitionSpecs(specs []iceberg.PartitionSpec) *MetadataV1Builder
				WithProperties sets the optional partition-specs field of the metadata.

			(*MetadataV1Builder) WithProperties(properties iceberg.Properties) *MetadataV1Builder
				WithProperties sets the optional properties field of the metadata.

			(*MetadataV1Builder) WithSchema(schema *iceberg.Schema) *MetadataV1Builder
			(*MetadataV1Builder) WithSchemas(schemas []*iceberg.Schema) *MetadataV1Builder
				WithSchemas sets the optional schemas field of the metadata.

			(*MetadataV1Builder) WithSnapshotLog(snapshotLog []SnapshotLogEntry) *MetadataV1Builder
				WithSnapshotLog sets the optional snapshot-log field of the metadata.

			(*MetadataV1Builder) WithSnapshots(snapshots []Snapshot) *MetadataV1Builder
				WithSnapshots sets the optional snapshots field of the metadata.

			(*MetadataV1Builder) WithSortOrders(sortOrders []SortOrder) *MetadataV1Builder
				WithSortOrders sets the optional sort-orders field of the metadata.

			(*MetadataV1Builder) WithTableUUID(id uuid.UUID) *MetadataV1Builder
				WithTableUUID sets the optional table-uuid field of the metadata.

		Implements (at least 3)
			 MetadataV1Builder : Metadata
			 MetadataV1Builder : github.com/goccy/go-json.Unmarshaler
			 MetadataV1Builder : encoding/json.Unmarshaler
		As Outputs Of (at least 19)
			func CloneMetadataV1(m Metadata) *MetadataV1Builder
			func NewMetadataV1Builder(location string, schema *iceberg.Schema, lastUpdatesMs int64, lastColumnId int) *MetadataV1Builder
			func (*MetadataV1Builder).WithCurrentSchemaID(currentSchemaID int) *MetadataV1Builder
			func (*MetadataV1Builder).WithCurrentSnapshotID(currentSnapshotID int64) *MetadataV1Builder
			func (*MetadataV1Builder).WithDefaultSortOrderID(defaultSortOrderID int) *MetadataV1Builder
			func (*MetadataV1Builder).WithDefaultSpecID(defaultSpecID int) *MetadataV1Builder
			func (*MetadataV1Builder).WithFormatVersion(version int) *MetadataV1Builder
			func (*MetadataV1Builder).WithLastPartitionID(lastPartitionID int) *MetadataV1Builder
			func (*MetadataV1Builder).WithLastUpdatedMs(lastUpdatedMs int64) *MetadataV1Builder
			func (*MetadataV1Builder).WithLocation(location string) *MetadataV1Builder
			func (*MetadataV1Builder).WithMetadataLog(metadataLog []MetadataLogEntry) *MetadataV1Builder
			func (*MetadataV1Builder).WithPartitionSpecs(specs []iceberg.PartitionSpec) *MetadataV1Builder
			func (*MetadataV1Builder).WithProperties(properties iceberg.Properties) *MetadataV1Builder
			func (*MetadataV1Builder).WithSchema(schema *iceberg.Schema) *MetadataV1Builder
			func (*MetadataV1Builder).WithSchemas(schemas []*iceberg.Schema) *MetadataV1Builder
			func (*MetadataV1Builder).WithSnapshotLog(snapshotLog []SnapshotLogEntry) *MetadataV1Builder
			func (*MetadataV1Builder).WithSnapshots(snapshots []Snapshot) *MetadataV1Builder
			func (*MetadataV1Builder).WithSortOrders(sortOrders []SortOrder) *MetadataV1Builder
			func (*MetadataV1Builder).WithTableUUID(id uuid.UUID) *MetadataV1Builder

	 type MetadataV2 (struct)

		Fields (total 19)
			commonMetadata.CurrentSchemaID int
			commonMetadata.CurrentSnapshotID *int64
			commonMetadata.DefaultSortOrderID int
			commonMetadata.DefaultSpecID int
			commonMetadata.FormatVersion int
			commonMetadata.LastColumnId int
			commonMetadata.LastPartitionID *int
			commonMetadata.LastUpdatedMS int64
			commonMetadata.Loc string
			commonMetadata.MetadataLog []MetadataLogEntry
			commonMetadata.Props iceberg.Properties
			commonMetadata.Refs map[string]SnapshotRef
			commonMetadata.SchemaList []*iceberg.Schema
			commonMetadata.SnapshotList []Snapshot
			commonMetadata.SnapshotLog []SnapshotLogEntry
			commonMetadata.SortOrderList []SortOrder
			commonMetadata.Specs []iceberg.PartitionSpec
			commonMetadata.UUID uuid.UUID
			LastSequenceNumber int
		Methods (total 25)
			(*MetadataV2) CurrentSchema() *iceberg.Schema
			(*MetadataV2) CurrentSnapshot() *Snapshot
			(*MetadataV2) DefaultPartitionSpec() int
			(*MetadataV2) GetMetadataLog() []MetadataLogEntry
			(*MetadataV2) GetSnapshotLog() []SnapshotLogEntry
			(*MetadataV2) LastColumnID() int
			(*MetadataV2) LastPartitionSpecID() *int
			(*MetadataV2) LastUpdatedMillis() int64
			(*MetadataV2) Location() string
			(*MetadataV2) PartitionSpec() iceberg.PartitionSpec
			(*MetadataV2) PartitionSpecs() []iceberg.PartitionSpec
			(*MetadataV2) Properties() iceberg.Properties
			(*MetadataV2) SchemaID() int
			(*MetadataV2) Schemas() []*iceberg.Schema
			(*MetadataV2) SnapshotByID(id int64) *Snapshot
			(*MetadataV2) SnapshotByName(name string) *Snapshot
			(*MetadataV2) SnapshotID() *int64
			(*MetadataV2) SnapshotRefs() map[string]SnapshotRef
			(*MetadataV2) Snapshots() []Snapshot
			(*MetadataV2) SortOrder() SortOrder
			(*MetadataV2) SortOrderID() int
			(*MetadataV2) SortOrders() []SortOrder
			(*MetadataV2) TableUUID() uuid.UUID
			(*MetadataV2) UnmarshalJSON(b []byte) error
			(*MetadataV2) Version() int
		Implements (at least 3)
			*MetadataV2 : Metadata
			*MetadataV2 : github.com/goccy/go-json.Unmarshaler
			*MetadataV2 : encoding/json.Unmarshaler
		As Outputs Of (at least one exported)
			func (*MetadataV1).ToV2() MetadataV2

	 type NullOrder string (basic type)

		As Types Of (total 2)
			const NullsFirst
			const NullsLast

	 type Operation string (basic type)

		As Outputs Of (at least one exported)
			func ValidOperation(s string) (Operation, error)
		As Types Of (total 4)
			const OpAppend
			const OpDelete
			const OpOverwrite
			const OpReplace

	 type ReadOnlyTable (struct)

		Methods (total 15)
			( ReadOnlyTable) Bucket() objstore.Bucket
			( ReadOnlyTable) CurrentSnapshot() *Snapshot
			( ReadOnlyTable) Equals(other Table) bool
			( ReadOnlyTable) Identifier() Identifier
			( ReadOnlyTable) Location() string
			( ReadOnlyTable) Metadata() Metadata
			( ReadOnlyTable) MetadataLocation() string
			( ReadOnlyTable) Properties() iceberg.Properties
			( ReadOnlyTable) Schema() *iceberg.Schema
			( ReadOnlyTable) Schemas() map[int]*iceberg.Schema
			( ReadOnlyTable) SnapshotByID(id int64) *Snapshot
			( ReadOnlyTable) SnapshotByName(name string) *Snapshot
			(*ReadOnlyTable) SnapshotWriter(options ...WriterOption) (SnapshotWriter, error)
			( ReadOnlyTable) SortOrder() SortOrder
			( ReadOnlyTable) Spec() iceberg.PartitionSpec
		Implements (at least one exported)
			*ReadOnlyTable : Table

	 type RefType string (basic type)
		RefType will be either a BranchRef or a TagRef

		As Types Of (total 2)
			const BranchRef
			const TagRef

	 type Snapshot (struct)

		Fields (total 7)
			ManifestList string
			ParentSnapshotID *int64
			SchemaID *int
			SequenceNumber int64
			SnapshotID int64
			Summary *Summary
			TimestampMs int64
		Methods (total 3)
			( Snapshot) Equals(other Snapshot) bool
			( Snapshot) Manifests(bucket objstore.Bucket) ([]iceberg.ManifestFile, error)
			( Snapshot) String() string
		Implements (at least 2)
			 Snapshot : expvar.Var
			 Snapshot : fmt.Stringer
		As Outputs Of (at least 7)
			func Metadata.CurrentSnapshot() *Snapshot
			func Metadata.SnapshotByID(int64) *Snapshot
			func Metadata.SnapshotByName(name string) *Snapshot
			func Metadata.Snapshots() []Snapshot
			func Table.CurrentSnapshot() *Snapshot
			func Table.SnapshotByID(id int64) *Snapshot
			func Table.SnapshotByName(name string) *Snapshot
		As Inputs Of (at least 2)
			func (*MetadataV1Builder).WithSnapshots(snapshots []Snapshot) *MetadataV1Builder
			func Snapshot.Equals(other Snapshot) bool

	 type SnapshotLogEntry (struct)

		Fields (total 2)
			SnapshotID int64
			TimestampMs int64
		As Outputs Of (at least one exported)
			func Metadata.GetSnapshotLog() []SnapshotLogEntry
		As Inputs Of (at least one exported)
			func (*MetadataV1Builder).WithSnapshotLog(snapshotLog []SnapshotLogEntry) *MetadataV1Builder

	 type SnapshotRef (struct)
		SnapshotRef represents the reference information for a specific snapshot

		Fields (total 5)
			MaxRefAgeMs *int64
			MaxSnapshotAgeMs *int64
			MinSnapshotsToKeep *int
			SnapshotID int64
			SnapshotRefType RefType
		Methods (only one)
			(*SnapshotRef) UnmarshalJSON(b []byte) error
		Implements (at least 2)
			*SnapshotRef : github.com/goccy/go-json.Unmarshaler
			*SnapshotRef : encoding/json.Unmarshaler
		As Outputs Of (at least one exported)
			func Metadata.SnapshotRefs() map[string]SnapshotRef

	 type SnapshotWriter (interface)
		SnapshotWriter is an interface for writing a new snapshot to a table.

		Methods (total 3)
			( SnapshotWriter) Append(ctx context.Context, r io.Reader) error
				Append accepts a ReaderAt object that should read the Parquet file that is to be added to the snapshot.

			( SnapshotWriter) Close(ctx context.Context) error
				Close writes the new snapshot to the table and closes the writer. It is an error to call Append after Close.

			( SnapshotWriter) DeleteDataFile(ctx context.Context, del func(file iceberg.DataFile) bool) error
				DeleteDataFile deletes a data file from the table. The function passed to this method should return true if the file should be deleted.

		Implements (at least 2)
			 SnapshotWriter : github.com/tetratelabs/wazero.CompilationCache
			 SnapshotWriter : github.com/tetratelabs/wazero/api.Closer
		As Outputs Of (at least 2)
			func (*ReadOnlyTable).SnapshotWriter(options ...WriterOption) (SnapshotWriter, error)
			func Table.SnapshotWriter(options ...WriterOption) (SnapshotWriter, error)

	 type SortDirection string (basic type)

		As Types Of (total 2)
			const SortASC
			const SortDESC

	 type SortField (struct)
		SortField describes a field used in a sort order definition.

		Fields (total 4)
			Direction SortDirection
				Direction is an enum indicating ascending or descending direction.

			NullOrder NullOrder
				NullOrder describes the order of null values when sorting
				should be only either nulls-first or nulls-last enum values.

			SourceID int
				SourceID is the source column id from the table's schema

			Transform iceberg.Transform
				Transform is the tranformation used to produce values to be
				sorted on from the source column.

		Methods (total 3)
			(*SortField) MarshalJSON() ([]byte, error)
			(*SortField) String() string
			(*SortField) UnmarshalJSON(b []byte) error
		Implements (at least 6)
			*SortField : github.com/goccy/go-json.Marshaler
			*SortField : github.com/goccy/go-json.Unmarshaler
			*SortField : encoding/json.Marshaler
			*SortField : encoding/json.Unmarshaler
			*SortField : expvar.Var
			*SortField : fmt.Stringer

	 type SortOrder (struct)
		SortOrder describes how the data is sorted within the table.
		
		Data can be sorted within partitions by columns to gain performance. The
		order of the sort fields within the list defines the order in which the
		sort is applied to the data.

		Fields (total 2)
			Fields []SortField
			OrderID int
		Methods (total 2)
			( SortOrder) String() string
			(*SortOrder) UnmarshalJSON(b []byte) error
		Implements (at least 4)
			*SortOrder : github.com/goccy/go-json.Unmarshaler
			*SortOrder : encoding/json.Unmarshaler
			 SortOrder : expvar.Var
			 SortOrder : fmt.Stringer
		As Outputs Of (at least 3)
			func Metadata.SortOrder() SortOrder
			func Metadata.SortOrders() []SortOrder
			func Table.SortOrder() SortOrder
		As Inputs Of (at least one exported)
			func (*MetadataV1Builder).WithSortOrders(sortOrders []SortOrder) *MetadataV1Builder
		As Types Of (only one)
			  var UnsortedSortOrder

	 type Summary (struct)
		Summary stores the summary information for a snapshot indicating
		the operation that created the snapshot, and various properties
		which might exist in the summary.

		Fields (total 2)
			Operation Operation
			Properties map[string]string
		Methods (total 4)
			(*Summary) Equals(other *Summary) bool
			(*Summary) MarshalJSON() ([]byte, error)
			(*Summary) String() string
			(*Summary) UnmarshalJSON(b []byte) (err error)
		Implements (at least 6)
			*Summary : github.com/goccy/go-json.Marshaler
			*Summary : github.com/goccy/go-json.Unmarshaler
			*Summary : encoding/json.Marshaler
			*Summary : encoding/json.Unmarshaler
			*Summary : expvar.Var
			*Summary : fmt.Stringer
		As Inputs Of (at least one exported)
			func (*Summary).Equals(other *Summary) bool

	 type Table (interface)

		Methods (total 15)
			( Table) Bucket() objstore.Bucket
			( Table) CurrentSnapshot() *Snapshot
			( Table) Equals(other Table) bool
			( Table) Identifier() Identifier
			( Table) Location() string
			( Table) Metadata() Metadata
			( Table) MetadataLocation() string
			( Table) Properties() iceberg.Properties
			( Table) Schema() *iceberg.Schema
			( Table) Schemas() map[int]*iceberg.Schema
			( Table) SnapshotByID(id int64) *Snapshot
			( Table) SnapshotByName(name string) *Snapshot
			( Table) SnapshotWriter(options ...WriterOption) (SnapshotWriter, error)
			( Table) SortOrder() SortOrder
			( Table) Spec() iceberg.PartitionSpec
		Implemented By (at least one exported)
			*ReadOnlyTable
		As Outputs Of (at least 6)
			func New(ident Identifier, meta Metadata, location string, bucket objstore.Bucket) Table
			func NewFromLocation(ident Identifier, metalocation string, bucket objstore.Bucket) (Table, error)
			func NewHDFSTable(ver int, ident Identifier, meta Metadata, location string, bucket objstore.Bucket) Table
			func github.com/polarsignals/iceberg-go/catalog.Catalog.CreateTable(ctx context.Context, location string, schema *iceberg.Schema, props iceberg.Properties, options ...catalog.TableOption) (Table, error)
			func github.com/polarsignals/iceberg-go/catalog.Catalog.LoadTable(ctx context.Context, identifier Identifier, props iceberg.Properties) (Table, error)
			func github.com/polarsignals/iceberg-go/catalog.Catalog.RenameTable(ctx context.Context, from, to Identifier) (Table, error)
		As Inputs Of (at least 3)
			func DeleteOrphanFiles(ctx context.Context, table Table, age time.Duration) error
			func NewSnapshotWriter(commit func(ctx context.Context, v int) error, version int, bucket objstore.Bucket, table Table, options ...WriterOption) snapshotWriter
			func Table.Equals(other Table) bool

	 type WriterOption (func)

		As Outputs Of (at least 7)
			func WithExpireSnapshotsOlderThan(d time.Duration) WriterOption
			func WithFastAppend() WriterOption
			func WithLogger(logger log.Logger) WriterOption
			func WithManifestSizeBytes(size int) WriterOption
			func WithMergeSchema() WriterOption
			func WithMetadataDeleteAfterCommit() WriterOption
			func WithMetadataPreviousVersionsMax(n int) WriterOption
		As Inputs Of (at least 3)
			func NewSnapshotWriter(commit func(ctx context.Context, v int) error, version int, bucket objstore.Bucket, table Table, options ...WriterOption) snapshotWriter
			func (*ReadOnlyTable).SnapshotWriter(options ...WriterOption) (SnapshotWriter, error)
			func Table.SnapshotWriter(options ...WriterOption) (SnapshotWriter, error)


Package-Level Functions (total 18)

	 func CloneMetadataV1(m Metadata) *MetadataV1Builder
	 func DeleteOrphanFiles(ctx context.Context, table Table, age time.Duration) error
		DeleteOrphanFiles will delete all files in the table's bucket that are not pointed to by any snapshot in the table.
		NOTE: https://iceberg.apache.org/docs/latest/maintenance/#delete-orphan-files
		"It is dangerous to remove orphan files with a retention interval shorter than the time expected for any write to complete because it might corrupt
		the table if in-progress files are considered orphaned and are deleted. The default interval is 3 days."

	 func New(ident Identifier, meta Metadata, location string, bucket objstore.Bucket) Table
	 func NewFromLocation(ident Identifier, metalocation string, bucket objstore.Bucket) (Table, error)
	 func NewHDFSTable(ver int, ident Identifier, meta Metadata, location string, bucket objstore.Bucket) Table
	 func NewMetadataV1Builder(location string, schema *iceberg.Schema, lastUpdatesMs int64, lastColumnId int) *MetadataV1Builder
		NewMetadataV1Builder returns a new MetadataV1Builder.

	 func NewSnapshotWriter(commit func(ctx context.Context, v int) error, version int, bucket objstore.Bucket, table Table, options ...WriterOption) snapshotWriter
	 func ParseMetadata(r io.Reader) (Metadata, error)
		ParseMetadata parses json metadata provided by the passed in reader,
		returning an error if one is encountered.

	 func ParseMetadataBytes(b []byte) (Metadata, error)
		ParseMetadataBytes is like [ParseMetadataString] but for a byte slice.

	 func ParseMetadataString(s string) (Metadata, error)
		ParseMetadataString is like [ParseMetadata], but for a string rather than
		an io.Reader.

	 func ValidOperation(s string) (Operation, error)
		ValidOperation ensures that a given string is one of the valid operation
		types: append,replace,overwrite,delete

	 func WithExpireSnapshotsOlderThan(d time.Duration) WriterOption
	 func WithFastAppend() WriterOption
	 func WithLogger(logger log.Logger) WriterOption
	 func WithManifestSizeBytes(size int) WriterOption
	 func WithMergeSchema() WriterOption
	 func WithMetadataDeleteAfterCommit() WriterOption
	 func WithMetadataPreviousVersionsMax(n int) WriterOption
Package-Level Variables (total 8)

	  var ErrInvalidMetadata error
	  var ErrInvalidMetadataFormatVersion error
	  var ErrInvalidNullOrder error
	  var ErrInvalidOperation error
	  var ErrInvalidRefType error
	  var ErrInvalidSortDirection error
	  var ErrMissingOperation error
	  var UnsortedSortOrder SortOrder
		A default Sort Order indicating no sort order at all


Package-Level Constants (total 13)

	const BranchRef RefType = "branch"
	const InitialSortOrderID = 1
	const MainBranch = "main"
	const NullsFirst NullOrder = "nulls-first"
	const NullsLast NullOrder = "nulls-last"
	const OpAppend Operation = "append"
	const OpDelete Operation = "delete"
	const OpOverwrite Operation = "overwrite"
	const OpReplace Operation = "replace"
	const SortASC SortDirection = "asc"
	const SortDESC SortDirection = "desc"
	const TagRef RefType = "tag"
	const UnsortedSortOrderID = 0

The pages are generated with Golds v0.8.2. (GOOS=linux GOARCH=amd64)
Golds is a Go 101 project developed by Tapir Liu.
PR and bug reports are welcome and can be submitted to the issue list.
Please follow @zigo_101 (reachable from the left QR code) to get the latest news of Golds.