5.8 pgxa_create

機能

カラムナデータベース上のテーブルを作成します。

書式

pgxa_create_table(tablename)

引数

引数	データ型	意味
tablename	text	テーブル名(外部テーブル名)

戻り値

戻り値	意味
TRUE	正常終了
FALSE	異常終了

実行例

> psql postgres
psql (x.y.z)
Type "help" for help.

postgres=# SELECT pgxa_create_table('scm.tbl1');
 pgxa_create_table
-------------------
 t
(1 row)

x.y.z : PostgreSQLのバージョンが表示されます。

説明

テーブル名は、事前に定義した外部テーブル名を指定してください。
外部テーブルの定義方法を以下に示します。

構文：

CREATE FOREIGN TABLE [スキーマ名(注1)].[テーブル名] ([項目情報1],[項目情報2],...,[項目情報N]) SERVER dwh_server OPTIONS (database 'symfoas', schema 'symfoasuser', table '[データベース名]_[スキーマ名(注2)]_[テーブル名]')

(注1)スキーマがpublicの場合、省略可能です。

(注2)スキーマがpublicの場合も必ず指定してください。

定義例：

CREATE FOREIGN TABLE scm.tbl1 (col1 int NOT NULL,col2 char(1),col3 char(1) NOT NULL) SERVER dwh_server OPTIONS (database 'symfoas', schema 'symfoasuser', table 'db01_scm_tbl1')

事前に外部テーブルを定義する際に指定できる列のデータ型は、“利用ガイド”の“データ形式”を参照してください。
未定義の外部テーブル名を指定した場合はエラーとなります。
既にカラムナテーブルが定義済の場合はエラーとなります。
作成したカラムナテーブルがBIツールから参照できない場合は、カラムナテーブルに対するビュー表を定義し、BIツールからは定義したビュー表を参照するようにしてください。
ビュー表の定義方法は、“5.10 pgxa_create_view”を参照してください。

注意

CREATE FOREIGN TABLE文で外部テーブルを作成するときに指定するスキーマ名、外部テーブル名、カラム名などには、半角英数字だけを使用してください。
また、外部テーブルに対するビュー名、インデックス名などには半角英数字だけを使用してください。
使用可能文字の詳細は、“利用ガイド”の“定量制限”を参照してください。
外部テーブルに対して以下のパラメーターを指定すると、クエリ実行時は照合順序、デフォルト値、検査制約が無視されます。
- COLLATE句
- DEFAULT句
- CONSTRAINT句
- CHECK句

5.8 pgxa_create_table