Hologres:INSERT

Sintaxis

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

Funcionamiento

Los modos de almacenamiento de las tablas de Hologres incluyen almacenamiento orientado a filas, almacenamiento orientado a columnas y almacenamiento híbrido de filas y columnas. Los tres modos de almacenamiento comparten el mismo principio de escritura.

Límites

• Si inserta datos en una tabla particionada, asegúrese de que los datos se inserten en una tabla hija y no en la tabla padre. El valor del campo de partición en los datos que se van a insertar debe coincidir con el valor del campo de partición de la tabla hija.

• Puede personalizar el orden en el que se enumeran los nombres de las columnas. Si utiliza la instrucción INSERT INTO SELECT para insertar datos, asegúrese de que los tipos de datos de las columnas requeridas coincidan con los tipos de datos de las columnas que consulta.

Ejemplos

• Insertar datos en una tabla interna.

  CREATE TABLE  holotest (
      a int,
      b bigint,
      c bool,
      e decimal(38,10),
      f text,
      g timestamp,
      h timestamptz,
      i jsonb,
      j int[]
  );
  
  -- Optional. We recommend that you use the Serverless Computing feature to import a large amount of data offline and run extract, transform, and load (ETL) jobs.
  SET hg_computing_resource = 'serverless';
  
  -- Import 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]);
  
  -- Reset the configurations. This ensures that serverless computing resources are not used for subsequent SQL statements. 
  RESET hg_computing_resource;

• Insertar datos de la tabla a en la tabla b.

  CREATE TABLE holotest2(
      a int,
      b bigint,
      c bool);
  
  -- Optional. We recommend that you use the Serverless Computing feature to import a large amount of data offline and run ETL jobs.
  SET hg_computing_resource = 'serverless';
  
  -- Import data.
  INSERT INTO holotest2 (a,b,c) SELECT a,b,c FROM holotest;
  
  -- Reset the configurations. This ensures that serverless computing resources are not used for subsequent SQL statements. 
  RESET hg_computing_resource;

• Insertar datos en una tabla particionada.

  -- Create a parent table that does not have a primary key and its child tables in the public schema.
  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;
  
  -- Optional. We recommend that you use the Serverless Computing feature to import a large amount of data offline and run ETL jobs.
  SET hg_computing_resource = 'serverless';
  
  -- Insert data into a child table.
  INSERT INTO public.hologres_2022 values('2022',1,now(),'a')
  
  -- Reset the configurations. This ensures that serverless computing resources are not used for subsequent SQL statements. 
  RESET hg_computing_resource;

Preguntas frecuentes

• Pregunta 1: Al escribir una gran cantidad de datos, el uso de CPU y memoria de la instancia alcanza el 100%. Esto afecta negativamente la escritura de datos y las consultas en la instancia. ¿Qué debo hacer?

  Se recomienda utilizar la función Serverless Computing cuando necesite escribir una gran cantidad de datos.

  Nota

  Hologres V2.1.17 y versiones posteriores son compatibles con la función Serverless Computing. Esta función es adecuada para escenarios en los que se requiere importar una gran cantidad de datos offline, ejecutar trabajos ETL a gran escala o consultar grandes volúmenes de datos mediante tablas externas. Puede utilizar recursos de cómputo serverless en lugar de los recursos reservados de las instancias para realizar estas operaciones. No se requieren recursos de cómputo reservados. Esto mejora la estabilidad de la instancia y reduce la aparición de errores de falta de memoria (OOM). Solo se le cobra por los recursos de cómputo serverless que utilicen las tareas. Para obtener más información sobre la función Serverless Computing, consulte Serverless computing. Para obtener más información sobre cómo utilizar la función Serverless Computing, consulte Work with serverless computing.

• Pregunta 2: La métrica que indica el uso de almacenamiento aumenta significativamente cuando escribo datos, pero disminuye después de que se completa la escritura. ¿Por qué sucede esto?

  Según el principio de escritura de datos, para acelerar este proceso, Hologres escribe los datos en el backend y los comprime y ordena cuando se realiza la compactación asíncrona. Por lo tanto, el uso de almacenamiento aumenta significativamente durante el proceso de escritura de datos. Una vez que finalizan los procesos de escritura y compactación, el uso de almacenamiento disminuye.

• Pregunta 3: ¿Por qué aumenta la latencia si se ejecutan varias instrucciones INSERT en paralelo sobre la misma tabla?

  Si se ejecuta la instrucción INSERT en una tabla sin utilizar un plan fijo, la tabla se bloquea. La ejecución paralela de instrucciones INSERT incrementa el tiempo de espera del bloqueo, lo que resulta en un aumento de la latencia.

• Pregunta 4: ¿Por qué se devuelve el mensaje de error ERROR: no partition of relation "<table_name>" found for row al escribir datos en una tabla padre?

  • Descripción del problema: Se reporta el mensaje de error ERROR: no partition of relation "<table_name>" found for row.

  • Causa: No existe ninguna tabla hija.

  • Solución: Antes de escribir datos, cree una tabla hija ejecutando la siguiente instrucción:

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

• Pregunta 5: ¿Por qué se devuelve el mensaje de error Currently inserting into parent table is not supported al importar datos?

  • Descripción del problema: Se reporta el mensaje de error Currently inserting into parent table is not supported al importar datos.

  • Causa: La tabla en la que intenta insertar datos es una tabla padre. Hologres no permite escribir datos directamente en una tabla padre.

  • Solución: Cree una tabla hija y escriba los datos en dicha tabla hija.