INSERT

Cikk
04/22/2024

A következőkre vonatkozik: jelölje be az igennel jelölt jelölőnégyzetet Databricks SQL Databricks Runtime

Új sorokat szúr be egy táblába, és tetszés szerint csonkolja a táblát vagy partíciókat. A beszúrt sorokat értékkifejezések vagy lekérdezés eredménye alapján adhatja meg.

A Databricks SQL csak Delta Lake-táblák esetében támogatja ezt az utasítást.

Szintaxis

INSERT { OVERWRITE | INTO } [ TABLE ] table_name
    [ PARTITION clause ]
    [ ( column_name [, ...] ) | BY NAME ]
    query

INSERT INTO [ TABLE ] table_name
    REPLACE WHERE predicate
    query

Feljegyzés

INSERT INTO Delta-tábla esetén a sémakényszerítés és az evolúció támogatott. Ha egy oszlop adattípusa nem hajtható végre biztonságosan a Delta-tábla adattípusára, a rendszer futásidejű kivételt vet ki. Ha a sémafejlődés engedélyezve van, új oszlopok létezhetnek a séma utolsó oszlopaként (vagy beágyazott oszlopokként) a séma fejlődéséhez.

Paraméterek

INTO vagy OVERWRITE

Ha a következőket adja meg OVERWRITE , a következők érvényesek:
- partition_spec A tábla nélkül az első sor beszúrása előtt csonkolja a táblázatot.
- Ellenkező esetben az első sor beszúrása előtt a partition_spec rendszer csonkolja a megfelelő partíciókat.
Ha megadja INTO az összes beszúrt sort, a meglévő sorok adalékok.
table_name

Azonosítja a beszúrni kívánt táblát. A név nem tartalmazhat időbeli specifikációt. Ha a tábla nem található, az Azure Databricks TABLE_OR_VIEW_NOT_FOUND hibát jelez.

table_name nem lehet idegen tábla.
PARTITION záradék

Nem kötelező paraméter, amely meghatározza a beszúrás célpartícióját. A partíciót is csak részben adhatja meg.

Statikus partíció column = value megadásakor ezt az oszlopot nem szabad megismételni a beszúrási oszloplistában.
( column_name [, ...] )

A táblázat oszlopainak választható listája. A beszúrási parancs legfeljebb egyszer adhat meg egy adott oszlopot a táblából.

A következőkre vonatkozik: Databricks SQL Databricks Runtime 12.2 LTS és újabb
- Ha ez a parancs kihagy egy oszlopot, a Databricks SQL ehelyett a megfelelő alapértelmezett értéket rendeli hozzá.
- Ha a céltábla sémája nem határoz meg alapértelmezett értéket a beszúrt oszlophoz, a Databricks SQL hozzárendeli NULL , ha az oszlop null értékű. Ellenkező esetben a Databricks SQL hibát jelez.
Ha nem ad meg oszloplistát, azzal egyenértékű az összes oszlop megadása, kivéve a PARTITION záradékban hozzárendelt értékeket, a táblában meghatározott sorrendben.
BY NAME

A következőkre vonatkozik: Databricks SQL Databricks Runtime 13.3 LTS és újabb

Ha explicit oszloplista helyett ezt a záradékot használja, a parancs a közzétett oszlopnevek query használatával hozza létre az oszloplistát querya következő sorrendben: . Az explicit oszloplistához hasonlóan minden oszlopnak léteznie kell a céltáblában, és nem lehet duplikálni. Ha egy benne table_name lévő oszlop nem része a hallgatólagos oszloplistának, akkor a rendszer inkább az DEFAULT értéket használja.

BY NAME a szerkezetek attribútumait név szerint is megfelelteti.

Egyetlen oszlop query sem felelhet meg a PARTITION záradékban megadott oszlopnak vagy a létrehozott oszlopnak.
A WHERE boolean_expression CSERÉJE

A következőkre vonatkozik: Databricks SQL Databricks Runtime 12.2 LTS és újabb

Ha table_name Delta Lake-tábla, törölje az egyező boolean_expression sorokat a megadott querysorok boolean-expression beszúrása előtt. query A nem egyező boolean_expression sorok figyelmen kívül lesznek hagyva.

boolean_expression bármely olyan kifejezés lehet, amely eredménytípusra BOOLEANértékel.

Lásd: Tetszőleges szelektív felülírás a replaceWhere kifejezéssel.
Lekérdezés

Egy lekérdezés, amely létrehozza a beszúrni kívánt sorokat.

Meg kell egyeznie a lekérdezés által visszaadott oszlopok számával a megadott vagy hallgatólagos beszúrási oszloplistával.

Ha egy adattípus nem hajtható végre biztonságosan az egyező oszlop adattípusára, a rendszer futásidejű kivételt eredményez.

A következőkre vonatkozik: Databricks SQL Databricks Runtime 11.3 LTS és újabb
- Ha query ÉRTÉKEK záradékból áll, akkor a expression következő lehetDEFAULT: .
- Ha query egy Standard kiadás LECT záradékból áll, akkor az named_expression lehetDEFAULT.
- DEFAULTbeszúrja a megfelelő oszlop table_nameexplicit módon definiált DEFAULT kifejezését, vagy NULL ha nincs definiálva.
Ha a sémafejlődés engedélyezve van, új oszlopok létezhetnek a séma utolsó oszlopaként (vagy beágyazott oszlopokként) a séma fejlődéséhez.

Példák

Ebben a szakaszban:

IN Standard kiadás BE
Beszúrás oszloplistával
Beszúrás partíciós specifikációval és oszloplistával
IN Standard kiadás RT a BY NAME záradék használatával
HELY LECSERÉLÉSE
INSERT OVERWRITE

INSERT INTO

IN Standard kiadás RT értékek használatával

> CREATE TABLE students (name VARCHAR(64), address VARCHAR(64) DEFAULT 'unknown', student_id INT)
  PARTITIONED BY (student_id);

-- Single row insert using a `VALUES` clause specifying all columns.
> INSERT INTO students VALUES
    ('Amy Smith', '123 Park Ave, San Jose', 111111);

-- Single row insert using an implicit default for address
> INSERT INTO students(name, student_id) VALUES('Grayson Miller', 222222);

-- Single row insert using an explicit DEFAULT keyword for address
> INSERT INTO students VALUES('Youna Kim', DEFAULT, 333333);

--  Multi-row insert using a `VALUES` clause
> INSERT INTO students VALUES
    ('Bob Brown', '456 Taylor St, Cupertino', 444444),
    ('Cathy Johnson', '789 Race Ave, Palo Alto', 555555);

-- Multi-row insert using a mix of DEFAULT and literals
> INSERT INTO students VALUES
    ('Gwyneth Zhao', '120 Main St, Rockport', 666666),
    ('Jackson Peterson', DEFAULT, 777777);

> SELECT * FROM students;
            name                  address student_id
 ---------------- ------------------------ ----------
        Amy Smith   123 Park Ave, San Jose     111111
   Grayson Miller                  unknown     222222
        Youna Kim                  unknown     333333
        Bob Brown 456 Taylor St, Cupertino     444444
    Cathy Johnson  789 Race Ave, Palo Alto     555555
     Gwyneth Zhao    120 Main St, Rockport     666666
 Jackson Peterson                  unknown     777777

Beszúrás alkérdezés használatával

-- Assuming the persons table has already been created and populated.
> SELECT * FROM persons;
          name                   address       ssn
 ------------- ------------------------- ---------
 Dora Williams 134 Forest Ave, Melo Park 123456789
   Eddie Davis   245 Market St, Milpitas 345678901

> INSERT INTO students PARTITION (student_id = 444444)
    SELECT name, address FROM persons WHERE name = "Dora Williams";

> SELECT * FROM students;
          name                   address student_id
 ------------- ------------------------- ----------
     Amy Smith    123 Park Ave, San Jose     111111
     Bob Brown  456 Taylor St, Cupertino     222222
 Cathy Johnson   789 Race Ave, Palo Alto     333333
 Dora Williams 134 Forest Ave, Melo Park     444444

Beszúrás záradékkal `TABLE`

-- Assuming the visiting_students table has already been created and populated.
> SELECT * FROM visiting_students;
          name               address student_id
 ------------- --------------------- ----------
 Fleur Laurent 345 Copper St, London     777777
 Gordon Martin  779 Lake Ave, Oxford     888888

> INSERT INTO students TABLE visiting_students;

> SELECT * FROM students;
          name                   address student_id
 ------------- ------------------------- ----------
     Amy Smith     123 Park Ave,San Jose     111111
     Bob Brown  456 Taylor St, Cupertino     222222
 Cathy Johnson   789 Race Ave, Palo Alto     333333
 Dora Williams 134 Forest Ave, Melo Park     444444
 Fleur Laurent     345 Copper St, London     777777
 Gordon Martin      779 Lake Ave, Oxford     888888

Beszúrás könyvtárba

> CREATE TABLE students (name VARCHAR(64), address VARCHAR(64), student_id INT)
    PARTITIONED BY (student_id)
    LOCATION "/mnt/user1/students";

> INSERT INTO delta.`/mnt/user1/students` VALUES
    ('Amy Smith', '123 Park Ave, San Jose', 111111);
> SELECT * FROM students;
          name                   address student_id
 ------------- ------------------------- ----------
     Amy Smith    123 Park Ave, San Jose     111111

Beszúrás oszloplistával

> INSERT INTO students (address, name, student_id) VALUES
    ('Hangzhou, China', 'Kent Yao', 11215016);
> SELECT * FROM students WHERE name = 'Kent Yao';
      name                address student_id
 --------- ---------------------- ----------
 Kent Yao         Hangzhou, China   11215016

Beszúrás partíciós specifikációval és oszloplistával

> INSERT INTO students PARTITION (student_id = 11215017) (address, name) VALUES
    ('Hangzhou, China', 'Kent Yao Jr.');
> SELECT * FROM students WHERE student_id = 11215017;
         name                address student_id
 ------------ ---------------------- ----------
 Kent Yao Jr.        Hangzhou, China   11215017

IN Standard kiadás RT a BY NAME záradék használatával

> CREATE TABLE target(n INT, text STRING, s STRUCT<a INT, b INT>);
> INSERT INTO target BY NAME SELECT named_struct('b', 2, 'a', 1) AS s, 0 AS n, 'data' AS text;
> SELECT * FROM target;
  0  data  {"a":1,"b":2}

> CREATE OR REPLACE TABLE target(n INT, arr ARRAY<STRUCT<a INT, b INT>>);
> INSERT INTO target BY NAME SELECT array(named_struct('b', 2, 'a', 1)) AS arr, 0 AS n;
> INSERT INTO target BY NAME SELECT array(named_struct('b', 2, 'a', 1)) AS arr;
> SELECT * FROM target;
  0     [{"a":1,"b":2}]
  NULL  [{"a":1,"b":2}]

> INSERT INTO target BY NAME SELECT array(named_struct('b', 2, 'a', 1)) AS arr, 0 AS badname;
Error

> INSERT INTO target BY NAME SELECT array(named_struct('b', 2, 'a', 1)) AS arr, 0 AS n, 1 AS n;
 Error: INSERT_COLUMN_ARITY_MISMATCH.TOO_MANY_DATA_COLUMNS

HELY LECSERÉLÉSE

> CREATE TABLE sales(tx_date DATE, amount INTEGER);
> INSERT INTO sales VALUES
   (DATE'2022-10-01', 1234),
   (DATE'2022-10-02', 2345),
   (DATE'2022-10-03', 3456),
   (DATE'2022-11-01', 3214);

-- Replace any rows with a transaction date in October 2022.
> INSERT INTO sales REPLACE WHERE tx_date BETWEEN '2022-10-01' AND '2022-10-31'
   VALUES (DATE'2022-10-01', 1237),
          (DATE'2022-10-02', 2378),
          (DATE'2022-10-04', 2456),
          (DATE'2022-10-05', 6328);
> SELECT * FROM sales ORDER BY  tx_date;
 tx_date    amount
 ---------- ------
 2022-10-01   1237
 2022-10-02   2378
 2022-10-04   2456
 2022-10-05   6328
 2022-11-01   3214

INSERT OVERWRITE

Beszúrás záradékkal `VALUES`

-- Assuming the students table has already been created and populated.
> SELECT * FROM students;
          name                   address student_id
 ------------- ------------------------- ----------
     Amy Smith    123 Park Ave, San Jose     111111
     Bob Brown  456 Taylor St, Cupertino     222222
 Cathy Johnson   789 Race Ave, Palo Alto     333333
 Dora Williams 134 Forest Ave, Melo Park     444444
 Fleur Laurent     345 Copper St, London     777777
 Gordon Martin      779 Lake Ave, Oxford     888888
   Helen Davis 469 Mission St, San Diego     999999
    Jason Wang     908 Bird St, Saratoga     121212

> INSERT OVERWRITE students VALUES
    ('Ashua Hill', '456 Erica Ct, Cupertino', 111111),
    ('Brian Reed', '723 Kern Ave, Palo Alto', 222222);

> SELECT * FROM students;
       name                 address student_id
 ---------- ----------------------- ----------
 Ashua Hill 456 Erica Ct, Cupertino     111111
 Brian Reed 723 Kern Ave, Palo Alto     222222

Beszúrás alkérdezés használatával

-- Assuming the persons table has already been created and populated.
> SELECT * FROM persons;
          name                   address       ssn
 ------------- ------------------------- ---------
 Dora Williams 134 Forest Ave, Melo Park 123456789
   Eddie Davis    245 Market St,Milpitas 345678901

> INSERT OVERWRITE students PARTITION (student_id = 222222)
    SELECT name, address FROM persons WHERE name = "Dora Williams";

> SELECT * FROM students;
          name                   address student_id
 ------------- ------------------------- ----------
    Ashua Hill   456 Erica Ct, Cupertino     111111
 Dora Williams 134 Forest Ave, Melo Park     222222

Beszúrás záradékkal `TABLE`

-- Assuming the visiting_students table has already been created and populated.
> SELECT * FROM visiting_students;
          name               address student_id
 ------------- --------------------- ----------
 Fleur Laurent 345 Copper St, London     777777
 Gordon Martin  779 Lake Ave, Oxford     888888

> INSERT OVERWRITE students TABLE visiting_students;

> SELECT * FROM students;
          name               address student_id
 ------------- --------------------- ----------
 Fleur Laurent 345 Copper St, London     777777
 Gordon Martin  779 Lake Ave, Oxford     888888

Könyvtár felülírása beszúrása

> CREATE TABLE students (name VARCHAR(64), address VARCHAR(64), student_id INT)
    PARTITIONED BY (student_id)
    LOCATION "/mnt/user1/students";

> INSERT OVERWRITE delta.`/mnt/user1/students` VALUES
    ('Amy Smith', '123 Park Ave, San Jose', 111111);
> SELECT * FROM students;
          name                   address student_id
 ------------- ------------------------- ----------
     Amy Smith    123 Park Ave, San Jose     111111

INSERT

Szintaxis

Paraméterek

Példák

Ebben a szakaszban:

INSERT INTO

IN Standard kiadás RT értékek használatával

Beszúrás alkérdezés használatával

Beszúrás záradékkal TABLE

Beszúrás könyvtárba

Beszúrás oszloplistával

Beszúrás partíciós specifikációval és oszloplistával

IN Standard kiadás RT a BY NAME záradék használatával

HELY LECSERÉLÉSE

INSERT OVERWRITE

Beszúrás záradékkal VALUES

Beszúrás alkérdezés használatával

Beszúrás záradékkal TABLE

Könyvtár felülírása beszúrása

Kapcsolódó cikkek

További források

Beszúrás záradékkal `TABLE`

Beszúrás záradékkal `VALUES`

Beszúrás záradékkal `TABLE`