すべてのプロダクト
Search
ドキュメントセンター

Hologres:CREATE TABLE LIKE

最終更新日:Oct 15, 2026

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 ステートメントを記述することなく、視覚的にテーブルをコピーできます。手順:

  1. HoloWeb コンソールに移動します。詳細については、「HoloWeb に接続して SQL クエリを実行する」をご参照ください。

  2. [HoloWeb] ページのトップメニューバーで、メタデータ管理 をクリックします。

  3. [メタデータ管理] ページの [Instances Connected] リストから、複製するテーブルを右クリックし、 テーブルスキーマのコピー を選択します。

  4. テーブルスキーマのコピー タブで、次のパラメータを設定します。

    セクション

    パラメータ

    説明

    宛先場所

    テーブル名

    宛先テーブルの名前。カスタム名を指定できます。デフォルト値: ソーステーブル名_copy。

    説明

    宛先テーブルの説明。このパラメータはオプションです。

    スキーマ

    宛先テーブルが存在するスキーマの名前。デフォルト値: public。

    詳細設定

    ソーステーブルのプロパティを複製

    ソーステーブルのプロパティを宛先テーブルにコピーするかどうかを指定します。

    説明

    ソーステーブルプロパティの複製は、V0.10 以降を実行している Hologres インスタンスでのみサポートされています。以前のバージョンの場合は、いいえ を選択するか、インスタンスをアップグレードしてください。

  5. 右上隅の コミット をクリックして、複製したテーブルを作成します。

継承されるプロパティ

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

いいえ

単一テーブルマテリアライズドビューは継承されません。