此语句用于创建发布。在 MobiLink 中，发布可以标识 SQL Anywhere 远程数据库中的同步数据。在 SQL Remote 中，发布可以标识统一数据库和远程数据库中的复制数据。

语法 1（MobiLink 通用）

CREATE PUBLICATION [ owner.]publication-name
( article-definition, ... )

article-definition :
  TABLE table-name [ ( column-name, ... ) ]
[ WHERE search-condition ]

语法 2（MobiLink 脚本式上载）

CREATE PUBLICATION [ owner.]publication-name
WITH SCRIPTED UPLOAD 
( article-definition, ... )

article-definition :
  TABLE table-name [ ( column-name, ... ) ] 
[ USING ( [ PROCEDURE ] [ owner.][procedure-name ] 
   FOR UPLOAD { INSERT | DELETE | UPDATE }, ... ) ]

语法 3（MobiLink 仅下载发布）

CREATE PUBLICATION [ owner.]publication-name
FOR DOWNLOAD ONLY
( article-definition, ... )

article-definition :  TABLE table-name [ ( column-name, ... ) ]

语法 4 (SQL Remote)

CREATE PUBLICATION [ owner.]publication-name
( article-definition, ... )

article-definition :
  TABLE table-name [ ( column-name, ... ) ]
[ WHERE search-condition ]
[ SUBSCRIBE BY expression ]

参数

注释

CREATE PUBLICATION 语句可在数据库中创建一个发布。可以通过指定所有者名称为另一个用户创建发布。

在 MobiLink 中，发布在 SQL Anywhere 远程数据库中是必需的，而在 UltraLite 数据库中却是可选的。这些发布以及对它们的预订决定了将哪些数据上载到 MobiLink 服务器。

应使用 CREATE SYNCHRONIZATION SUBSCRIPTION 语句或 ALTER SYNCHRONIZATION SUBSCRIPTION 语句中的 ADD OPTION 子句为 MobiLink 发布设置选项。

语法 2 创建用于脚本式上载的发布。USING 子句用于注册想要用于定义上载的存储过程。对于每个表，最多可使用三个存储过程：分别用于插入、删除和更新。

语法 3 创建可在没有日志文件的情况下进行同步的仅下载发布。当同步仅下载发布时，下载行可能会覆盖对远程数据库中的那些行所做的更改。

在 SQL Remote 中，发布是一种双向操作，因为在统一数据库和远程数据库中都可以输入数据。在 SQL Remote 安装中，任何统一数据库和所有远程数据库都必须定义相同的发布。从统一数据库运行 SQL Remote 抽取实用程序时，将在远程数据库中自动执行正确的 CREATE PUBLICATION 语句。

权限

必须具有 DBA 权限。要求可以对语句中引用的所有表进行独占访问。

副作用

自动提交。

另请参见

• ALTER PUBLICATION 语句 [MobiLink] [SQL Remote]
• DROP PUBLICATION 语句 [MobiLink] [SQL Remote]
• CREATE SYNCHRONIZATION SUBSCRIPTION 语句 [MobiLink]
• ALTER SYNCHRONIZATION SUBSCRIPTION 语句 [MobiLink]
• SQL Anywhere MobiLink 客户端： 发布数据
• UltraLite MobiLink 客户端： UltraLite CREATE PUBLICATION 语句
• SQL Remote： 发布和项目
• 脚本式上载
• 仅下载发布
• ISYSSYNC 系统表

标准和兼容性

示例

下面的语句发布两个表中的所有列和行。

CREATE PUBLICATION pub_contact (
   TABLE Contacts,
   TABLE Company
);

下列语句仅发布一个表中的某些列。

CREATE PUBLICATION pub_customer (
   TABLE Customers ( ID, CompanyName, City )
);

下列语句包含一个测试 Customers 表 Status 列的 WHERE 子句，因此只发布活动的客户行。

CREATE PUBLICATION pub_customer (
   TABLE Customers ( ID, CompanyName, City, State, Status )
   WHERE Status = 'active'
);

下列语句提供预订者值，因此仅发布某些行。此方法只能在 SQL Remote 中使用。

CREATE PUBLICATION pub_customer (
   TABLE Customers ( ID, CompanyName, City, State )
   SUBSCRIBE BY State
);

创建 SQL Remote 预订时，按如下所示使用预订者值。

CREATE SUBSCRIPTION TO pub_customer ( 'NY' )
   FOR jsmith;

下例创建使用脚本式上载的 MobiLink 发布：

CREATE PUBLICATION pub WITH SCRIPTED UPLOAD (
      TABLE t1 (a, b, c) USING (
         PROCEDURE my.t1_ui FOR UPLOAD INSERT,
         PROCEDURE my.t1_ud FOR UPLOAD DELETE,
         PROCEDURE my.t1_uu FOR UPLOAD UPDATE
      ),
      TABLE t2 AS my_t2 USING (
         PROCEDURE my.t2_ui FOR UPLOAD INSERT
      )
   );

以下示例创建仅下载发布：

CREATE PUBLICATION p1 FOR DOWNLOAD ONLY (
   TABLE t1
);