Easy Loader User Guide
Easy Loader User Guide
Version 12.5
The EasyLoader utility lets you to upload MapInfo TAB files to a remote database,
such as Oracle, SQL Server, Microsoft Access or PostgresSQL/ PostGIS. The
spatial information in the TAB files is maintained in the remote database and is
available for viewing and analyzing in MapInfo Professional.
In this section:
• Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6
• History of EasyLoader Changes . . . . . . . . . . . . . . . . . . . . .6
• Uploading Data with EasyLoader . . . . . . . . . . . . . . . . . . . .8
• Unsupported Geometries in Oracle, SQL Server, and
PostGIS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9
• Loading Oracle Spatial Data . . . . . . . . . . . . . . . . . . . . . . .10
• Loading Microsoft SQL Server Spatial Data . . . . . . . . . . .11
• Loading PostGIS Spatial Data . . . . . . . . . . . . . . . . . . . . . .13
• Understanding the EasyLoader Dialog Box . . . . . . . . . . .13
• Understanding the Options Dialog Box . . . . . . . . . . . . . .15
• Uploading Tables with Time and DateTime Columns . . .17
• Using the Command Line Flags to Run EasyLoader . . .18
• Mixing Command Line Flags with the EasyLoader User
Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .21
• Creating a New Map Catalog . . . . . . . . . . . . . . . . . . . . . . .21
• Using the MAPINFO_MAPCATALOG . . . . . . . . . . . . . . . . .22
Introduction
Introduction
EasyLoader is a utility available from EasyLoader that allows you to upload MapInfo TAB files to a remote
database. The spatial information in the TAB files is maintained in a SQL Server database and is available
for viewing and analyzing in MapInfo Professional. EasyLoader can also upload a text object to SQL
Server if text-supported SpatialWare (4.6 or later) is on the server.
EasyLoader is installed into the \Tools directory during the MapInfo Professional installation process.
EasyLoader supports the following databases:
• Oracle
• SQL Server
• Microsoft Access
• PostgreSQL / PostGIS
For spatial database support, the Database Management System (DBMS) must be able to handle spatial
geometry, either by itself (as in Oracle Spatial) or through MapInfo SpatialWare (for SQL Server). If one
of the above DBMS does not have spatial object type support, the table can only be uploaded as XY
data: XY or XY with MapInfo Key (MICode). Only one server connection may be open at any one time.
To obtain a copy of EasyLoader, go to www.mapinfo.com and search for the EasyLoader download
page where you can download both EasyLoader and the EasyLoader User Guide.
System Requirements
This product is tested on the following Microsoft Windows Desktop Operating Systems:
• Windows 7 Ultimate 32-bit SP1
• Windows 7 Ultimate 64-bit SP1 with 32-bit compatibility mode
• Windows 2008 Server R2 64-bit SP1
• Windows 2008 Server R2 64-bit SP1 with XenApp 6.0
• Windows 8 32-bit
• Windows 8 64-bit
• Windows 2012 Server 64-bit
• Windows 2012 Server 64-bit with XenApp 6.5
• PostGIS 2.0 – Note that when uploading files to a PostGIS 2.0 database, spatial objects upload as a
geometry spatial data type.
• SQL Server 2012 – EasyLoader processes any invalid geography using the SQL Server 2012
MakeValid( ) function, so that the geography is valid.
6 EasyLoader 12.5
Chapter 1: Uploading Data with MapInfo EasyLoader
The server table processing option Grant Public Access to Table has been changed to Grant Public
Full Access to Table.
This release fixes the following issues:
• MIPRO-12309: A message displays when appending a native table with a MI_PRINX column in an
Oracle Spatial database with an OCI connection, "Table cannot be Appended—It has a different table
structure."
• MIPRO-12320: When uploading a table with no geometry into EasyLoader 11.5, an error message
appears: "Table cannot be Appended—It has a different table structure."
• MIPRO-32642: EasyLoader is unable to import to “geography” data type in SQL Server 2008 SP2.
You will need to upgrade to SQL Server 2012. SQL Server 2012 uses the function STIsValid( ) to
check if a geography data type is well formed and recognized as a valid object based on its OGC type.
The MakeValid( ) function is also used that converts an invalid geography data type into a valid one.
In MapInfo Professional 12.0, you can use the extended spatial methods in SQL Server 2012 to manage
valid geography data types. Refer to the SQL Server 2012 MSDN library for more information.
• MIPRO-19759: In EasyLoader, a connection string created in a tab file does not seem to work every
time.
• MIPRO-21235: EasyLoader cannot upload geography from the command line in SQL Server 2008.
• MIPRO-24515: Uploading a table with a boolean field to PostGIS does not put the correct TYPE_NAME
on the server side. There is an inconsistency between EasyLoader and MapInfo Professional on how
they save data on PostGIS. EasyLoader uploads a logical field as smallint, whereas, MapInfo
Professional uploads a logical field as boolean. When you open a first table, uploaded by EasyLoader,
in MapInfo Professional, the field shows up as smallint. When you open a second table, uploaded by
MapInfo Professional, in MapInfo Professional, the field shows up as char[5].
Note: You cannot replace version-enabled tables in the Oracle database. It makes any child versions
of these tables obsolete.
2. Under Connection Information, click the appropriate button (ODBC or Oracle Spatial) to connect
to your database. Provide the necessary connection information (for example, data source name or
User ID, password, and server name). Click OK to return to the EasyLoader dialog box.
3. Click Source Tables to display a list of MapInfo tables from a single directory. When you have
selected the tables for uploading, the names display in the MapInfo Table list box.
4. Choose the tables you want to upload and select the appropriate Server Table processing task
(Create new table, Append to existing table, Replace existing Table).
Note: The Upload button is not available until one or more tables are chosen.
8 EasyLoader 12.5
Chapter 1: Uploading Data with MapInfo EasyLoader
5. To create local TAB files, provide a directory or browse to its location. By default, EasyLoader does
not generate these files. The file naming convention for these tables is
yourServerTableName_srv.tab.
6. To set options for the upload process, click Options.
Note: See Understanding the Options Dialog Box on page 15 for an explanation of available
options.
7. In the Options dialog box, select the appropriate options and click OK.
8. Click Upload to start the upload process.
9. Close EasyLoader after the upload process is finished.
If you haven’t already created the spatial index during the upload process, do so now by either executing
a create index statement or re-uploading the table, making sure this time to select the Create Spatial
Index check box and replace the table (see steps 1-3).
SQL Server uploads invalid Geometry objects and converts them to valid using a SQL server command,
but SQL Server does not upload invalid Geography objects. Attempting to upload invalid Geography
objects causes EasyLoader to fail. This is a limitation of SQL Server and not of EasyLoader.
Due to this SQL Server limitation, our recommendation is to upload only as Geometry.
Loading Native Tables that Contain Text Objects into Oracle 11g
If you are using Oracle 11g or later, you can use EasyLoader to upload a native table (TAB file) that
contains text objects to an Oracle Spatial database table. (Previous versions of EasyLoader discarded
any text objects when uploading a TAB file to Oracle.) When you upload the TAB file, EasyLoader uploads
the text objects to Oracle as annotation text fields.
Oracle 11g stores MapInfo geometry objects (such as points, polylines, and polygons) as
SDO_GEOMETRY types and stores MapInfo text objects as ANNOTATION_TEXT types. A TAB file
may contain both geometry and text objects. MapInfo Professional, however, only supports database
tables that have one object column. Because of this limitation, if the TAB file you are uploading contains
both types of objects, EasyLoader will prompt you to select which object type you want to upload: Text
Objects or Geometry.
When you upload a TAB file that contains text objects to Oracle 11g, you are prompted to specify a
numeric value representing the map scale to be used along with the text attributes. Enter a value in the
Default Map Base Scale field or keep the value shown.
You can define map base scale as a value at which the text will be drawn on the map at the size specified
in the attributes.
10 EasyLoader 12.5
Chapter 1: Uploading Data with MapInfo EasyLoader
2. SDO_GEOM.VALIDATE_LAYER( )
These functions may result in validation errors due to the tolerance level set by EasyLoader. You may
get error messages such as:
To resolve these errors, reset the tolerance within the USER_SDO-GEOM_METADATA by adjusting
them downwards (by a factor of 10) and rerun the validation.
Note: If you adjust the tolerance, you must re-create the spatial indexes because they use the tolerance
when they are created.
To view the Unsupported Geometries in Oracle See Unsupported Geometries in Oracle, SQL Server,
and PostGIS.
Keep the default selection of Always Geometryif you want EasyLoader to always upload geometry
objects to Geometry fields regardless of the coordinate system they use.
Select Auto Selectif you want EasyLoader to automatically decide whether the geometry object is
uploaded to a Geography field (in cases where the geometry object uses the Lat/Long coordinate system)
or a Geometry field (in cases where the geometry object does not use the Lat/Long coordinate system).
Note: When the Auto Select option is selected, if for any reason a geometry object that uses the Lat/Long
coordinate system cannot be uploaded to a Geography field, it will instead be uploaded to a
Geometry field.
To view the Unsupported Geometries in SQL, see Unsupported Geometries in Oracle, SQL Server,
and PostGIS on page 9.
EasyLoader supports uploading MapInfo native tables into SQL Server Spatial. SQL Server Spatial
allows spatial data to be stored into two data types; Geometry and Geography.
SQL Server's rules that define what a valid geometry or geography are different than MapInfo
Professional's rules.
The SQL Server Spatial's Geography data type does not support:
• polygons that contain self intersecting boundaries
• geography instances that span more than one hemisphere
• lines/polygon boundaries that have two successive, identical nodes
The SQL Server Spatial's Geometry type does not support:
• polygons that contain self intersecting boundaries
• lines/polygon boundaries that have two successive, identical nodes
Refer to SQL Server books online for complete information on the rules that define these two types at:
http://www.microsoft.com/en-us/sqlserver/default.aspx
This means that you may have geometry data that are valid in a MapInfo TAB format that cannot be
loaded into SQL Server Spatial without correction/edits.
EasyLoader aborts the upload if it comes across the geometry that SQL Server rejects. It will display
the primary key of the record that contains the rejected object. A "MapInfo Upload Utility Error" message
displays.
You may want to try the following steps to make the geometry acceptable to SQL Server.
• Use MapInfo Professional's Clean operation on the Object menu to correct the geometry.
• If your upload was to Geography type and it fails, try loading it to Geometry, correct the instance using
the MakeValid( ) method on the Geometry type, and uploading the instance again. You will need a
working knowledge of SQL and access to a SQL Server Spatial client to use this approach.
Consider the following example. Let's suppose the Geometry update failed for the row
(state = 'Florida').
• force an operation that does not alter the geometry, but forces a topology
construction. here, we perform a union of the Geometry with its own start point
update states_geom set geom = geom.STUnion(geom.STStartPoint())
where state = 'Florida'
• now this query will attempt to create a Geography instance from the reformed
Geometry
select state_name, sw_member,
Geography::STGeomFromWKB(geom.STAsBinary(), 4269) from
states_geom, where state = 'Florida'
12 EasyLoader 12.5
Chapter 1: Uploading Data with MapInfo EasyLoader
Database Options
This section describes the button options and input fields in the EasyLoader for connecting to a database.
ODBC button Click this button to connect to a server using ODBC. This displays the Select
Data Source dialog box where you can select a file or machine data source.
You must have your data connections set up before selecting the ODBC
option. For more information, see Connecting to a Remote Database on
page 13.
Oracle Spatial button Click this button to connect to an Oracle Spatial server. Enter your user name,
password, and the server name to complete the connection. This button is
only enabled if the Oracle Client software is installed. Oracle Client software
does not come with EasyLoader.
Source Tables button Click this button to identify the source tables you want to upload. The Source
Tables button is available only after you have made a connection to a server.
This action enables you to select one or more MapInfo tables from a single
directory.
Server Table Name Type the name of the database server table to which you are uploading the
selected tables.
Append All Tables to Click this option to upload all MapInfo tables listed in the MapInfo Table list
One Server Table to a single server table. The server table name is the one visible in Server
Table box. This feature should be used to upload tables with the same structure
and style to one table.
Example: Instead of creating a new table for each street layer, check the
Append All to One check box, and only one table is created. Then all of the
tables are appended to this table.
TAB File Directory for Generates TAB files to access remote DBMSs when you provide the TAB file
Server Table(s) directory. By default, an empty directory, the loader does not generate .tab
files. The newly generated .tab file is the Server Table Name plus _srv.tab
(yourServerTableName_srv.tab). Click Browse to search for the directory
you need.
Map Catalog button Click this button to add a new Map Catalog or to unregister a table from the
Map Catalog. For more information, see Creating a New Map Catalog on
page 21.
Upload button Click this button when you have set all of the parameters you want for
uploading the table(s) you have specified.
Options button Click this button to specify the spatial object types and the server processing
options for the current upload. For instructions about using the Options dialog
box, see Understanding the Options Dialog Box on page 15.
If you choose the Replace Existing Table option and this check box is selected,
the server table is dropped, a new table is created, and all tables listed are
appended to that one. If you select the Create New Table option and this check
14 EasyLoader 12.5
Chapter 1: Uploading Data with MapInfo EasyLoader
box is selected, the server table is created, and all tables listed are appended to
that one.
Note: If this option is chosen, all tables must have the same table structure and
be in the same projection.
Note: When the Auto Select option is selected, if for any reason a geometry object that uses the
Lat/Long coordinate system cannot be uploaded to a Geography field, it will instead be uploaded
to a Geometry field.
Create Primary By selecting this check box, a primary key is created for the Create New Table
Key and Replace Existing Table operations. This primary key is created in the column
SW_MEMBER for SpatialWare, MI_PRINX for Oracle, or MI_SQL_REC_NUM for
XY and MICODE. These columns are sequential numbers that are generated by
EasyLoader. These columns are always created, but do not have to be a primary
key. For the Append To Existing Table operation, the primary key is not created.
Grant Public Full The PUBLIC is granted all access to the server table.
Access to Table
Create Spatial By selecting this check box, a spatial index (called <tablename>ind) is created for
Index the tables on the geometry column. You may also build your own spatial index to
suit your specific needs. If you choose to do this, clear this check box to save
loading time.
By selecting this check box, a spatial index (called <tablename>_SX) is created
for Oracle Spatial tables on the geometry column . The index tiling level is based
on the SDO_TUNE.ESTIMATE_TILING_LEVEL function. For tables with fewer
than 7500 rows, the tiling level is restricted to 8. After the index is built the
ANALYZE table function is run on the index table. The spatial index is R-Tree for
Oracle 8.17 or later.
Create IDENTITY Select this check box if you wish to create the primary key column (SW_MEMBER)
Column (SQL with IDENTITY properties. When this feature is in use, the primary key column
Server only) values are generated automatically by SQL Server. You do not need to fill in the
key manually when a new row is inserted.
Create Indices on Select this check box if you want to index additional columns when uploading a
Other Columns new table or replacing an existing table. By default this box is not selected.
When you select this check box and click OK, the table upload begins and the
following dialog box displays.
The Table Name text box shows which server table is selected for indexing. The
Column List shows each column followed by its data type. Select a check box to
select that column for indexing on the server table. Clear a check box if you do
not want to index that column.
Note: If the column name length is too long, the index creation fails. The limit
to the size of the index name varies per database.
Convert Date and This option is automatically handled by the software, with selects it when connected
Time columns to to a DBMS, such as Oracle and Access, that does not have date or time data
Datetime on the types and unselects it for a DBMS, such as SQL Server Spatial or PostGIS, that
server has both date and time data types.
16 EasyLoader 12.5
Chapter 1: Uploading Data with MapInfo EasyLoader
Style Column This option allows you to specify whether per-row styles are loaded with the data.
You can also specify the name of the column in the text box next to the Style
Column check box. The default column name is MI_STYLE.
Note: To load per-row styles, the MapInfo Map catalog for the database must
contain the following columns: RENDITIONTYPE, RENDITIONCOLUMN,
RENDITIONTABLE, and NUMBER_ROWS. For more information, see
MAPINFO_MAPCATALOG Table Structure on page 22.
Commit Interval Use this option to specify a commit interval for uploading. EasyLoader commits
the inserted records when the commit interval is reached. The default commit
interval is 1000. If the commit interval is set to 0 (zero), the whole range of records
is inserted as a single transaction, before a commit is issued.
Schema Use this option to specify a schema to which you want to upload the table. This
is valid for SQL Server 2005 servers and PostgresSQL/PostGIS.
* The MapInfo data type will be extended on the servers. When the same data comes back to MapInfo
Professional, the data type will be as is indicated on the server. This conversion is consistent with MapInfo
Professional behavior when a MapInfo table is saved to a server using MapInfo Professional.
On servers that do not support DATE or TIME data types, the data is converted to a DATETIME type.
In this conversion, part of the data will be missing because the MapInfo types contain either the date or
the time, but not both. The server default values for the date or the time are used to fill in the missing
data. Conversions to DATETIME are made for SQL Server versions earlier than version 10 (prior to SQL
Server Spatial).
For example, if the server does not support the MapInfo DATE type, the upload process converts the
DATE type to a DATETIME type. The date value comes from the MapInfo table, but the time value is
filled in with the server default value for time. The following table shows how the MapInfo data types are
converted when they are not supported on the server and what default value are used to fill in the missing
data:
MapInfo Data Type To Server Data Type Server Default Values Databases
* SQL Server versions earlier than version 10 (prior to SQL Server Spatial).
easyloader.exe /T c:\data\states.tab;mystates
/G /Y
Note: Do not enclose file names in quotation marks. Command line arguments are interpreted correctly
without quote marks, even if the filename includes spaces. If you use quotation marks, EasyLoader
cannot parse the filenames correctly and errors occur.
EasyLoader supports the following flags to allow you to specify additional upload parameters from the
command line:
• /A Append All Tables to One – Use this flag to upload multiple tables to a single table (as long as
the table structures are the same).
Syntax: /A
• /B Schema Name – Use this flag to specify a schema name when you upload tables to a SQL Server
2005 server. If you do not supply a schema name, then this flag uses the user’s default schema on
the server (on SQL Server the default is usually set to dbo for example).
Syntax: /B SchemaName
• /C Create Indices for All Locally-Indexed Columns – Use this flag to mandate that only the columns
that were indexed on the local table be automatically indexed on the server table, when you upload a
new table or replace an existing table.
This command line option does not allow you to make or reset column selections. That additional
capability is supported by the EasyLoader user interface (see Create Indices on Other Columns under
Server Table Processing Options on page 15 and Mixing Command Line Flags with the
EasyLoader User Interface on page 21).
Syntax: /C
• /D .tab File Directory for Server Table(s) – Use this flag to generate TAB files and provide the TAB
file directory to access a remote DBMS. The default is an empty directory, in which case EasyLoader
does not generate .tab files. The naming convention of your newly generated .tab file is
yourServerTableName_srv.tab. The directory must be valid (empty is treated as valid) to upload a
table.
Command line option is /D PathName.
Syntax: /D C:\temp
Do not enclose file names in quotation marks.
• /E Exclusive Use of Table – Use this flag to improve load time on large tables significantly if you
know that you are the only one attempting to update the table. Specifying this flag does not guarantee
that EasyLoader can obtain exclusive use; you must guarantee that to the loader. EasyLoader checks
on the current maximum value of the primary key column (MI_PRINX) after each commit to ensure
that it detects any other entries that may have been made by other processes. This flag prevents that
check from occurring, which can significantly improve the upload time for large tables.
This flag may be placed within a shortcut, allowing the interactive use of the EasyLoader interface for
other functions.
Syntax: /E
• /F Log File name – Use this flag to specify the name and location of the log file. Whenever you upload
a table, EasyLoader produces a log file. By default, a log file named EasyLoader.log is created in
the Windows TEMP directory. If you specify a file name but do not provide a path, EasyLoader creates
the log in the same directory as the EasyLoader.EXE file.
Syntax: The first example shows just the name of the log file, which is written to the directory in which
EasyLoader.exe is located; the second example specifies the full path for the log file.
18 EasyLoader 12.5
Chapter 1: Uploading Data with MapInfo EasyLoader
/F myLogFile.txt
/F c:\temp\myLogFile.txt
Do not enclose file names in quotation marks.
• /G Grant all – Use this flag to grant all rights to PUBLIC. This flag is turned OFF by default.
Syntax: /G
• /I Do Not Create a Spatial Index – Use this flag to prevent EasyLoader from creating a spatial index
on the uploaded table. By default EasyLoader creates a spatial index. This flag is turned OFF by
default, meaning a spatial index is created. For IDS/UDO tables, EasyLoader creates a spatial index,
and then issues the 'update statistics medium' statement. See the /U flag description, which controls
the unique index. For Oracle Spatial tables, the spatial index is created on the geometry column and
is called table_name_SX; for SpatialWare tables, the index is created on the column geometry column
and is called hg table_name ind.
Syntax: /I
• /K Create Automated Key Column for SQL Server – Use this flag to generate the unique key column
values automatically in SQL Server. You do not need to fill the key manually when you insert a new
row. The key column (SW_MEMBER) can be created with the IDENTITY property as an option.
For SQL Server 2005, the key column is SW_MEMBER, because it needs SpatialWare. It also can
be MI_SQL_REC_NUM depending on the spatial object type that is selected. If no SpatialWare is
used (as with SQL Server versions 2008 or later), then the key column is MI_PRINX or
MI_SQL_REC_NUM: MI_PRINX or SW_MEMBER is used for spatial types and MI_SQL_REC_NUM
is used for XY types.
The key column (SW_MEMBER) is created with the IDENTITY property by default. Therefore, omitting
the K option in the command line has the same action as specifying /K, (that is, it creates the key
column with IDENTITY property). If you want to turn off the property, you must provide a keyword
NO_IDENTITY following /K. See Mixing Command Line Flags with the EasyLoader User Interface
on page 21.
Syntax: /K
Example: /K NO_IDENTITY
• /L List of MapInfo tables – Use this flag to specify a text file that contains a list of tables you want to
upload. The format of each line is the same as the /T flag.
Syntax: /L ListOfTables.txt
Do not enclose file names in quotation marks.
• /M MICODE/XY – Use this flag to specify the object type to be used if it is SpatialWare. If the /M flag
is used, provide MICODE (for XY with MapInfo key) or XY (for XY only) after /M. Any words other than
MICODE or XY after /M are treated as errors, and EasyLoader does not run (the main EasyLoader
dialog box does not appear). If you do not use the /M flag, EasyLoader uses SpatialWare as the default
if the selected database has SpatialWare installed.
Syntax: /M MICODE
Example: /M X
• /O Connection String – Use this flag to set a connection string for Oracle Spatial to be passed to the
program. See the /S flag for ODBC connections.
Syntax: /O user_name/password@server_name
• /P A | C | R – Use this flag to specify what to do with the table(s) being loaded to the server.
Use A to append to an existing server table.
Use C to create a new server table. If you specify the C option and the table you are uploading has
the same name as a table on the server, upload operation fails.
Use R to replace an existing table.
Syntax: /P A
• /Q Quit – Use this flag to exit EasyLoader when the upload is complete.
Syntax: /Q
• /R Replace the server table – Use this flag to drop the server table and create and upload the new
table. EasyLoader creates a table on the server even if the table did not exist previously.
Syntax: /R
• /S Connection String – Use this flag to pass an ODBC connection string to the program. If enough
information to connect is supplied, the ODBC connection dialog box does not appear. See the /O flag
for Oracle Spatial connections. The following examples illustrate the syntax of this flag. The first
example uses a data source (DSN), the second supplies the full connection string.
/S DSN=MyDataSource
/S
UID=MyId;DATABASE=MyDB;HOST=MyServer;SERVER=MyServer_tli;SERVICE=sqlexec;PROTOCOL=onsoctcp
The following example shows the syntax using a data source (FileDSN) with a user ID (UID) and
password (PWD).
/S FILEDSN=C:\Tenop\MyDataSource.dsn;UID=MyUserID;PWD=MyPassword
• /T MapInfo Table Name;Server Table Name;Range – Use this flag to pass a single table name to
the program. Use a semicolon symbol as the separator between the MapInfo table name, the server
name, and the range. The range is in the format starting number (COMMA) ending number. The server
table name and the range are optional.
Syntax: /T c:\data\states.tab;mystates;1,500
Note: Do not enclose file names in quotation marks.
• /U Do Not Create a Primary Index – Use this flag to add a primary key constraint by default. This
flag prevents a primary key from being created on the table. This flag is turned OFF by default, which
means that a primary key is created by default. See /I which controls the spatial index. For Oracle
Spatial tables, the primary key is created on the column MI_PRINX and is called table_name_PK. For
SpatialWare tables, the primary key is created on the column SW_MEMBER and is called
table_name_PK.
Syntax: /U
• /V Oracle Version – Use this flag to load tables on an Oracle 8.1.6 server with the 8.1.5 format. This
not generally recommended, but it is available if you have a special need to do this. If you want to
accomplish this using the graphical interface, see Mixing Command Line Flags with the EasyLoader
User Interface on page 21.
Syntax: /V
• /X Commit interval – Use this flag to specify a commit interval. EasyLoader commits the inserted
records when it reaches the commit interval you specify. The default commit interval is 1000. This
same interval applies to the creation of the spatial index for Oracle Spatial. If the commit interval is
set to 0 (zero), the whole range of records is inserted as a single transaction, before a commit is issued.
Syntax: /X 500
• /Y Style Column Name – Use this flag to specify whether per-row styles are being loaded with the
data. You can also specify the name of the column to be used. If you do not provide a name, the default
MI_STYLE column name is created. If you specify the NO_STYLE keyword after the /Y flag, EasyLoader
does not create a style column on the server table.
Syntax: /Y [StyleColumnName | NO_STYLE]
• /Z Always Geometry – Use this flag to specify that the table is to be uploaded as a Geometry data
type in Microsoft SQL Server Spatial, regardless of the coordinate system specified in the native table.
For more information, see Loading Microsoft SQL Server Spatial Data on page 11.
Syntax: /Z
20 EasyLoader 12.5
Chapter 1: Uploading Data with MapInfo EasyLoader
• If your database does not have a Map Catalog, you can use EasyLoader to create one.
• If your database has a Map Catalog already, you can delete entries in the catalog that are no longer
valid.
To create a new Map Catalog and delete entries from an existing Map Catalog:
1. Open EasyLoader. The EasyLoader dialog box displays.
If the Map Catalog is present and there are no entries in it, the Map Catalog button does not enable.
2. In the Connection Information box, identify the connection you either create the Map Catalog for
or delete Map Catalog entries from.
3. When you click the Map Catalog button, one of the following things happens:
If there is no Map Catalog available for the current database, EasyLoader creates the MapInfo Owner
and then creates the Map Catalog. This concludes the Map Catalog creation process.
If there is a Map Catalog, use the Unregister tables from Map Catalog dialog box to delete obsolete
tables from the list.
4. To identify the entries in the list you want to delete, select the data owner from the Owner drop-down
list and click the table or tables you want to unregister from the Map Catalog list.
5. Click the Unregister button. Click Close when you have completed this process.
SPATIALTYPE FLOAT
TABLENAME CHAR(32)
OWNERNAME CHAR(32)
SPATIALCOLUMN CHAR(32)
DB_X_LL FLOAT
DB_Y_LL FLOAT
DB_X_UR FLOAT
DB_Y_UR FLOAT
VIEW_X_LL FLOAT
VIEW_Y_LL FLOAT
VIEW_X_UR FLOAT
VIEW_Y_UR FLOAT
22 EasyLoader 12.5
Chapter 1: Uploading Data with MapInfo EasyLoader
COORDINATESYSTEM CHAR(254)
SYMBOL CHAR(254)
XCOLUMNNAME CHAR(32)
YCOLUMNNAME CHAR(32)
RENDITIONTYPE INTEGER
RENDITIONCOLUMN CHAR(32)
RENDITIONTABLE CHAR(32)
NUMBER_ROWS INTEGER
The following script, which is shipped with EasyLoader, may be used to modify an existing
MAPINFO.MAPINFO_MAPCATALOG to add the rendition columns if they do not exist. Run this script
as user MAPINFO.
26 EasyLoader 12.5
Index
C M
columns, Time and DateTime 17 MAPINFO_MAPCATALOG 22
commandline flags 18–21 table structure 22
/A Append All Tables to One 18 using 22
/B Schema Name 18 MICODE type option 15
/C Create Indices for All Locally-Indexed Columns
18
/D .tab File Directory for Server Table(s) 18
O
/E Exclusive Use of Table 18 ODBC connection to data 13
/F Log File name 18 options, spatial object types 15
/G Grant all 19 Oracle Spatial data 10
/I Do Not Create a Spatial Index 19
/K Create Automated Key Column for SQL Server
19 P
/L List of MapInfo tables 19
PostGIS Spatial data 13
/M MICODE/XY 19
processing 14–15
/O Connection String 19
server tables 15
/P A | C | R 19
tables 14
/Q Quit 19
/S Connection String 20
/T MapInfo Table Name;Server Table Name;Range R
20
/U Do Not Create a Primary Index 20 remote database connections via ODBC 13
/V Oracle Version 20
/X Commit interval 20 S
/Y Style Column Name 20
/Z Always Geometry 20 SpatialWare type option 15
mixing with user interface 21 SQL Server Spatial data 11
connecting to remote databases 13
T
D
Time information, uploading 17
data 8, 10–11, 13
Oracle Spatial 10
PostGIS Spatial 13 U
SQL Server Spatial 11 uploading .tab files 9
updating 8
DateTime information, uploading 17
V
F Validating PostGIS Data 13
feature history 6
flags, commandline 18 X
XY type option 15
28 EasyLoader 12.5