Hologres:INSERT

構文

INSERT INTO <schema>.<table> [( <column> [, ...] )]
   VALUES ( {<expression>}  [, ...] )
   [, ...] | <query>}

仕組み

Hologres テーブルのストレージモードには、行指向ストレージ、列指向ストレージ、行列ハイブリッドストレージがあります。これら 3 つのストレージモードでは、書き込みの原理は同じです。

使用制限

• パーティションテーブルにデータを挿入する場合、親テーブルではなく子テーブルにデータを挿入してください。挿入するデータのパーティションフィールドの値は、子テーブルのパーティションフィールドの値と同じである必要があります。

• 列名をリストする順序はカスタマイズできます。INSERT INTO SELECT 文を使用してデータを挿入する場合、必要な列のデータ型がクエリする列のデータ型と一致していることを確認してください。

例

• 内部テーブルにデータを挿入します。

  CREATE TABLE  holotest (
      a int,
      b bigint,
      c bool,
      e decimal(38,10),
      f text,
      g timestamp,
      h timestamptz,
      i jsonb,
      j int[]
  );
  
  -- オプション。 大量のデータをオフラインでインポートし、抽出、変換、ロード (ETL) ジョブを実行するには、サーバーレスコンピューティング機能を使用することを推奨します。
  SET hg_computing_resource = 'serverless';
  
  -- データをインポートします。
  INSERT INTO holotest VALUES (1,9223372036854775807,false,123.123456789123,'john','2020-01-01 01:01:01.123456',
  '2004-10-19 10:23:54+08','{"a":2}',ARRAY[1, 2, 3, 4]);
  
  -- 設定をリセットします。 これにより、後続の SQL 文でサーバーレスコンピューティングリソースが使用されなくなります。
  RESET hg_computing_resource;

• テーブル a のデータをテーブル b に挿入します。

  CREATE TABLE holotest2(
      a int,
      b bigint,
      c bool);
  
  -- オプション。 大量のデータをオフラインでインポートし、ETL ジョブを実行するには、サーバーレスコンピューティング機能を使用することを推奨します。
  SET hg_computing_resource = 'serverless';
  
  -- データをインポートします。
  INSERT INTO holotest2 (a,b,c) SELECT a,b,c FROM holotest;
  
  -- 設定をリセットします。 これにより、後続の SQL 文でサーバーレスコンピューティングリソースが使用されなくなります。
  RESET hg_computing_resource;

• パーティションテーブルにデータを挿入します。

  -- public スキーマに、プライマリキーのない親テーブルとその子テーブルを作成します。
  BEGIN;
  CREATE TABLE public.hologres_parent(
    a text,
    b int,
    c timestamp,
    d text
  )
    PARTITION BY list(a);
  CALL set_table_property('public.hologres_parent', 'orientation', 'column');
  
  CREATE TABLE public.hologres_2022 partition of public.hologres_parent for values in('2022');
  
  CREATE TABLE public.hologres_2021 partition of public.hologres_parent for values in('2021');
  
  CREATE TABLE public.hologres_2020 partition of public.hologres_parent for values in('2020');
  COMMIT;
  
  -- オプション。 大量のデータをオフラインでインポートし、ETL ジョブを実行するには、サーバーレスコンピューティング機能を使用することを推奨します。
  SET hg_computing_resource = 'serverless';
  
  -- 子テーブルにデータを挿入します。
  INSERT INTO public.hologres_2022 values('2022',1,now(),'a')
  
  -- 設定をリセットします。 これにより、後続の SQL 文でサーバーレスコンピューティングリソースが使用されなくなります。
  RESET hg_computing_resource;

よくある質問

• 質問 1：大量のデータを書き込むと、インスタンスの CPU 使用率とメモリ使用量が 100% になります。これにより、インスタンスでのデータ書き込みとクエリに悪影響が出ます。どうすればよいですか？

  大量のデータを書き込む場合は、サーバーレスコンピューティング機能を使用することを推奨します。

  説明

  Hologres V2.1.17 以降は、サーバーレスコンピューティング機能をサポートしています。サーバーレスコンピューティング機能は、大量のデータをオフラインでインポートしたり、大規模な ETL ジョブを実行したり、外部テーブルを使用して大量のデータをクエリしたりするシナリオに適しています。インスタンスの予約済みリソースではなく、サーバーレスコンピューティングリソースを使用して、上記の操作を実行できます。予約済みのコンピューティングリソースは必要ありません。これにより、インスタンスの安定性が向上し、メモリ不足 (OOM) エラーの発生が減少します。タスクで使用されるサーバーレスコンピューティングリソースに対してのみ課金されます。サーバーレスコンピューティング機能の詳細については、「サーバーレスコンピューティング」をご参照ください。サーバーレスコンピューティング機能の使用方法の詳細については、「サーバーレスコンピューティングの使用」をご参照ください。

• 質問 2：データを書き込むとストレージ使用量のメトリックが大幅に増加し、データの書き込み後に減少するのはなぜですか？

  データ書き込みの原理に基づき、データ書き込みを高速化するために、Hologres はバックエンドでデータを書き込み、非同期コンパクションが実行されるときにデータを圧縮およびソートします。したがって、データ書き込み中にストレージ使用量が大幅に増加します。データ書き込みとコンパクションが完了すると、ストレージ使用量は減少します。

• 質問 3：同じテーブルで複数のINSERT 文を並列に実行すると、レイテンシーが増加するのはなぜですか？

  固定実行計画を使用せずにテーブルでINSERT 文を実行すると、テーブルがロックされます。INSERT 文を並列実行すると、ロック待ち時間が増加し、結果としてレイテンシーが増加します。

• 質問 4：親テーブルにデータを書き込むときに、エラーメッセージERROR: no partition of relation "<table_name>" found for rowが返されるのはなぜですか？

  • 問題の説明：エラーメッセージERROR: no partition of relation "<table_name>" found for rowが返されます。

  • 原因：子テーブルが存在しません。

  • 解決策：データを書き込む前に、次の文を実行して子テーブルを作成してください。

    CREATE TABLE <child_table_name> partition of <parent_table_name> for values in (<value>);

• 質問 5：データをインポートするときに、エラーメッセージCurrently inserting into parent table is not supportedが返されるのはなぜですか？

  • 問題の説明：データをインポートするときに、エラーメッセージCurrently inserting into parent table is not supportedが返されます。

  • 原因：データを挿入しようとしているテーブルが親テーブルです。Hologres では、親テーブルへのデータ書き込みは許可されていません。

  • 解決策：子テーブルを作成し、その子テーブルにデータを書き込んでください。