Class ParquetReadException

java.lang.Object
java.lang.Throwable
java.lang.Exception
java.lang.RuntimeException
dev.hardwood.reader.ParquetReadException
All Implemented Interfaces:
Serializable
Direct Known Subclasses:
SchemaIncompatibleException
public class ParquetReadException extends RuntimeException

Thrown when a file's own bytes are wrong: the read succeeded and what it returned does not say something a Parquet file can say.

A bad magic number, a footer that will not parse, a dictionary page the metadata places outside its column chunk, a page whose checksum fails, values that do not decode under the encoding the file declares for them.

Trying again will not help. That is what separates this from IOException, which the reader raises when reading the file failed — a disk error, an S3 failure after its own retries have run out — and where a second attempt may well succeed. A caller deciding whether to retry can decide on the type alone.

Distinct again from UnsupportedOperationException, which the reader raises for a file that is entirely correct and that this library cannot read: Parquet Modular Encryption, an encoding not implemented, a compression codec whose library is absent. Retrying will not help there either, but the remedy is a dependency or a different tool rather than a different file.

Unchecked, because there is nothing for a caller to do at the point of failure.

See Also:

  • Constructor Details

    • ParquetReadException

      public ParquetReadException(String message)

    • ParquetReadException

      public ParquetReadException(String message, Throwable cause)