INSERT
Platí pro: Databricks SQL Databricks Runtime
Vloží nové řádky do tabulky a volitelně zkrátí tabulku nebo oddíly. Vložené řádky zadáte podle výrazů hodnot nebo výsledku dotazu.
Databricks SQL podporuje tento příkaz pouze pro tabulky Delta Lake.
Syntaxe
INSERT { OVERWRITE | INTO } [ TABLE ] table_name
[ PARTITION clause ]
[ ( column_name [, ...] ) | BY NAME ]
query
INSERT INTO [ TABLE ] table_name
REPLACE WHERE predicate
query
Poznámka:
INSERT INTO
Při rozdílové tabulce se podporuje vynucování schématu a vývoj. Pokud datový typ sloupce nelze bezpečně přetypovat na datový typ tabulky Delta, vyvolá se výjimka modulu runtime. Pokud je povolen vývoj schématu, mohou existovat nové sloupce jako poslední sloupce schématu (nebo vnořené sloupce) pro vývoj schématu.
Parametry
INTO
neboOVERWRITE
Pokud zadáte
OVERWRITE
následující:partition_spec
Bez tabulky se před vložením prvního řádku zkrátí.- Jinak se všechny oddíly odpovídající
partition_spec
sadě zkracují před vložením prvního řádku.
Pokud zadáte
INTO
všechny vložené řádky, přidají se do existujících řádků.-
Identifikuje tabulku, do které se má vložit. Název nesmí obsahovat dočasnou specifikaci. Pokud tabulku nenajdete, Azure Databricks vyvolá TABLE_OR_VIEW_NOT_FOUND chybu.
table_name
nesmí být cizí tabulka. -
Volitelný parametr, který určuje cílový oddíl pro vložení. Oddíl můžete také zadat pouze částečně.
Při zadávání statického oddílu
column = value
nesmí být tento sloupec v seznamu vložit sloupec opakovaný. ( column_name [, ...] )
Volitelný seznam sloupců v tabulce Příkaz insert může zadat libovolný konkrétní sloupec z tabulky najednou.
Platí pro: Databricks SQL Databricks Runtime 12.2 LTS a vyšší
- Pokud tento příkaz vynechá sloupec, databricks SQL místo toho přiřadí odpovídající výchozí hodnotu.
- Pokud schéma cílové tabulky nedefinuje žádnou výchozí hodnotu pro vložený sloupec, databricks SQL přiřadí
NULL
, pokud je sloupec nullable. V opačném případě sql Služby Databricks vyvolá chybu.
Poskytnutí žádného seznamu sloupců není ekvivalentní k určení všech sloupců s výjimkou sloupců s přiřazenými hodnotami v
PARTITION
klauzuli v pořadí definovaném v tabulce.BY NAME
Platí pro: Databricks SQL Databricks Runtime 13.3 LTS a vyšší
Pokud se tato klauzule používá místo explicitního seznamu sloupců, příkaz použije vystavené názvy
query
sloupců k vytvoření seznamu sloupců v pořadí odquery
. Stejně jako u explicitního seznamu sloupců musí každý sloupec existovat v cílové tabulce a nesmí být duplikován. Pokud sloupec, kterýtable_name
existuje, není součástí předpokládaného seznamu sloupců,DEFAULT
použije se místo toho hodnota.BY NAME
také odpovídá atributům struktur podle názvu.Žádný sloupec nesmí
query
odpovídat sloupci zadanémuPARTITION
v klauzuli nebo libovolném generovaném sloupci.NAHRADIT BOOLEAN_EXPRESSION WHERE
Platí pro: Databricks SQL Databricks Runtime 12.2 LTS a vyšší
Pokud
table_name
je tabulka Delta Lake, odstraňte řádky odpovídajícíboolean_expression
před vložením všech řádkůboolean-expression
zadaných vquery
. Řádky, vequery
kterých se neshodujíboolean_expression
, se ignorují.boolean_expression
může být libovolný výraz, který se vyhodnotí jako typBOOLEAN
výsledku .-
Dotaz, který vytvoří řádky, které se mají vložit.
Počet sloupců vrácených dotazem musí odpovídat zadanému nebo předpokládanému seznamu sloupců vložení.
Pokud datový typ nelze bezpečně přetypovat na odpovídající datový typ sloupce, vyvolá se výjimka modulu runtime.
Platí pro: Databricks SQL Databricks Runtime 11.3 LTS a vyšší
- Pokud
query
se skládá z klauzule VALUES ,expression
může býtDEFAULT
. - Pokud
query
se skládá z klauzulenamed_expression
SELECT, může býtDEFAULT
. DEFAULT
vloží explicitně definovanýDEFAULT
výraz odpovídajícího sloupce nebotable_name
NULL
pokud není definován žádný.
Pokud je povolen vývoj schématu, mohou existovat nové sloupce jako poslední sloupce schématu (nebo vnořené sloupce) pro vývoj schématu.
- Pokud
Příklady
V této části:
- VLOŽIT DO
- Vložení se seznamem sloupců
- Vložení se specifikací oddílu i se seznamem sloupců
- INSERT pomocí klauzule BY NAME
- NAHRADIT WHERE
- INSERT OVERWRITE
INSERT INTO
INSERT pomocí HODNOT
> 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
Vložení pomocí poddotazů
-- 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
Vložení pomocí TABLE
klauzule
-- 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
Vložení do adresáře
> 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
Vložení se seznamem sloupců
> 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
Vložení se specifikací oddílu i se seznamem sloupců
> 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
INSERT pomocí klauzule BY NAME
> 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
NAHRADIT WHERE
> 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
Vložení pomocí VALUES
klauzule
-- 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
Vložení pomocí poddotazů
-- 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
Vložení pomocí TABLE
klauzule
-- 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
Vložení přepsání adresáře
> 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