Amazon S3 Advanced Settings
  • 30 May 2023
  • 2 Minutes to read
  • Dark
    Light
  • PDF

Amazon S3 Advanced Settings

  • Dark
    Light
  • PDF

Article Summary

Warning:

We do not recommend changing advanced settings unless you are an experienced Panoply user.

For users who have some experience working with their data in Panoply, there are a number of items that can be customized for this data source.

  1. Files Encoding: The following encodings are available:
    • UTF-8
    • ISO-8859-1
    • Windows-1251
    • Windows-1252
    • Windows-1254
    • Other
      When Other is selected then during the extraction the data source will detect automatically the file’s encoding. This is useful when the user does not know the file encoding or if he is selecting multiple files in multiple different encodings.
  2. Destination Schema: This is the name of the target schema to save the data. The default schema is Public. This cannot be changed once a source had been collected.
  3. Primary Key: The primary key is an id field that defines the column that contains the table's Primary Key. If this option is left blank and the sheet does not contain an ID column, Panoply will insert an id, formatted as a GUID, such as 2cd570d1-a11d-4593-9d29-9e2488f0ccc2.
Amazon S3 id columnUser Entered primary keyOutcome
yesnoPanoply will automatically select the id column and use it as the primary key.
yesyesNot recommended. Panoply will use the id column but will overwrite the original source values.
If you want Panoply to use your database table's id column, do not enter a value into the Primary Key field.
nonoPanoply creates an id column formatted as a GUID, such as 2cd570d1-a11d-4593-9d29-9e2488f0ccc2.
noyesPanoply creates a hashed id column using the primary key values entered, while retaining the source columns.

WARNING: Any user-entered primary key will be used across all the files selected.

  1. Incremental Load: An incremental load is only available when the user chooses Collect All Files. This option means that Panoply will only collect files that have been updated since the last successful collection. When selecting specific files, Panoply will collect the entire file. When an incremental key is entered, it will be applied to all files collected.

4. Delimiter: For character-delimited files like .csv or .txt, that do not use a comma or a tab for the delimiter, use the dropdown to indicate the correct delimiter to use.

5. Skip XML attributes: When collecting XML files, some of the returning XML fields might have attributes attached to them. Select this option to skip all of the XML attributes and ingest only the XML values. For example, for the data 100, Panoply will ingest the value 100 to the score column
6. Exclude: The Exclude option allows you to exclude certain data, such as names, addresses, or other personally identifiable information. Enter the column names of the data to exclude.

7. Parse String: If the data to be collected contains JSON, include the JSON text attributes to be parsed.

8. Truncate: Truncate deletes all the current data stored in the destination tables, but not the tables themselves. Afterwards Panoply will recollect all the available data for this data source.

9. Click Save Changes and then Collect.

  • The data source appears grayed out while the collection runs.
  • You may add additional data sources while this collection runs.
  • You can monitor this collection from the Jobs page or the Data Sources page.
  • After a successful collection, navigate to the Tables page to review the data results.

Was this article helpful?