Package org.elasticsearch.xpack.esql.datasources.spi

Interface FileList

public interface FileList
Indexed view over a resolved set of files from an external data source. Implementations are package-private within the datasources.glob package; consumers should depend only on this interface.

Two sentinel instances encode distinct states:

  • UNRESOLVED — glob not yet expanded (isResolved() == false, isEmpty() == false)
  • EMPTY — glob expanded but matched zero files (isResolved() == true, isEmpty() == true)

  • Field Details

    • UNRESOLVED

      static final FileList UNRESOLVED
      Sentinel: single-file path, glob not yet applied (isResolved() == false).

    • EMPTY

      static final FileList EMPTY
      Sentinel: glob expanded but matched zero files (isResolved() == true, isEmpty() == true).

  • Method Details

    • fileCount

      int fileCount()

    • path

      StoragePath path(int i)

    • size

      long size(int i)

    • lastModifiedMillis

      long lastModifiedMillis(int i)

    • originalPattern

      @Nullable String originalPattern()

    • partitionMetadata

      @Nullable PartitionMetadata partitionMetadata()

    • isResolved

      boolean isResolved()

    • isEmpty

      boolean isEmpty()

    • estimatedBytes

      long estimatedBytes()

    • fileSchemaInfo

      @Nullable default Map<StoragePath,SchemaReconciliation.FileSchemaInfo> fileSchemaInfo()
      Per-file schema info from schema reconciliation, or null when reconciliation was not performed (e.g. first-file-wins mode or compact file lists).