Import sets properties
-
- UpdatedAug 1, 2024
- 7 minutes to read
- Xanadu
- Data Management
Multiple properties control import set behavior.
Import sets properties
- glide.import_set.preserve.leading.spaces
- Specifies whether the import process preserves leading spaces in Excel data cells.
When false, the import process removes non-breaking leading spaces from Excel data
cells. When true, the import process preserves non-breaking leading spaces. Note: The import process always removes trailing spaces from Excel data cells.
- Type: true | false
- Default value: false
- Location: Add a system property
- glide.import_set_row.dynamically_add_fields
- Specifies whether an import set can add new columns to the staging table (true) or not
(false). Instances that contain large numbers of import sets can sometimes become
unresponsive when an import adds a column because the instance must alter every row in
the staging table. In some cases, the database alter table action causes an outage.
Setting this property to false prevents an import set from adding columns to the staging
table and produces a log message. As a workaround, administrators can manually add a
column to the staging table by creating a new dictionary entry and then reimporting the
import set.
- Type: true | false
- Default value: true
- Location: Add a system property
- com.glide.loader.verify_target_field_size
- Enables dynamic resizing of import set fields. With the default setting of
false, up to 20 records of the source data are sampled to
determine the import set field length. If the field is empty in all the sampled records,
the default length of 40 is used. Any data loaded that exceeds the import set table
field length is truncated. Set this property to true to allow any
import set field to increase the column size by 100 to match the length of the data. For
example, if the incoming source data has a length of 60, the system sets the length of
the column to 160. This is relevant to data source only.
- Type: true | false
- Default value: false
- Location: Add a system property
- glide.ds.file.http.variable_replacement
- Enables system property expansion for File-type data sources that are retrieved using
HTTP or HTTPS.
- Type: true | false
- Default value: true
- Location: Add a system property
- More information: Data source fields
- glide.scheduled_import.stop_on_error
- Set to true to stop the import process when the parent scheduled
import generates an error. This behavior can be useful when one import set depends on
the results of another import set.
- Type: true | false
- Default value: false
- Location: Add a system property
- glide.impex.transformer.empty_value_nil
- Controls how empty string values are handled during transformation from an import set
staging table. Set this property to true to preserve empty strings. Set
this property to false to convert empty strings to the string
NULL. Note: An empty string is always stored as a null value in the database, regardless of this property value.You can use this property when you run an onBefore script during transformation. Setting this property to true allows you to check for null values using hasValue() or nil() functions.
- Type: true | false
- Default value: false
- Location: Add a system property
- com.glide.loader.max_scan_rows
- Controls how many rows of source data are sampled to automatically generate staging
table fields when you import data. This property applies to JDBC, XLS, CSV, and XML
imports but not to JSON and XSLX imports.
- Type: integer
- Default value: 20
- Location: Add a system property
Concurrent import sets properties
- glide.scheduled_import.max.concurrent.import_sets
- Maximum number of import sets for one concurrent import.
- Type: Integer
- Default value: 10
- Location: Add a system property
- com.glide.concurrent_import_set_insert_mutex_spin_wait
- Wait time mutex spends if the lock is acquired (in milliseconds).
- Type: Integer
- Default value: 1000
- Location: Add a system property
- com.glide.concurrent_import_set_insert_mutex_expiration
- Mutex expiration time (in milliseconds).
- Type: Integer
- Default value: 300000
- Location: Add a system property
- com.glide.concurrent_import_set_mutex_fast_lock
- Specifies whether to use fast lock (true) or SQL-based slow lock (false).
- Type: true | false
- Default value: false
- Location: Add a system property
Web service import sets properties
- com.glide.ws_import_set.column_resize
- When true, enables dynamic column resizing on import staging tables for web service
import sets.
- Type: true | false
- Default value: false
- Location: Add a system property
- com.glide.ws_import_set.column_resize.max_row_count
- The maximum number of rows an import staging table can have for dynamic column
resizing with web service import sets.
Import staging tables with more than this number of rows will not use dynamic resizing with web service import sets, even if com.glide.ws_import_set.column_resize is true.
This property has a maximum value of 500,000.- Type: Integer
- Default value: 100,000
- Location: Add a system property
CSV properties
- com.glide.csv.loader.ignore_non_parseable_lines
- Allows an instance to ignore one or more lines (rows) that contain bad data in a CSV
import, such as a row that is missing a column of data. By default, imports cannot
ignore bad data in CSV files and fail on the first error.
- Type: true | false
- Default value: false
- Location: Add a system property
- com.glide.csv.loader.max_errors_allowed
- Specifies the maximum number of lines (rows) that an import can ignore before failing.
If the import succeeds, the import lists the number of rows the import ignored due to
errors.
- Type: integer
- Default value: 100
- Location: Add a system property
- glide.import.csv.charset
- The charset of the CSV file to import. Valid values are UTF-8 and WINDOWS-1252. You
may need to use UTF-8 formatting when importing special characters.
- Type: String
- Default value: WINDOWS-1252
- Location: Add a system property
Excel import properties
- glide.excel.multiplier
- The maximum amount of instance memory to allocate to an Excel import. This property
applies when importing .XLS files only.
The value of this property is multiplied by the file size of the Excel file to determine the total memory allocation. The memory used cannot exceed the limit specified by the glide.excel.max_memory_percent property.
For example, with the default value 8 and a 10MB Excel file, the instance will use up to 80MB of memory for the import.
- Type: integer
- Default value: 8
- Location: Add a system property
- glide.xlsx.multiplier
- The maximum amount of instance memory to allocate to an Excel import. This property
applies when importing .XLSX files only.
The value of this property is multiplied by the file size of the Excel file to determine the total memory allocation. The memory used cannot exceed the limit specified by the glide.excel.max_memory_percent property.
For example, with the default value 10 and a 10MB Excel file, the instance will use up to 100MB of memory for the import.
Note: Do not modify the value of this property. The default value was selected for optimal performance.- Type: integer
- Default value: 10
- Location: Add a system property
- glide.excel.max_memory_percent
- The maximum amount of memory allowed for Excel imports, as a percentage of the total
instance memory.
- Type: integer
- Default value: 10
- Location: Add a system property
- glide.excel.use_disk_backed_strings_table
- Controls whether the instance uses disk storage to maintain large file data during
XLSX import. Set this property to false to store XLSX file data only in memory. Setting
this property to false increases the memory used during XLSX import.
- Type: true | false
- Default value: true
- Location: Add a system property
- glide.excel.in_memory_strings_table_size_mb
- The maximum amount of memory, in megabytes, available to store XLSX file data before
writing to disk storage when glide.excel.use_disk_backed_strings_table is true. Setting
a lower value for this property will use less memory during XLSX import but may result
in slower imports.
- Type: integer
- Default value: 5
- Location: Add a system property
- glide.xlsx.import.debug
- Enables debug logging for XLSX imports.
- Type: true | false
- Default value: false
- Location: Add a system property
- glide.import.excel.enhanced_number_conversions
- When true, numeric values greater than 10 million are preserved in import staging
tables. When false, imported values greater than 10 million are converted to scientific
notation that may not match the original imported value. This property should be set to
true for importing most kinds of data.
- Type: true | false
- Default value: true
- Location: Add a system property
- glide.transform.boolean.casesensitive
- When true, upper case boolean values of (TRUE/FALSE) always transform to false. When
false, upper case boolean values (TRUE/FALSE) are transformed correctly.
- Type: true | false
- Default value: true
- Location: Add a system property
JDBC connection properties
- glide.jdbcprobeloader.retry
- The number of times a JDBC probe loader attempts to process data returning from a JDBC
data source. Sleeps on the value defined in
glide.jdbcprobeloader.retry_millis between retries.
- Type: integer
- Default value: 60
- Location: Add a system property
- glide.jdbcprobeloader.retry_millis
- How many milliseconds a JDBC probe loader waits in between retry attempts to process
data from a JDBC data source.
- Type: integer
- Default value: 5000
- Location: Add a system property
Logging and debug properties
- com.glide.import_set.importlog_level
- Specifies how much information import sets add to the log. Possible values are INFO,
WARNING, and ERROR. You can set this to INFO in the dev environment and change it to
WARNING or ERROR in production to reduce amount of logging noise traffic to the
database.Note: This property does not impact logging related to the cleanup of staging tables.
- Type: string
- Default value: INFO
- Location: Add a system property
- glide.import.debug
- Enables debug logging for all import processes.
- Type: true | false
- Default value: false
- Location: Add a system propertyAdd to the System Property [sys_properties] table
- glide.importlog.log_to_table
- Specifies whether to write information-level log messages into the import_log table.
When true, the information-level log messages are written.Note: The information-level logs for IntegrationHub ETL are written to the importlog.log table regardless of this property setting. To have additional exceptions added, contact Now Support.
- Type: true | false
- Default value: false
- Location: Add a system property
- glide.import.sftp.debug
- Enables additional debug logging for SFTP imports. Enabling this property will cause
the instance to log all outgoing and incoming messages during the SSH session.
- Type: true | false
- Default value: false
- Location: Add a system property
- glide.import.scp.debug
- Enables additional debug logging for SCP imports. Enabling this property will cause
the instance to log all outgoing and incoming messages during the SSH session.
- Type: true | false
- Default value: false
- Location: Add a system property