sa_migrate_create_remote_table_list system procedure

Populates the dbo.migrate_remote_table_list table.

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

  • 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. See CREATE SERVER statement.

  • 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.

Remarks

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. See sa_migrate_create_fks system procedure.

Permissions

None

Side effects

None

See also
Example

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 );
Copyright © 2008, iAnywhere Solutions, Inc. - SQL Anywhere 11.0.0