Class AvroFormat

  • All Implemented Interfaces:
    DataFormat

    public class AvroFormat
    extends Object
    implements DataFormat
    Describes the format of a file using Apache Avro format. It is not typically necessary to construct one of these objects directly. Instead, use ReadAvro or WriteAvro to access data stored in Avro format.
    • Constructor Detail

      • AvroFormat

        public AvroFormat​(org.apache.avro.Schema schema)
      • AvroFormat

        public AvroFormat​(org.apache.avro.Schema schema,
                          Compression codec)
    • Method Detail

      • getType

        public RecordTokenType getType()
        Description copied from interface: DataFormat
        Gets the record type associated with the format. Records produced by the associated parser or consumed by the associated formatter will be of this type.

        For many formats, this may be derived from a schema object describing the format layout.

        Specified by:
        getType in interface DataFormat
        Returns:
        the format's record type
      • getMetadata

        public FileMetadata getMetadata()
        Description copied from interface: DataFormat
        Gets the metadata associated with the format. Records produces by the associated parser or consumed by the associated formatter will use this metadata.
        Specified by:
        getMetadata in interface DataFormat
        Returns:
        the format's metadata
      • readMetadata

        public FileMetadata readMetadata​(FileClient fileClient,
                                         ByteSource source)
        Description copied from interface: DataFormat
        Reads the metadata associated with the format.
        Specified by:
        readMetadata in interface DataFormat
        Parameters:
        fileClient - client used to read file
        source - location of the files
      • writeMetadata

        public void writeMetadata​(FileMetadata metadata,
                                  FileClient fileClient,
                                  ByteSink target)
        Description copied from interface: DataFormat
        Writes the provided metadata associated with the format.
        Specified by:
        writeMetadata in interface DataFormat
        Parameters:
        metadata - the metadata to write
        fileClient - client used to write file
      • isSplittable

        public boolean isSplittable()
        Description copied from interface: DataFormat
        Indicates if the format supports parsing of subsections of a file.

        A format should only return true if it can, at least in some situations, support this sort of parsing. If a format requires reading the entire file, it must return false.

        If a format is not splittable, a file in the format cannot be parsed in parallel; however, individual files can still be parsed independently in parallel, as when reading the contents of a directory or using a file globbing pattern.

        Specified by:
        isSplittable in interface DataFormat
        Returns:
        true if the format supports parsing only a portion of the file, false otherwise
      • createParser

        public DataFormat.DataParser createParser​(ParsingOptions options)
        Description copied from interface: DataFormat
        Create a new parser for the format using the specified parsing options.
        Specified by:
        createParser in interface DataFormat
        Parameters:
        options - parsing options to use
        Returns:
        a new parser for reading external data
      • createWriter

        public DataFormat.DataFormatter createWriter​(FormattingOptions options)
        Description copied from interface: DataFormat
        Create a new writer for the format using the specified formatting options.
        Specified by:
        createWriter in interface DataFormat
        Parameters:
        options - formatting options to use
        Returns:
        a new formatter for writing external data