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 r093

...

Excerpt

Through the Import Data page, you can upload datasets or select datasets from sources that are stored on connected datastores. From the Library page, click Import Data.


Image RemovedImage Added

D caption
typefigure
Import Data page

...

Info

NOTE: For file-based sources,

D s product
rtrue
expects that each row of data in the import file is terminated with a consistent newline character, including the last one in the file.

  • For single files lacking this final newline character, the final record may be dropped.

  • For multi-file imports lacking a newline in the final record of a file, this final record may be merged with the first one in the next file and then dropped in the
    d-s-photon
    running environment.



d-s-minrows

File and path limitations:

  • The colon character  ( :)  cannot appear in a filename or a file path.
  • Filenames cannot begin with special characters like dot ( .) or underscore( _).
  • Input file or table paths can have a maximum length of 1024 characters. 

Basic Workflow

1. Connect to sources

...

During import, the

D s webapp
identifies file formats based on the extension of the filename.

  • Compressed files are recognized and can be imported based on their file extensions.
  • Filenames that do not have an extension are treated as TXT files.

Upload:

D s product
rtrue
can also load files from your local file system.

Tip

Tip: You can drag and drop files from your desktop to to upload them.


Info

NOTE: You can upload a file up to 1 GB in size.


Info

NOTE: When you upload an updated version of a previously uploaded file, the new file is stored as a separate upload altogether. In your flow, you must swap out the old dataset to point to the new one.

...

When a dataset has been selected, the following fields appear on the right side of the screen. Modify as needed:

  • Dataset Name: This name appears in the interface.
  • Dataset Description: You may add an optional description that provides additional detail about the dataset. This information is visible in some areas of the interface.
Tip

Tip: Click the Eye icon to inspect the contents of the dataset prior to importing.

Tip

Tip: You can select a single dataset or multiple datasets for import.

...


Edit settings 

You can modify settings used during import for individual files. In edit any additional or optional settings for an individual dataset. Perform the following:

Steps:

  1. Click Edit Settings from the card for an individual dataset

...

Info

NOTE: In some cases, there may be discrepancies between row counts in the previewed data versus the data grid after the dataset has been imported, due to rounding in row counts performed in the preview.

Per-file encoding: By default,

D s product
applies a specified encoding type on the imported the file. In some cases, the data preview panel may contain garbled data, due to a mismatch in encodings. In the Data Preview dialog, you can select a different encoding for the file. When the correct encoding is selected, the preview displays the data as expected. 

...

D s product

...

Info

NOTE: In some cases, imported files are not properly parsed due to issues with encryption types or encryption keys in the source datastore. For more information, please contact your datastore administrator.

For a list of supported encoding types, see Supported File Encoding Types.

Detect structure: By default,

D s product
attempts to interpret the structure of your data during import. This structuring attempts to apply an initial tabular structure to the dataset.

  • Unless you have specific problems with the initial structure, you should leave the Detect structure setting enabled. Recipes created from these imported datasets automatically include the structuring as the first, hidden steps. These steps are not available for editing, although you can remove them through the Recipe panel. See Recipe Panel.
  • When detecting structure is disabled, imported datasets whose schema has not been detected are labeled, unstructured datasets. When recipes are created for these unstructured datasets, the structuring steps are added into the recipe and can be edited as needed.
  • For more information, see Initial Parsing Steps.

Remove special characters from column names: When selected, characters that are not alphanumeric or underscores are stripped, and space characters are converted to underscores.

For more information, see Sanitize Column Names.

  1. in the right panel. The dialog box is displayed. 
  2. In the dialog box, select the required options and modify the settings.

4. Import selections

Single dataset

If you have selected a single dataset for import:

Tip

Tip: If present, you can click the Add to new flow checkbox, which adds the imported datasets to an Untitled flow.

  • Click Continue. The dataset is imported. 
  • A recipe is created for it, added to a new flow, and loaded in the Transformer page for wrangling. See Transformer Page.

...


If you have selected multiple datasets for import:

...

The datasets are imported and added to a new flow.

Info

NOTE: To rename this flow, click Untitled at the top of Flow View.

...

Tip

Tip: If present, you can click the Add to new flow checkbox, which adds the imported datasets to an Untitled flow. For more information, see Flow View Page.

  • To import the selected datasets, click Continue

    • To begin transforming one of these datasets in Flow View, select it. From its context menu, select Add new recipe. Select the recipe. In the context panel on the right, select Edit Recipe. See Transformer Page.

    For more information, see Flow View Page.

  • To remove a dataset from import, click the X in the dataset card.

D s also
inCQLtrue
label((label = "dataset_ui") OR (label = "import_dataset"))