INSERT
Berlaku untuk: Databricks SQL Databricks Runtime
Menyisipkan baris baru ke dalam tabel dan secara opsional memotong tabel atau partisi. Anda menentukan baris yang disisipkan menurut ekspresi nilai atau hasil kueri.
Databricks SQL mendukung pernyataan ini hanya untuk tabel Delta Lake.
Sintaksis
INSERT { OVERWRITE | INTO } [ TABLE ] table_name
[ PARTITION clause ]
[ ( column_name [, ...] ) | BY NAME ]
query
INSERT INTO [ TABLE ] table_name
REPLACE WHERE predicate
query
Catatan
Saat Anda INSERT INTO
tabel Delta, penegakan skema dan evolusi didukung. Jika jenis data kolom tidak dapat ditransmisikan dengan aman ke jenis data tabel Delta, pengecualian runtime akan ditampilkan. Jika evolusi skema diaktifkan, kolom baru dapat muncul sebagai kolom terakhir skema Anda (atau kolom berlapis) agar skema dapat berkembang.
Parameter
INTO
atauOVERWRITE
Jika Anda menentukan
OVERWRITE
, hal berikut berlaku:- Tanpa
partition_spec
, tabel akan dipotong sebelum memasukkan baris pertama. - Jika tidak, semua partisi yang cocok dengan
partition_spec
dipotong sebelum memasukkan baris pertama.
Jika Anda menentukan
INTO
, semua baris yang disisipkan merupakan tambahan untuk baris yang ada.- Tanpa
-
Mengidentifikasi tabel yang akan disisipkan. Nama tidak boleh menyertakan spesifikasi temporal. Jika tabel tidak dapat ditemukan, Azure Databricks menimbulkan kesalahan TABLE_OR_VIEW_NOT_FOUND .
table_name
tidak boleh meja asing. -
Parameter opsional yang menentukan partisi target untuk sisipan. Anda juga hanya dapat menentukan sebagian partisi.
Saat menentukan
column = value
partisi statis, kolom ini tidak boleh diulang dalam daftar sisipkan kolom. ( nama_kolom [, …] )
Daftar kolom opsional dalam tabel. Perintah sisipkan dapat menentukan kolom tertentu dari tabel paling banyak sekali.
Berlaku untuk: Databricks SQL Databricks Runtime 12.2 LTS ke atas
- Jika perintah ini menghilangkan kolom, Databricks SQL menetapkan nilai default yang sesuai sebagai gantinya.
- Jika skema tabel target tidak menentukan nilai default apa pun untuk kolom yang disisipkan, Databricks SQL menetapkan
NULL
apakah kolom dapat diubah ke null. Jika tidak, SQL Databricks menimbulkan kesalahan.
Tidak menyediakan daftar kolom setara dengan menentukan semua kolom, kecuali yang memiliki nilai yang ditetapkan dalam klausul
PARTITION
, dalam urutan yang ditentukan dalam tabel.BY NAME
Berlaku untuk: Databricks SQL Databricks Runtime 13.3 LTS ke atas
Ketika klausa ini digunakan alih-alih daftar kolom eksplisit, perintah menggunakan nama kolom yang diekspos
query
untuk menghasilkan daftar kolom dalam urutanquery
. Seperti halnya daftar kolom eksplisit, setiap kolom harus ada dalam tabel target, dan tidak boleh diduplikasi. Jika kolom yang ada ditable_name
bukan bagian dari daftar kolom tersirat,DEFAULT
nilai akan digunakan sebagai gantinya.BY NAME
juga cocok dengan atribut struktur berdasarkan nama.Tidak ada kolom di
query
yang mungkin cocok dengan kolom yang ditentukan dalamPARTITION
klausa atau kolom apa pun yang dihasilkan.GANTI DI MANA boolean_expression
Berlaku untuk: Databricks SQL Databricks Runtime 12.2 LTS ke atas
Jika
table_name
adalah tabel Delta Lake, hapus baris yang cocokboolean_expression
sebelum menyisipkan baris apa pun yang cocokboolean-expression
yang ditentukan dalamquery
.query
Baris yang tidak cocokboolean_expression
diabaikan.boolean_expression
dapat berupa ekspresi apa pun yang mengevaluasi ke jenisBOOLEAN
hasil .-
Kueri yang menghasilkan baris yang akan disisipkan.
Anda harus mencocokkan jumlah kolom yang dikembalikan oleh kueri dengan daftar sisipkan kolom yang ditentukan atau tersirat.
Jika jenis data tidak dapat dengan aman ditransmisikan ke jenis data kolom yang cocok, pengecualian runtime akan ditampilkan.
Berlaku untuk: Databricks SQL Databricks Runtime 11.3 LTS ke atas
- Jika
query
terdiri dari klausul VALUES,expression
dapat berupaDEFAULT
. - Jika
query
terdiri dari kalusul SELECT,named_expression
dapat berupaDEFAULT
. DEFAULT
akan menyisipkan ekspresiDEFAULT
yang ditentukan secara eksplisit dari kolom terkait ditable_name
, atauNULL
jika tidak ada yang ditentukan.
Jika evolusi skema diaktifkan, kolom baru dapat muncul sebagai kolom terakhir skema Anda (atau kolom berlapis) agar skema dapat berkembang.
- Jika
Contoh
Di bagian ini:
- INSERT INTO
- Menyisipkan dengan daftar kolom
- Menyisipkan dengan spesifikasi partisi dan daftar kolom
- INSERT menggunakan klausa BY NAME
- GANTI DI MANA
- INSERT OVERWRITE
MASUKKAN KE DALAM
INSERT menggunakan VALUES
> 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
Menyisipkan menggunakan kueri bertumpuk
-- 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
Menyisipkan menggunakan klausa 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
Menyisipkan menggunakan direktori
> 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
Menyisipkan menggunakan daftar kolom
> 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
Menyisipkan menggunakan spesifikasi partisi dan daftar kolom
> 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 menggunakan klausa 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
GANTI DI MANA
> 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
Menyisipkan menggunakan klausa 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
Menyisipkan menggunakan kueri bertumpuk
-- 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
Menyisipkan menggunakan klausa 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
Menyisipkan menimpa direktori
> 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