CREATE TABLE LIKE ステートメントを実行すると、指定した SELECT ステートメントの実行結果と同じスキーマを持つテーブルを作成できます。このトピックでは、CREATE TABLE LIKE ステートメントの実行方法について説明します。
制限事項
-
Hologres V0.9 以前のバージョンでは、
CREATE TABLE LIKEステートメントでコピーできるのはテーブルスキーマのみで、プライマリキーやインデックスなどのテーブルプロパティはコピーできません。Hologres インスタンスのバージョンは、Hologres コンソールのインスタンス詳細ページで確認できます。 -
Hologres V0.10 以降のバージョンでは、
CREATE TABLE LIKEステートメントを実行して、テーブルスキーマと、プライマリキーやインデックスなどのテーブルプロパティの両方をコピーできます。テーブル作成時に別のテーブルからテーブルプロパティをコピーするには、次のコマンドを実行して関連する Grand Unified Configuration (GUC) パラメータを true に設定する必要があります。その後、CREATE TABLE LIKEステートメントでSELECT * FROM <table_name>ステートメントを使用する必要があります。SELECT <column_1>, <column_2> FROM <table_name>など、他の SELECT ステートメントはサポートされていません。set hg_experimental_enable_create_table_like_properties=true; -
CREATE TABLE LIKEステートメントでは、ソーステーブルからデータを同期することはできません。 -
SELECT ステートメントで列を指定する場合は、各列に一意のエイリアスを指定する必要があります。異なる列に同じエイリアスを指定すると、CREATE TABLE LIKE ステートメントが同じ名前の列を複数作成してしまい、エラーメッセージが返されます。ステートメントの例:
CALL hg_create_table_like('new_table', 'select *, 1 as c, ''a'' as c from src_table'); ERROR: column "c" specified more than once CONTEXT: SQL statement "create table new_table ( "a" integer, "b" text, "c" integer, "c" text );" PL/pgSQL function hg_create_table_like(text,text) line 22 at EXECUTE -
CREATE TABLE LIKEステートメントを実行すると、列のコメントとバイナリログのプロパティをコピーできます。テーブルのコメントや動的パーティション分割のプロパティはコピーできません。V3.0.33 以降、テーブルのコメントのコピーもサポートされています。
構文
Hologres では、CREATE TABLE LIKE ステートメントは次の構文です:
-- プロパティなしで標準テーブルをコピー。この方法では、論理パーティションテーブルのパーティションプロパティはコピーされない。
CALL hg_create_table_like('new_table_name', 'select_query');
-- 物理パーティションテーブルをコピー。他のテーブルプロパティはコピーされない。
CALL hg_create_table_like('new_table_name', 'select_query', 'partition_clause');
-- テーブルとそのプロパティをコピー。この方法を使用して、論理パーティションテーブルのパーティションプロパティをコピーする。
set hg_experimental_enable_create_table_like_properties=true; -- セッションレベルのパラメータ。
CALL hg_create_table_like('new_table_name', 'select * from old_table_name');
hg_create_table_like を呼び出すと、Hologres は new_table_name という名前のテーブルを作成します。このテーブルのスキーマは select_query の結果と一致します。新しいテーブルにデータは挿入されません。
[メトリックの説明]
-
new_table_name:作成するテーブルの名前。値は文字列リテラルでなければなりません。変数、文字列連結、および関数はサポートされていません。CREATE TABLE LIKE を使用して外部テーブルを作成することはできません。
-
select_query:クエリ文。ステートメントが厳密に
select * from tablenameである場合、CREATE TABLE LIKEはプライマリキーやインデックスを含むソーステーブルのすべてのプロパティもコピーします。ステートメントに多くの一重引用符 (') が含まれている場合は、一重引用符が自動的にエスケープされるように、$$query_sql$$としてラップすることを推奨します。例:CALL HG_CREATE_TABLE_LIKE ('table_name', $$query_sql$$ [, 'partition_clause']) -
partition_clause:パーティションキーを指定するパーティション句。子パーティションは自動的に作成されません。手動で作成する必要があります。
-
old_table_name:コピーするソーステーブルの名前。
例
次の例では、このソーステーブルを使用します:
BEGIN;
CREATE TABLE public.src_table (
"a" int8 NOT NULL,
"b" text NOT NULL,
PRIMARY KEY (a)
);
CALL SET_TABLE_PROPERTY('public.src_table', 'orientation', 'column');
CALL SET_TABLE_PROPERTY('public.src_table', 'bitmap_columns', 'b');
CALL SET_TABLE_PROPERTY('public.src_table', 'dictionary_encoding_columns', 'b:auto');
CALL SET_TABLE_PROPERTY('public.src_table', 'time_to_live_in_seconds', '3153600000');
CALL SET_TABLE_PROPERTY('public.src_table', 'distribution_key', 'a');
CALL SET_TABLE_PROPERTY('public.src_table', 'storage_format', 'segment');
COMMIT;
CREATE TABLE LIKE を使用して、ソーステーブルに基づいてテーブルを作成します。
-
ソーステーブルと同じスキーマとプロパティを持つテーブルを作成します。
-- テーブルスキーマとプロパティをコピーします。 set hg_experimental_enable_create_table_like_properties=true; CALL hg_create_table_like('new_table', 'select * from src_table'); -
ソーステーブルのスキーマに列を追加したテーブルを作成します。
-- 列bと同じ定義を持つ列cを追加します。 CALL hg_create_table_like('holo_table_1', $$select *, "b" as c from src_table$$); -
物理パーティションテーブルを作成し、その子パーティションを手動で作成します。
-- 列dsを追加し、物理パーティションテーブルのパーティションキーとして使用します。 CALL hg_create_table_like('new_table', $$select *, "b" as ds from src_table$$, 'partition by list(ds)'); -- 子パーティションを作成します。 create table new_table_child_20201213 partition of new_table for values in('20201213'); -- パーティション値:20201213 create table new_table_child_20201214 partition of new_table for values in('20201214'); -- パーティション値:20201214 -
パーティションテーブルから一時テーブルを作成し、子パーティションとしてアタッチします。
-- パーティション化された親テーブルを作成します。 BEGIN; CREATE TABLE public.src_parent_table ( "a" int NOT NULL, "b" text NOT NULL, PRIMARY KEY (a,b) ) PARTITION BY LIST(a); CALL SET_TABLE_PROPERTY('public.src_parent_table', 'orientation', 'column'); CALL SET_TABLE_PROPERTY('public.src_parent_table', 'bitmap_columns', 'b'); CALL SET_TABLE_PROPERTY('public.src_parent_table', 'dictionary_encoding_columns', 'b:auto'); CALL SET_TABLE_PROPERTY('public.src_parent_table', 'time_to_live_in_seconds', '3153600000'); CALL SET_TABLE_PROPERTY('public.src_parent_table', 'distribution_key', 'a'); CALL SET_TABLE_PROPERTY('public.src_parent_table', 'storage_format', 'segment'); COMMIT; -- 子パーティションを作成します。 CREATE TABLE public.src_child_table PARTITION OF public.src_parent_table FOR VALUES IN (20220101); -- 親テーブルと子パーティションからプロパティを継承するテーブルを作成します。 set hg_experimental_enable_create_table_like_properties=true; CALL hg_create_table_like('like_child_table', 'select * from src_child_table'); -- 新しいテーブルを子パーティションとして親テーブルにアタッチします。 ALTER TABLE src_parent_table ATTACH PARTITION like_child_table FOR VALUES IN (20220103);
HoloWebコンソールでのテーブルのコピー
HoloWeb を使用すると、SQL ステートメントを記述することなく、視覚的にテーブルをコピーできます。手順:
-
HoloWeb コンソールに移動します。詳細については、「HoloWeb に接続して SQL クエリを実行する」をご参照ください。
-
[HoloWeb] ページのトップメニューバーで、メタデータ管理 をクリックします。
-
[メタデータ管理] ページの [Instances Connected] リストから、複製するテーブルを右クリックし、 テーブルスキーマのコピー を選択します。
-
テーブルスキーマのコピー タブで、次のパラメータを設定します。
セクション
パラメータ
説明
宛先場所
テーブル名
宛先テーブルの名前。カスタム名を指定できます。デフォルト値: ソーステーブル名_copy。
説明
宛先テーブルの説明。このパラメータはオプションです。
スキーマ
宛先テーブルが存在するスキーマの名前。デフォルト値: public。
詳細設定
ソーステーブルのプロパティを複製
ソーステーブルのプロパティを宛先テーブルにコピーするかどうかを指定します。
説明ソーステーブルプロパティの複製は、V0.10 以降を実行している Hologres インスタンスでのみサポートされています。以前のバージョンの場合は、いいえ を選択するか、インスタンスをアップグレードしてください。
-
右上隅の コミット をクリックして、複製したテーブルを作成します。
継承されるプロパティ
Hologres V2.0 以降では、CREATE TABLE LIKE でのテーブルプロパティの扱いは次のとおりです。
|
プロパティ |
継承 |
説明 |
|
binlog.level |
はい |
バイナリロギングが有効かどうかを指定します。 |
|
binlog.ttl |
はい |
バイナリログの Time-to-Live (TTL) (秒単位)。有効期限が切れたバイナリログは非同期に削除されます。 |
|
clustering_key |
はい |
ストレージ内のデータをソートするために使用される列。 |
|
distribution_key |
はい |
並列クエリのためにデータを分散するために使用される列。 |
|
encryption_options |
はい |
テーブルレベルの暗号化設定。 |
|
online_config_* |
はい |
再起動なしで有効になるテーブルプロパティ。ストレージの最適化やクエリの高速化に使用されます。 |
|
orientation |
はい |
ストレージ形式:行指向または列指向。 |
|
primary_key |
はい |
プライマリキー。 |
|
proxima_vectors |
はい |
ベクトルインデックス。 |
|
シリアル列 |
はい |
新しいシーケンスは作成されません。新しいテーブルはソーステーブルのシーケンスを使用します。 |
|
segment_key (event_time_column) |
はい |
ストレージファイルをフィルタリングするために使用される列。 |
|
storage_format |
はい |
ストレージファイル形式:sst、orc、または segment。 |
|
table_group |
はい |
テーブルのテーブルグループ。 |
|
table_storage_mode |
はい |
ホットまたはコールドストレージモード。 |
|
time_to_live_in_seconds |
はい |
テーブルデータの TTL (秒単位)。有効期限が切れたデータは非同期に削除されます。 |
|
mutate_type |
いいえ |
単一テーブルマテリアライズドビューが作成されるテーブルでは、mutate_type を appendonly に設定する必要があります。 |
|
shared_readonly |
いいえ |
テーブルが読み取り専用かどうかを指定します。 |
|
readonly |
いいえ |
テーブルのスキーマとデータへの変更をブロックするかどうかを指定します。 |
|
matview |
いいえ |
単一テーブルマテリアライズドビューは継承されません。 |