CREATE PUBLICATION 文 [Mobile Link] [SQL Remote]

パブリケーションを作成します。Mobile Link では、パブリケーションが SQL Anywhere リモートデータベース内の同期データを識別します。SQL Remote では、統合データベース内とリモートデータベース内の両方のレプリケートされたデータがパブリケーションによって識別されます。

構文 1 (Mobile Link の一般的な使用方法)

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

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

構文 2 (Mobile Link のスクリプト化されたアップロード)

CREATE PUBLICATION  [ IF NOT EXISTS ] [ 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 (Mobile Link のダウンロードのみパブリケーション)

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

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

構文 4 (SQL Remote)

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

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

パラメータ

IF NOT EXISTS 句 IF NOT EXISTS 句を指定し、指定したパブリケーションがすでに存在する場合、変更は行われず、エラーは返されません。
article-definition パブリケーションは複数のアーティクルで構成されています。各アーティクルで、パブリケーションに含まれる単一のテーブルのローとカラムが識別されます。CONTAINS クエリ内のすべてのカラム参照は、同じテーブルを参照しなければなりません。
アーティクルにカラム名のリストが含まれている場合、それらのカラムがパブリケーションに含まれます。カラム名がリストに含まれない場合、テーブル内のすべてのカラムがパブリケーションに含まれます。Mobile Link の同期の場合、カラム名がリストされないと、テーブルのプライマリキーのすべてのカラムをリストに含める必要があります。

構文 2 では、スクリプト化されたアップロードを実行するパブリケーションに使用されます。また、アーティクルの記述によって、アップロードの定義に使用するスクリプトも登録します。

構文 3 は、ダウンロードのみのパブリケーションに使用されます。また、アーティクルはダウンロードするテーブルとカラムのみを指定します。
WHERE 句 WHERE 句を使用すれば、テーブルローのサブセットをアーティクルに含めるように定義することができます。
Mobile Link アプリケーションでは、WHERE 句はアップロードに含まれているローに影響します (ダウンロードについては download_cursor スクリプトで定義されます)。Mobile Link の SQL Anywhere リモートデータベースでは、WHERE 句は、アーティクルに含まれているカラムのみを参照できます。また、サブクエリ、変数、または非決定的関数を含めることはできません。
SUBSCRIBE BY 句 SQL Remote の場合、アーティクルに含めるテーブルローのサブセットを定義するには、SUBSCRIBE BY 句を使用する方法があります。この句を使用すると単一のパブリケーション定義を使って複数のサブスクライバが 1 つのテーブルの別々のローを受信できます。

備考

CREATE PUBLICATION 文はデータベースにパブリケーションを作成します。所有者名を指定すれば、別のユーザのパブリケーションも作成できます。

Mobile Link では、パブリケーションは SQL Anywhere リモートデータベースでは必須で、Ultra Light データベースではオプションです。このようなパブリケーションとそれに対するサブスクリプションによって、Mobile Link サーバにアップロードされるデータが決定されます。

Mobile Link パブリケーションのオプションは、CREATE SYNCHRONIZATION SUBSCRIPTION 文または ALTER SYNCHRONIZATION SUBSCRIPTION 文の ADD OPTION 句で設定します。

構文 2 はスクリプト化されたアップロードのパブリケーションを作成します。USING 句を使用して、アップロードの定義に使用するストアドプロシージャを登録します。各テーブルで、3 つまでのストアドプロシージャ (挿入、削除、更新用のプロシージャを 1 つずつ) を使用できます。

構文 3 は、トランザクションログファイルなしで同期できるダウンロード専用パブリケーションを作成します。ダウンロードのみのパブリケーションが同期されると、ダウンロードされたローは、リモートデータベースのローに加えられた変更を上書きします。

SQL Remote では、パブリッシュは双方向オペレーションなので、データは統合データベースとリモートデータベースのどちらへでも入力できます。SQL Remote インストール環境では、統合データベースとすべてのリモートデータベースのパブリケーション定義は同じにします。統合データベースで SQL Remote 抽出ユーティリティを実行すると、リモートデータベースで自動的に正しい CREATE PUBLICATION 文が実行されます。

すべての構文では、その文を実行するために文内で参照されるすべてのテーブルに対して、排他的にアクセスできる権限が必要です。

CREATE PUBLICATION pub_contact (
   TABLE GROUPO.Contacts,
   TABLE GROUPO.Customers
);

次の文は、1 つのテーブルの一部のカラムのみをパブリッシュします。

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

次の文は、Customers テーブルの Status カラムを検証する WHERE 句を組み込んで、ニューヨーク (NY) に在住する顧客のローのみをパブリッシュします。

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

次の文は、subscribe-by 値を与えて一部のローのみをパブリッシュします。この方法を使用できるのは、SQL Remote の場合のみです。

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

subscribe-by 値は、SQL Remote サブスクリプションの作成時に次のように使用されます。

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

次の例は、スクリプト化されたアップロードを使用する Mobile Link パブリケーションを作成します。

CREATE PUBLICATION pub WITH SCRIPTED UPLOAD (
      GROUPO.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
      ),
      GROUPO.TABLE t2 AS my_t2 USING (
         PROCEDURE my.t2_ui FOR UPLOAD INSERT
      )
   );

次の例は、ダウンロードのみのパブリケーションを作成します。

CREATE PUBLICATION p1 FOR DOWNLOAD ONLY (
   GROUPO.TABLE t1
);

DocCommentXchange で意見交換できます