Hologres:INSERT

Sintaksis

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

Cara kerja

Mode penyimpanan tabel Hologres mencakup penyimpanan berorientasi baris, penyimpanan berorientasi kolom, dan penyimpanan hibrida baris-kolom. Ketiga mode penyimpanan ini memiliki prinsip penulisan yang sama.

Batasan

• Jika Anda memasukkan data ke tabel partisi, pastikan data dimasukkan ke tabel anak, bukan ke tabel induk. Nilai field partisi dalam data yang akan dimasukkan harus sama dengan nilai field partisi dari tabel anak tersebut.

• Anda dapat menyesuaikan urutan nama kolom yang tercantum. Jika Anda menggunakan pernyataan INSERT INTO SELECT untuk memasukkan data, pastikan tipe data kolom yang diperlukan konsisten dengan tipe data kolom yang Anda kueri.

Contoh

• Masukkan data ke tabel internal.

  CREATE TABLE  holotest (
      a int,
      b bigint,
      c bool,
      e decimal(38,10),
      f text,
      g timestamp,
      h timestamptz,
      i jsonb,
      j int[]
  );
  
  -- Opsional. Kami menyarankan Anda menggunakan fitur Serverless Computing untuk mengimpor data dalam jumlah besar secara offline dan menjalankan pekerjaan ekstrak, transformasi, dan muat (ETL).
  SET hg_computing_resource = 'serverless';
  
  -- Impor data.
  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]);
  
  -- Atur ulang konfigurasi. Ini memastikan bahwa sumber daya komputasi tanpa server tidak digunakan untuk pernyataan SQL berikutnya. 
  RESET hg_computing_resource;

• Masukkan data dari tabel a ke tabel b.

  CREATE TABLE holotest2(
      a int,
      b bigint,
      c bool);
  
  -- Opsional. Kami menyarankan Anda menggunakan fitur Serverless Computing untuk mengimpor data dalam jumlah besar secara offline dan menjalankan pekerjaan ETL.
  SET hg_computing_resource = 'serverless';
  
  -- Impor data.
  INSERT INTO holotest2 (a,b,c) SELECT a,b,c FROM holotest;
  
  -- Atur ulang konfigurasi. Ini memastikan bahwa sumber daya komputasi tanpa server tidak digunakan untuk pernyataan SQL berikutnya. 
  RESET hg_computing_resource;

• Masukkan data ke dalam tabel partisi.

  -- Buat tabel induk tanpa primary key dan tabel anaknya di schema 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;
  
  -- Opsional. Kami menyarankan Anda menggunakan fitur Serverless Computing untuk mengimpor data dalam jumlah besar secara offline dan menjalankan pekerjaan ETL.
  SET hg_computing_resource = 'serverless';
  
  -- Masukkan data ke tabel anak.
  INSERT INTO public.hologres_2022 values('2022',1,now(),'a')
  
  -- Atur ulang konfigurasi. Ini memastikan bahwa sumber daya komputasi tanpa server tidak digunakan untuk pernyataan SQL berikutnya. 
  RESET hg_computing_resource;

FAQ

• Pertanyaan 1: Saat saya menulis data dalam jumlah besar, utilisasi CPU dan penggunaan memori instans mencapai 100%. Hal ini berdampak negatif terhadap penulisan data dan kueri pada instans. Apa yang harus saya lakukan?

  Kami menyarankan Anda menggunakan fitur Serverless Computing saat ingin menulis data dalam jumlah besar.

  Catatan

  Hologres V2.1.17 dan versi setelahnya mendukung fitur Serverless Computing. Fitur Serverless Computing cocok untuk skenario seperti impor data offline dalam jumlah besar, menjalankan pekerjaan ETL skala besar, atau mengkueri data dalam jumlah besar menggunakan tabel eksternal. Anda dapat menggunakan sumber daya komputasi tanpa server alih-alih sumber daya instans yang telah dialokasikan untuk menjalankan operasi tersebut. Tidak diperlukan alokasi sumber daya komputasi tambahan. Hal ini meningkatkan stabilitas instans dan mengurangi kemunculan error kehabisan memori (OOM). Anda hanya dikenai biaya berdasarkan sumber daya komputasi tanpa server yang digunakan oleh tugas. Untuk informasi selengkapnya mengenai fitur Serverless Computing, lihat Serverless computing. Untuk informasi selengkapnya mengenai cara menggunakan fitur Serverless Computing, lihat Bekerja dengan serverless computing.

• Pertanyaan 2: Metrik yang menunjukkan penggunaan penyimpanan meningkat secara signifikan saat saya menulis data, tetapi berkurang setelah data selesai ditulis. Mengapa demikian?

  Berdasarkan prinsip penulisan data, untuk mempercepat penulisan data, Hologres menulis data di backend serta melakukan kompresi dan pengurutan data saat compaction asinkron dilakukan. Oleh karena itu, penggunaan penyimpanan meningkat secara signifikan selama proses penulisan data. Setelah proses penulisan data dan compaction selesai, penggunaan penyimpanan berkurang.

• Pertanyaan 3: Mengapa latensi meningkat jika beberapa pernyataan INSERT dieksekusi secara paralel pada tabel yang sama?

  Jika pernyataan INSERT dieksekusi pada tabel tanpa menggunakan fixed plan, tabel tersebut akan dikunci. Eksekusi paralel pernyataan INSERT meningkatkan durasi tunggu kunci, sehingga menyebabkan peningkatan latensi.

• Pertanyaan 4: Mengapa pesan error ERROR: no partition of relation "<table_name>" found for row muncul saat saya menulis data ke tabel induk?

  • Deskripsi masalah: Muncul pesan error ERROR: no partition of relation "<table_name>" found for row.

  • Penyebab: Tidak ada tabel anak.

  • Solusi: Sebelum menulis data, buat tabel anak dengan mengeksekusi pernyataan berikut:

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

• Pertanyaan 5: Mengapa pesan error Currently inserting into parent table is not supported muncul saat saya mengimpor data?

  • Deskripsi masalah: Muncul pesan error Currently inserting into parent table is not supported saat saya mengimpor data.

  • Penyebab: Tabel tempat Anda ingin memasukkan data adalah tabel induk. Hologres tidak mengizinkan Anda menulis data ke tabel induk.

  • Solusi: Buat tabel anak dan tulis data ke tabel anak tersebut.