Click here to view and discuss this page in DocCommentXchange. In the future, you will be sent there automatically.

SQL Anywhere 11.0.1 (中文) » SQL Anywhere 服务器 - SQL 参考 » 系统对象 » 系统过程 » 按字母顺排序的系统过程列表

 

sa_migrate 系统过程

将一组远程表迁移到 SQL Anywhere 数据库中。

语法
sa_migrate( 
 base_table_owner,
 server_name
 [, table_name ]
 [, owner_name ]
 [, database_name ]
 [, migrate_data ]
 [, drop_proxy_tables ]
 [, migrate_fkeys ]
)
参数
  • base_table_owner   使用此 VARCHAR(128) 参数指定在目标 SQL Anywhere 数据库中拥有迁移表的用户。使用 GRANT CONNECT 语句创建此用户。此参数需要值。请参见GRANT 语句

  • server_name   使用此 VARCHAR(128) 参数指定用于连接到远程数据库的远程服务器的名称。使用 CREATE SERVER 语句创建此服务器。此参数需要值。请参见CREATE SERVER 语句

  • table_name   如果要迁移单个表,请使用此 VARCHAR(128) 参数指定表名。否则,应该为此参数指定 NULL(缺省值)。不要将 table_name 和 owner_name 参数都指定为 NULL。

  • owner_name   如果只迁移属于一个所有者的表,请使用此 VARCHAR(128) 参数指定该所有者的名称。否则,应该为此参数指定 NULL(缺省值)。不要将 table_name 和 owner_name 参数都指定为 NULL。

  • database_name   使用此 VARCHAR(128) 参数指定远程数据库的名称。如果想仅迁移远程服务器上的一个数据库中的表,必须指定数据库名。否则,为此参数输入 NULL(缺省值)。

  • migrate_data   使用此可选的 BIT 参数指定是否迁移远程表中的数据。此参数可为 0(不迁移数据)或 1(迁移数据)。缺省情况下迁移数据。 (1)

  • drop_proxy_tables   使用此可选的 BIT 参数指定在迁移完成后是否删除为迁移进程所创建的代理表。此参数可为 0(不删除代理表)或 1(删除代理表)。缺省情况下删除代理表 (1)。

  • migrate_fkeys   使用此可选的 BIT 参数指定是否迁移外键映射。此参数可为 0(不迁移外键映射)或 1(迁移外键映射)。缺省情况下迁移外键映射 (1)。

注释

可以使用此过程将表从远程 Oracle、DB2、SQL Server、Adaptive Server Enterprise 或 SQL Anywhere 数据库迁移到 SQL Anywhere 中。使用此过程,仅需要一步,即可从指定的服务器迁移一组远程表,包括它们的外键映射。sa_migrate 系统过程调用以下系统过程:

如果需要更大的灵活性,可能需要使用这些系统过程而不是 sa_migrate。例如,如果迁移外键关系由不同用户拥有的表,则使用 sa_migrate 时无法保持外键关系。

在可以迁移任何表之前,必须先使用 CREATE SERVER 语句创建远程服务器以连接到远程数据库。可能还需要使用 CREATE EXTERNLOGIN 语句创建到远程数据库的外部登录。请参见CREATE SERVER 语句CREATE EXTERNLOGIN 语句

可通过仅指定 base_table_ownerserver_name 参数,将所有表从远程数据库迁移到 SQL Anywhere 数据库。然而,如果仅指定这两个参数,所有迁移的表都将属于目标 SQL Anywhere 数据库中的一个所有者。如果表在远程数据库上有不同的所有者,并且您希望它们在 SQL Anywhere 数据库上有不同的所有者,则必须分别为每个所有者迁移表,每次调用 sa_migrate 过程时都指定 base_table_ownerowner_name 参数。

小心

不要将 table_nameowner_name 参数都指定为 NULL。为 table_nameowner_name 参数提供 NULL 值将迁移数据库中的所有表,包括系统表。此外,远程数据库中那些名称相同但所有者不同的表在目标数据库中均属同一所有者。建议您一次只迁移与一个所有者关联的表。

权限

副作用

另请参见
示例

以下语句迁移远程数据库中所有属于用户 p_chin 的表(包括外键映射),迁移远程表中的数据,并且在迁移完成后删除代理表。此例中,所有迁移的表都属于目标 SQL Anywhere 数据库中的 local_user。

CALL sa_migrate( 'local_user', 'server_a', NULL, 'p_chin', NULL, 1, 1, 1 );

以下语句仅迁移远程数据库中属于用户 remote_a 的表。在目标 SQL Anywhere 数据库中,这些表属于用户 local_a。完成时不会删除在迁移阶段创建的代理表。

CALL sa_migrate( 'local_a', 'server_a', NULL, 'remote_a', NULL, 1, 0, 1 );