sa_migrate_create_remote_table_list system procedure

sa_migrate_create_remote_table_list( 
  i_server_name
  [, i_table_name 
  [, i_owner_name 
  [, i_database_name ] ] ]
)

i_server_name Use this VARCHAR(128) parameter to specify the name of the remote server that is being used to connect to the remote database. The remote server is created with the CREATE SERVER statement. A value is required for this parameter.
i_table_name Use this optional VARCHAR(128) parameter to specify the name(s) of the tables that you want to migrate, or NULL to migrate all the tables. The default is NULL. Do not specify NULL for both the i_table_name and i_owner_name parameters.
i_owner_name Use this optional VARCHAR(128) parameter to specify the user who owns the tables on the remote database that you want to migrate, or NULL to migrate all the tables. The default is NULL. Do not specify NULL for both the i_table_name and i_owner_name parameters
i_database_name Use this optional VARCHAR(128) parameter to specify the name of the remote database from which you want to migrate tables. This parameter is NULL by default. When migrating tables from Adaptive Server Enterprise and Microsoft SQL Server databases, you must specify the database name.

This procedure populates the dbo.migrate_remote_table_list table with a list of tables that can be migrated from the remote database. You can delete rows from this table for remote tables that you do not want to migrate.

If you do not want all the migrated tables to have the same owner on the target SQL Anywhere database, you must execute this procedure for each user whose tables you want to migrate.

As an alternative, you can migrate all tables in one step using the sa_migrate system procedure.

Caution

Do not specify NULL for both the i_table_name and i_owner_name parameters. Supplying NULL for both the i_table_name and i_owner_name parameters migrates all the tables in the database, including system tables. As well, tables that have the same name, but different owners in the remote database all belong to one owner in the target database. It is recommended that you migrate tables associated with one owner at a time.

This system procedure is used in conjunction with several other migration system procedures. The note in the Remarks section of the sa_migrate_create_fks system procedure contains the list of migrate procedures, and the order in which you must execute them.

None

The following statement creates a list of tables that belong to the user remote_a on the remote database.

CALL sa_migrate_create_remote_table_list( 'server_a', NULL, 'remote_a', NULL );

sa_migrate_create_remote_table_list system procedure

Syntax

Arguments

Remarks

Caution

Permissions

Side effects

See also

Example