Import

Overview

The Import page maintains an import mapping from a source object into an AnalyticsCreator import table. Use it to assign the import package, describe the mapping, define import SQL and filters, map source columns to target columns, maintain package variables, add pre- and post-import scripts, and tune package loading options.

Function

The top area identifies the import relationship in Import and lets you select or enter the Package that owns the import. The same area stores the import Description, optional ImpSQL, filter or query options, and package flags such as Update Statistics, Use Logging, Externally launched, and Manually created.

For connector types that support storing the query in a package variable, Use variable to store query is available. For OData-style sources, the filter area is presented as Query options so the value can be used as request options rather than as a table filter.

The Main tab contains the field mapping grid and package-variable grid. The field grid maps Source Name values to Target Name columns and can include a description and SSIS statement for each mapping. The variables grid maintains package variables, types, descriptions, expressions, and initial values.

The Scripts tab stores SQL that runs before and after the import step. Each script can be viewed as originally entered or as parsed text after AnalyticsCreator resolves macros.

The Options tab controls import-package performance and loading behavior, including buffer sizes, batch and commit sizes, null and identity handling, table locking, constraint checking, row batches, and command timeout. Each option has a default button that restores the repository default for that setting.

Save validates that the import belongs to an import package, stores the mapping and package options, and refreshes the page. Cancel closes the editor without continuing the current edit.

Access

Open an existing import from the Import branch under Packages, from the import branch under an import schema, from a source entry that already has import mappings, from the Imports list, or from a diagram import edge. To create a new import, use Add import from an import package, source, or diagram source context; the Import Wizard collects the source, target schema, target table name, and package before opening the Import page for detailed editing.

How to access

Data warehouse -> Packages -> Import -> [package] -> [import] -> Edit import, or Data warehouse -> [import schema] -> Import -> [import].

Toolbar

ETL -> Imports, then double-click a row or use New to create an import.

Diagram

Double-click an import package edge, or use Add -> Import from a source context.

Visual element

Import page and Import Wizard

Screen overview

ID Property Description
1ImportRead-only relationship label showing the source-to-target import being edited.
2PackageImport package that owns the mapping. A typed package name can create a new import package on save.
3DescriptionOptional description for the import mapping.
4ImpSQLOptional SQL or query text used for the import source selection.
5FilterOptional import filter. For OData-style sources, this area is labeled Query options.
6Update StatisticsUpdates table statistics as part of the import package flow.
7Use LoggingEnables logging for the import package step.
8Externally launchedMarks the owning package as launched outside the standard package run flow.
9Manually createdMarks the owning package as manually maintained.
10Use variable to store queryStores the source query in a package variable when the connector supports this behavior.
11MainTab for field mapping and package variables.
12FieldsGrid that maps source columns to target import-table columns.
13Source NameSource column selected for the import mapping.
14Target NameTarget import-table column that receives the source value.
15DescriptionOptional description for the field mapping or package variable.
16SSIS StatementOptional package statement for the field mapping.
17VariablesGrid for package variables used by the import package.
18VariableVariable name available to the generated package.
19TypeVariable data type: String, Integer, or Boolean.
20ExpressionOptional expression for the package variable.
21Initial valueInitial value assigned to the package variable.
22ScriptsTab for SQL that runs before or after the import.
23PreScriptSQL executed before the import package step.
24PostScriptSQL executed after the import package step.
25Original / ParsedSwitches script display between the entered script and the parsed script after macro resolution.
26OptionsTab for package loading and performance settings.
27DefaultBufferMaxRowsMaximum rows allowed in a data-flow buffer before the package uses a new buffer.
28DefaultBufferSizeBuffer size used by the generated package data flow.
29Max insert commit sizeMaximum number of inserted rows committed in one operation.
30Keep nullsPreserves incoming null values instead of applying target defaults.
31Keep identityKeeps identity values from the incoming data when supported.
32Table lockRequests a table lock while rows are inserted into the target.
33Check constraintsControls whether target constraints are checked during load.
34Rows per batchBatch size used when writing rows to the target.
35Command TimeoutTimeout for import commands. Empty value falls back to the repository default.
36defaultRestores the repository default value for the option on the same row.
37SaveValidates the package and stores the import mapping, field mappings, scripts, package flags, and options.
38CancelCloses the page without continuing the current edit.

Related topics