CREATE EXISTING TABLE [owner.]table-name
[ column-definition, ... ]
AT location-string

column-definition :
column-name data-type NOT NULL

location-string :
  remote-server-name.[db-name].[owner].object-name
| remote-server-name;[db-name];[owner];object-name

CREATE EXISTING TABLE 文は、外部のロケーションにあるテーブルに対応する、新しいローカルのプロキシテーブルを作成します。CREATE EXISTING TABLE 文は、CREATE TABLE 文の変形です。EXISTING キーワードを CREATE TABLE 文とともに使用すると、テーブルがすでにリモートに存在していることを指定して、そのメタデータをインポートするように指定できます。これにより、SQL Anywhere ユーザにとって可視のエンティティであるように、リモートテーブルが設定されます。このソフトウェアは、テーブルを作成する前に、外部ロケーションにテーブルが存在するかどうかを確認します。

オブジェクト (ホストデータファイルまたはリモートサーバオブジェクトのどちらかとして) が存在しない場合、この文は拒否されてエラーメッセージが出力されます。

ホストデータファイルまたはリモートサーバテーブルのインデックス情報が抽出され、システムテーブル ISYSIDX のローを作成するために使用されます。この情報により、サーバ関係のインデックスとキーが定義されて、クエリオプティマイザがこのテーブルに存在する可能性のあるすべてのインデックスを考慮できるようになります。

参照整合性制約は、必要に応じてリモートロケーションに渡されます。

column-definitions が指定されていない場合、SQL Anywhere は、リモートテーブルから取得するメタデータからカラムリストを引き出します。column-definitions が指定されている場合、SQL Anywhere は、その column-definitions を検証します。カラム名、データ型、長さ、IDENTITY プロパティ、NULL プロパティについて、次の点がチェックされます。

ユーザ本人が所有するプロキシテーブルを作成するには、CREATE PROXY TABLE システム権限が必要です。他のユーザが所有するプロキシテーブルを作成するには、CREATE ANY TABLE または CREATE ANY OBJECT のシステム権限が必要です。

オートコミット。

• CREATE TABLE 文
• プロキシテーブルのロケーション

リモートサーバ server_a にある blurbs テーブルのプロキシテーブル blurbs を作成します。

CREATE EXISTING TABLE blurbs
( author_id ID not null,
copy text not null)
AT 'server_a.db1.joe.blurbs';

リモートサーバ server_a にある blurbs テーブルのプロキシテーブル blurbs を作成します。データベースサーバは、リモートテーブルから取得したメタデータからカラムリストを取り出します。

CREATE EXISTING TABLE blurbs
AT 'server_a.db1.joe.blurbs';

リモートサーバ rda にある Employees テーブルのプロキシテーブル rda_employees を作成します。

CREATE EXISTING TABLE rda_employees
AT 'rda...Employees';

リモートサーバ server_a に存在する SQL 変数 table_name によって指定されたテーブルのプロキシテーブル rda_employees を作成します。

CREATE EXISTING TABLE rda_employees
AT 'rda...{table_name}';