Page tree

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Published by Scroll Versions from space DEV and version r089

...

Info

NOTE: During import, the

D s webapp
identifies file formats based on the extension of the filename. If no extension is provided, the
D s webapp
assumes that the submitted file is a text file of some kind. Non-text file formats, such as Avro and Parquet, require filename extensions.


Info

NOTE: Filenames that include special characters can cause problems during import or when publishing to a file-based datastore.

...

  • General:

    Code Block
    "/"
  • Seb browser: 

    Code Block
    "\"
  • Excel filenames:

    Code Block
    "#"

Native Input File Formats

D s product
rtrue
 can read and import directly these file formats:

...

  • CSV
  • JSON v1, including nested

    Info

    NOTE: Excel import is supported through file upload only.

    Tip

    Tip: You may import multiple worksheets from a single workbook at one time. See Import Excel Data in the User Guide.

  • CSV
  • JSON, including nested

    JSON files can be read natively but often require additional work to properly structure into tabular format. Depending on how the

    D s webapp
    is configured (v1 or v2), JSON files may require conversion before they are available for use in the application. See "Converted file formats" below.


    Info

    NOTE:

    D s product
    requires that JSON files be submitted with one valid JSON object per line. Consistently malformed JSON objects or objects that overlap linebreaks might cause import to fail. See Initial Parsing Steps in the User Guide

  • Plain Text
  • LOG
  • TSV
  • Parquet

    Info

    NOTE: When working with datasets sourced from Parquet files, lineage information and the $sourcerownumber reference are not supported.

...

For more information on data is handled initially, see Initial Parsing Steps in the User Guide.

Converted file formats

Files of the following type are not read into the product in their native format. Instead, these file types are converted using the Conversion Service into a file format that is natively supported, stored in the base storage layer, and then ingested for use in the product.

Info

NOTE: Compressed files that require conversion of the underlying file format are not supported for use in the product.

Converted file formats:

  • Excel (XLS/XLSX)

    Info

    NOTE: Other Excel-related formats, such as XLSM format, are not supported.


    Tip

    Tip: You may import multiple worksheets from a single workbook at one time. See Import Excel Data in the User Guide.

  • Google Sheets

    Tip

    Tip: You may import multiple sheets from a single Google Sheet at one time. See Import Google Sheets Data in the User Guide.

...

  • PDF

  • JSON v2

Notes on JSON:

There are two methods of ingesting JSON files for use in the product. 

  • JSON v2 - This newer version reads the JSON source file through the Conversion Service, which stores a restructured version of the data in tabular format on the base storage layer for quick and simple use within the application. 

    Tip

    Tip: This method is enabled by default and is recommended. For more information, see Working with JSON v2.

      

  • JSON v1 - This older version reads JSON files directly into the platform as text files. However, this method often requires additional work to restructure the data into tabular format. For more information, see Working with JSON v1.

Native Output File Formats

...

  • BigQuery Table

Compression Algorithms

When a file is imported, the 

D s webapp
 attempts to infer the compression algorithm in use based on the filename extension. For example, .gz files are assumed to be compressed with GZIP. 

Info

NOTE: Import of a compressed file whose underlying format is binary, such as Excel or PDF, requires conversion through the Conversion Service is not supported.


Read Native File Formats


 GZIPBZIPSnappyNotes
CSV SupportedSupportedSupported
JSON v2Not supportedNot supportedNot supportedA converted file format. See above.
JSON v1SupportedSupportedSupportedNot a converted file format. See above.
Avro  Supported

...

Write Native File Formats


 GZIPBZIPSnappy
CSVSupportedSupportedNot supported
JSONSupportedSupportedNot supported

...

Snappy compression formats

D s product
supports the following variants of Snappy compression format:

File extension

Format name

Notes

.sz

Framing2 format

See: https://github.com/google/snappy/blob/master/framing_format.txt 

.snappy

Hadoop-snappy format

See: https://code.google.com/p/hadoop-snappy/

Info

NOTE: Xerial's snappy-java format, which is also written with a .snappy file extension by default, is not supported.

...