9.1 How to Import Data using ADS

The Import Data Tool allows data of different formats to be imported and inserted into databases, tables, objects and files. The following steps describe how to use the Import Data Tool.

1. Select Tools->Import Data from the Menu bar. This will prompt you to choose a server in which to import data. Navigate and select your server and click ok. This will bring up the Import dialog. It is also possible to right click within the schema browser and select Tools->Import Data to launch the Import Tool.

2. The first tab in the Import Data dialog window is the General Tab. Browse and select the file to import. Once the file is selected a sample of the file will be displayed in the bottom grid to indicate how it will form columns on import. Then, select the encoding and platform the file is formatted in. The sample columns will be refreshed as the options are changed. Select whether the file is delimited or has fixed width columns. If the file has fixed width columns, type the widths of columns separated by commas (eg: 15,25,35,60 ). While typing the column widths the sample data will not change, so make sure to click on the Fixed Width radio box to refresh. Select whether the first row in the file contains the column names to help the import tool map to the table. Last, select the quote identifier for data values. Make sure the sample data being displayed is formatted correctly before proceeding, then click next.

3. In the Format Tab, select the database, schema and table in which to import the data. To import into a new table, click on the "..." button which will open a Create Table dialog (see the Create Tables page for more) with the columns defined in the sample file. If needed change the names and datatypes of the columns in the table and then click ok. At this point, it is possible import into the newly created table. If the sample file contains the column names of the values, Aqua Data Studio will make an attempt at matching the column names of the import file to the names of the columns of the table. It is possible to reorder the column mapping by changing the Position column value to match the column number in the sample file, or remove the position value to exclude the column from being imported. Once all columns are mapped, click next.

4. In the Options Tab begin by selecting whether "(null)" text values are to be converted to NULL values. Then, select the format of the dates & time. Date and time values will be formatted in the text file to be imported into date/time columns. If a date string is to be imported into a VARCHAR column then the format does not apply. There is an option to import directly into the database, or generate an SQL file with INSERT statements to import into the database. A sample of the file's values are provided below for configuring the date/time formats. When ready, click the Next button to import the data. If the Import Tool is being used to generate a script file for use in Aqua Data Studio's Query Analyzer, it is strongly suggested that the statement separator "GO" be selected.

5. Once the Status Tab takes focus, the import has begun. It is possible to cancel the import at any time by clicking on the cancel button at the bottom of the dialog. If any errors or warnings occur, they will be displayed in the message text window.

Date and time formats are specified by date and time pattern strings. Within date and time pattern strings, unquoted letters from ’A’ to ’Z’ and from ’a’ to ’z’ are interpreted as pattern letters representing the components of a date or time string. Text can be quoted using single quotes (’) to avoid interpretation. "’’" represents a single quote. All other characters are not interpreted; they’re simply copied into the output string during formatting or matched against the input string during parsing.

The following examples show how date and time patterns are interpreted in the U.S. locale. The given date and time are 2001-07-04 12:08:56 local time in the U.S. Pacific Time time zone.