Importing Data Using Immerse

OmniSci Immerse supports file upload for .csv, .tsv, and .txt files, and supports comma, tab, and pipe delimiters. Immerse also supports upload of compressed delimited files in TAR, ZIP, 7-ZIP, RAR, GZIP, BZIP2, or TGZ format.

You can import data to OmniSci Core Database using the Immerse import wizard. You can upload data from a local delimited file, or a delimited file from an S3 data source.

For methods specific to geospatial data, see also Importing Geospatial Data Using Immerse.

Note
  • If there is a potential for duplicate entries, and you prefer to avoid loading duplicate rows, see How can I avoid creating duplicate rows? on the Troubleshooting page.
  • If a source file uses a reserved word, OmniSci automatically adds an underscore at the end of the reserved word. For example, year is converted to year_.

Importing Non-Geospatial Data from a Local File

Follow these steps to import your data:

  1. Click DATA MANAGER.
  2. Click Import Data.
  3. Click Import data from a local file.
  4. Either click the plus sign (+) or drag your file(s) for upload. If you are uploading multiple files, the column names and data types must match. OmniSci supports only delimiter-separated formats such as CSV and TSV. OmniSci only accepts data in Latin-1 ASCII encoding, not Unicode or other multibyte character sets.. In addition to CSV, TSV, and TXT files, you can import compressed delimited files in TAR, ZIP, 7-ZIP, RAR, GZIP, BZIP2, or TGZ format.
  5. Choose Import Settings:
    1. Null string: If, instead using a blank for null cells in your upload document, you have substituted strings such as NULL, enter that string in the Null String field. The values are treated as null values on upload.
    2. Delimiter Type: Delimiters are detected automatically. You can choose a specific delimiter, such as a comma, tab, or pipe.
    3. Quoted String: Indicate whether your string fields are enclosed by quotes. Delimiter characters inside quotes are ignored.
    4. Replicate Table: If you are importing non-geospatial data to a distributed database with more than one node, select this checkbox to replicate the table to all nodes in the cluster. This effectively adds the PARTITIONS='REPLICATED' option to the create table statement. See Replicated Tables.
  6. Click Import Files.
  7. The Table Preview screen presents sample rows of imported data. The importer assigns a data type based on sampling, but you should examine and modify the selections as appropriate. Assign the correct data type to ensure optimal performance. If your column headers contain SQL reserved words, reserved characters (for example, year, /, or #), or spaces, the importer alters the characters to make them safe and notifies you of the changes. You can also change the column labels.
  8. Name the table, and click Save Table.

You can also import locally stored shape files in a variety of formats. See Importing Geospatial Data Using Immerse

.

Importing Data from Amazon S3

To import data from your Amazon S3 instance, you need:

  • The Region and Path for the file in your S3 bucket, or the direct URL to the file (S3 Link).
  • If importing private data, your Access Key and Secret Key for your personal IAM account in S3.

Locating the Data File S3 Region, Path, and URL

For information on opening and reviewing items in your S3 instance, see https://docs.aws.amazon.com/AmazonS3/latest/gsg/OpeningAnObject.html

In an S3 bucket, the Region is in the upper-right corner of the screen – US West (N. California) in this case:

s3-1-overview.png

Click the file you want to import. To load your S3 file to OmniSci using the steps for S3 Region | Bucket | Path, below, click Copy path to copy to your clipboard the path to your file within your S3 bucket. Alternatively, you can copy the link to your file. The Link in this example is https://s3-us-west-1.amazonaws.com/my-company-bucket/trip_data.7z.

s3-2-details.png

Obtaining Your S3 Access Key and Secret Key

To learn about creating your S3 Access Key and Secret Key, see https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html#Using_CreateAccessKey

If the data you want to copy is publicly available, you do not need to provide an Access Key and Secret Key.

You can import any file you can see using your IAM account with your Access Key and Secret Key.

Your Secret Key is created with your Access Key, and cannot be retrieved afterward. If you lose your Secret Key, you must create a new Access Key and Secret Key.

Loading Your S3 Data to OmniSci

Follow these steps to import your S3 data:

  1. Click DATA MANAGER.
  2. Click Import Data.
  3. Click Import data from Amazon S3.
  4. Choose whether to import using the S3 Region | Bucket | Path or a direct full link URL to the file (S3 Link).
    1. To import data using S3 Region | Bucket | Path:
      1. Select your Region from the pop-up menu.
      2. Enter the unique name of your S3 Bucket.
      3. Enter or paste the Path to the file stored in your S3 bucket.
    2. To import data using S3 link:
      1. Copy the Link URL from the file Overview in your S3 bucket.
      2. Paste the link in the Full Link URL field of the OmniSci Table Importer.
  5. If the data is publicly available, you can disable the Private Data checkbox. If you are importing Private Data, enter your credentials:
    1. Enable the Private Data checkbox.
    2. Enter your S3 Access Key.
    3. Enter your S3 Secret Key.
  6. Choose the appropriate Import Settings. OmniSci supports only delimiter-separated formats such as CSV and TSV.
    1. Null string: If you have substituted a string such as NULL for null values in your upload document, enter that string in the Null String field. The values are treated as null values on upload.
    2. Delimiter Type: Delimiters are detected automatically. You can choose a specific delimiter, such as a comma or pipe.
    3. Quoted String: Indicate whether your string fields are enclosed by quotes. Delimiter characters inside quotes are ignored.
  7. Click Import Files.
  8. The Table Preview screen presents sample rows of imported data. The importer assigns a data type based on sampling, but you should examine and modify the selections as appropriate. Assign the correct data type to ensure optimal performance. If your column headers contain SQL reserved words, reserved characters (for example, year, /, or #), or spaces, the importer alters the characters to make them safe and notifies you of the changes. You can also change the column labels.
  9. Name the table, and click Save Table.