Import data from MS Excel 2007 (XLSX)

XLSX is a file format for Microsoft Excel spreadsheets that was introduced with the release of Microsoft Office 2007.

To import data from XLSX:

1. Open the Data Import wizard in one of these ways:

• On the Start Page, select Data Pump > Import External Data.

• In Database Explorer, right-click the required database or server connection and select Tasks > Import Data.

• In Database Explorer, right-click the required table or view and select Import Data.

• On the menu bar, select Database > Tasks > Import Data.

2. On the Source file page, select the file format and specify the source document, then click Next.

2.1. Under Import Formats, select XLSX.

2.2. In File name, click the ellipsis (…) and select the file.

Tip

Click Load Template to load import options from a previously saved template file.

Note

To move between pages, click Next or select a page directly from the navigation pane on the left.

To return to the previous step and review or change your settings, click Back.

To close the wizard without saving your changes, click Cancel.

3. On the Destination page, select the target table for the data import, then click Next.

3.1. In Connection, select the server connection for the database. You can also create a new connection or update an existing one.

Tip

To create or update a server connection:

1. In Connection, select Manage.

2. In the Connection Manager dialog, click New to create a connection or Edit to modify an existing one.

3. In the Database Connection Properties dialog, configure connection settings, then click Connect.

4. In the Connection Manager dialog, click OK to use the connection for the import.

3.2. In Database, select the database.

3.3. In Schema, select the appropriate database schema.

3.4. Select the target table:

• New table – Enter the name of a new table.

• Existing table – Select an existing table.

Tip

To find tables, enter a search query in the search box.

To update data in the grid, click Refresh.

4. On the Options page, configure import options, then click Next.

• Under Data Location:

  1. In Sheet, select the worksheet to import.

  Note

  The Preview area may display multiple tabs if you export data from more than one table into a single file. To select the worksheet to import, click the corresponding tab.

  2. In Start cell, select the first cell from which to begin the import.

  3. In End cell, select the last cell to include in the import.

  4. In Data in, select Rows to import each row as a separate record or Columns to import each column as a separate record.

  5. Optional: Select Treat blank values as null to import empty cells in your .xlsx file as NULL values.

Note

Detect a range automatically is selected by default. To specify a range of cells manually, clear the checkbox and enter the Start cell and End cell values. The selected cell range is highlighted in green in the Preview area.

• Under Header:

  • No header – Removes column headers. Column names are automatically generated, for example, column1, column2, and columnN.

  • First row in a range – Uses the first row as headers.

  • Position – Specifies a particular cell to use as the column header.

The selected header position is highlighted in blue in the Preview area.

5. On the Data formats page, set the data import formats, then click Next.

5.1. On the Common Formats tab, change the default format settings for all columns: Null String, Thousand separator, Decimal separator, Boolean, and Date and Time.

5.2. On the Column Settings tab, change the default format settings for specific columns: Null String, Left Quote, Right Quote, and Date and Time.

Note

Autodetect Date and Time format is selected by default. To change the format, clear the checkbox, then select the required format in Date and Time.

If a format mask is not set, dbForge Studio automatically identifies date and time values.

6. On the Mapping page, map columns between the source and target tables, then click Next.

• For data import to a new table: In Source column, select the required column from the dropdown list.

• For data import to an existing table:

  1. In Source column, select the required column from the dropdown list.

  2. In Default Value, specify a default value for each column.

  3. Optional: In Key, select one or more key columns that uniquely identify each row for the data import.

Note

If no key column is selected, only the Append and Repopulate modes are available.

The result of your configuration appears in the Preview area.

Note

When you import data to a new table, dbForge Studio for SQL Server automatically creates and maps all columns.

When you import data to an existing table, columns with matching names are mapped automatically, while the rest must be mapped manually. If no columns with matching names are found, they are mapped sequentially, for example, the first source column to the first target column and the second to the second.

Tip

To cancel the mapping of all columns, click Clear Mappings.

To restore the mapping, click Fill Mapping.

To remove a column, select it and click Delete.

To move a column to a specific position, click or , or drag the column to the desired location.

To add a column, click New Column. In the Column Properties dialog, specify column properties, then click OK.

To edit a column, select it and click Edit. In the Column Properties dialog, specify column properties, then click OK.

7. On the Modes page, select a data import mode, then click Next.

• Append – Adds new records from the source table to the target table. Existing records in the target table are not modified.

• Update – Replaces records in the target table with matching records from the source table.

• Append/Update – Updates existing records in the target table if a match is found. If no match exists, it inserts a new record.

• Delete – Deletes records in the target table that match records in the source table, then inserts the corresponding records from the source table.

• Repopulate – Deletes all records from the target table and repopulates it with records from the source table.

Note

By default, Use a single transaction and Use bulk insert are selected. When Use a single transaction is selected, the tool runs the data import within a single database transaction. When Use bulk insert is selected, import performance (especially for large datasets) is improved. To turn off the option, clear the checkbox.

8. On the Output page, select the output option, then click Next.

• Open the data import script in the internal editor – Opens the script in dbForge Studio after the data import is complete.

• Save the data import script to a file – Saves the import script to a file. Click the ellipsis (…) and specify the path to the file where the script will be saved.

  To add the date and time to the file name, select Add timestamp to the file name.

  To open the file in the internal editor after the import completes, select Open in the internal editor.

• Import data directly to the database – Inserts data directly into the target database.

9. On the Errors handling page, choose how to process errors and how they should be logged.

• Abort at the first error – Stops import immediately when the first error occurs.

• Prompt a user for an action – Stops the import when an error occurs and prompts the user to choose the action.

• Ignore all errors – Continues the data import, skipping any errors without interruption.

Tip

To create a log file, select Write a report to a log file, then click the ellipsis (…) and select the folder where you want to save the file.

Note

To save your import settings as templates for recurring scenarios, expand the Save menu and select Save Template. You can then use the templates to import data from the command line.

10. Click Import.

11. On the Finish page, select one of the following actions:

• Show log file – Opens the log file.

• Import more – Starts another import.

12. Click Finish to close the wizard.