Zobrazení zdroje stránky Insert (SQL)

{{Vyjmout|SQL}}
{{Upravit|Wikipedie není učebnice.}}
[[SQL]] příkaz '''INSERT''' přidá do tabulky [[relační databáze]] nový záznam.

== Základní forma ==
Základní forma příkazu <code>INSERT</code> vypadá takto:

<syntaxhighlight lang="sql">
INSERT INTO <tabulka> [(<sloupec>[,...n])] VALUES (<hodnota>[,...n]);
 
INSERT INTO <tabulka> [(<sloupec>[,...n])] <SELECT prikaz>;
</syntaxhighlight>

kde:
* <tabulka> je název tabulky, do které se má nový záznam uložit.
* <sloupec> je jmenovitý seznam sloupců, do kterých se hodnoty ukládají.
* <hodnota> je vkládaná hodnota. Každá hodnota se uloží do sloupce, jež má stejnou pozici ve výčtu sloupců jako tato hodnota.
* <SELECT prikaz> je poddotaz pro výběr záznamů z tabulky ([[SELECT]]). V této syntaxi se do tabulky vloží výsledek tohoto výběru.

Seznam sloupců v závorkách může být vynechán; v tom případě se předpokládá seznam všech sloupců tabulky. Počet sloupců a hodnot musí být stejný. U sloupců vynechaných v daném seznamu se použije implicitní hodnota. Tu obsahuje definice dané tabulky.

Hodnoty zadané při <code>INSERT</code> dotazu musí splňovat všechny podmínky pro sloupce (např. [[primární klíč]], podmínky <code>CHECK</code> a <code>NOT NULL</code>). Pokud nejsou splněny nebo nastane syntaktická chyba, záznam se do tabulky nevloží a databázový stroj (záleží na jeho typu) pošle chybový kód a hlášku.

== Příklady ==
;Příklad 1:

Obsah tabulky ''telefonni_seznam'' před vložením nového záznamu
{|border=1 cellpadding=3 cellspacing=0
!jmeno||cislo||ulice||mesto
|-
|Jan Novák||257125474||Wikipedistická 28||Pastoriovice
|-
|Jana Nováková||574125474||Luční 6||Praha
|}

<syntaxhighlight lang="sql">
INSERT INTO telefonni_seznam (jmeno, cislo) VALUES ('John Doe', '555-1212');
</syntaxhighlight>

Obsah tabulky telefonni_seznam po vložení nového záznamu
{|border=1 cellpadding=3 cellspacing=0
!jmeno||cislo||ulice||mesto
|-
|Jan Novák||257125474||Wikipedistická 28||Pastoriovice
|-
|Jana Nováková||574125474||Luční 6||Praha
|-
|John Doe||555–1212||NULL||NULL
|}

Pokud jsou zadány hodnoty všech sloupečků, můžeme použít zkrácenou verzi:

<syntaxhighlight lang="sql">
INSERT INTO tabulka VALUES ('hodnota1', [''hodnota2, ...'']);
</syntaxhighlight>

;Příklad 2
 
<syntaxhighlight lang="sql">
INSERT INTO telefonni_seznam VALUES ('John Doe', '555-1212', 'Pařížská 6','Aš');
</syntaxhighlight>

{|border=1 cellpadding=3 cellspacing=0
!jmeno||cislo||ulice||mesto
|-
|Jan Novák||257125474||Wikipedistická 28||Pastoriovice
|-
|Jana Nováková||574125474||Luční 6||Praha
|-
|John Doe||555–1212||Pařížská 6||Aš
|}

== Rozšířené formy ==
=== Vložení více záznamů ===
Některé databáze povolují vložení více záznamů za sebou. V takovém případě se hodnoty pro druhý, třetí… další záznam vloží za ty první a oddělí čárkou.

<syntaxhighlight lang="sql">
INSERT INTO telefonni_seznam (jmeno, cislo) VALUES
('John Doe', '555-1212'),
('Leona Lewis', '555-112777'),
('Joe King', '555-1213');
</syntaxhighlight>

Většinou je v případě vložení více záznamů povoleno použít i kratší formu s vynechaným seznamem sloupců.

=== Vložení výběru ===
Povolená je i forma vložení záznamu (nebo záznamů) jejichž sloupce jsou vybrány poddotazem [[SELECT]]. Poddotaz může použít většinu klauzulí jako pro samostatný dotaz typu SELECT (např. výrazy místo jen názvů sloupců, klauzuli WHERE, klauzuli LIMIT, klauzuli [[JOIN]], [[agregační funkce]]).

<syntaxhighlight lang="sql">
INSERT INTO telefonni_seznam (jmeno, cislo) 
SELECT jmeno, cislo FROM telefonni_seznam_kopie WHERE cislo LIKE "555-%" LIMIT 3;
</syntaxhighlight>

V této konstrukci:
* chybí klíčové slovo VALUES
* hodnoty nejsou v závorkách
* poddotaz SELECT může být uveden pouze jeden
* počet sloupců v části INSERT a SELECT musí být stejný

=== INSERT IGNORE INTO ===
SQL příkaz <code>INSERT</code> s klíčovým slovem <code>IGNORE</code> při pokusu o vložení řádku shodujícího se v primárním či unikátním klíči potlačí standardní chování databázového stroje (hození chybové hlášky a skončení jako celku), místo toho bude tuto chybu ignorovat a pokračovat dál. Má význam zejména v případě vkládání více záznamů – po skončení příkazu budou vloženy jen ty nekolidující řádky, ty kolidující—duplicitní vloženy nebudou.

<code>INSERT IGNORE INTO</code> je podporován v [[MySQL]].

=== INSERT … SET … ===
<code>INSERT … SET …</code> je pouze jiná forma příkazu, u které nejsou seznamy názvů sloupců a jejich hodnot odděleny ale uvedeny ve dvojicích, podobně jako u příkazu [[UPDATE]]. Tento zápis podporují jen některé databázové stroje.

<syntaxhighlight lang="sql">
INSERT INTO telefonni_seznam SET jmeno='John Doe', cislo='555-1212';
</syntaxhighlight>

Tato syntaxe je vhodnější u ručně psaných dotazů při vkládání do tabulek s větším množstvím sloupců. Díky tomu, že název sloupce a jeho hodnota jsou u sebe, uživatel nemusí při připisování či ubírání jednoho sloupce kontrolovat pořadí ve výčtu sloupců a hodnot. Na druhou stranu takto nelze vložit více záznamů za sebou.

=== INSERT … SELECT … ===
Pomocí konstrukce <code>INSERT … SELECT …</code> lze vložit do tabulky výsledek výběru pomocí <code>SELECT</code>. V užím slova smyslu lze klonovat existující záznamy téže tabulky, což je případ, pro který se tato konstrukce využívá asi nejčastěji; v obecnějším významu lze použít jakýkoli výběrový dotaz neomezený shodou tabulek (např. místo sloupců doplněný o výrazy vytvořené z nich nebo jen z konstant). Podmínkou pro úspěšnost dotazu je shoda počet sloupců; shodovat by se měly i jejich typy, jinak by došlo k nezamýšleném výsledkům (například při pokusu uložit řetězec do sloupce uchovávající čísla se vloží nula). Neúspěch nastane též při pokusu vložit duplicitní záznam podle unikátního či primárního [[index (databáze)|klíče]], při pokusu uložit [[NULL]] do sloupce označeného NOT NULL nebo je-li závažná chyba v některém z výrazů (např. špatný počet parametrů apod.).

<syntaxhighlight lang="sql">
INSERT INTO tabulka_a (sloupec1a, sloupec2a, …)
  SELECT sloupec1b, sloupec2b, … FROM tabulka_b [WHERE …];
</syntaxhighlight>

* Seznam sloupců za tabulkou, do které se vkládá, může být nespecifikovaný; v takovém případě se předpokládají všechny sloupce.
* Dodržuje se pořadí (první zdrojový sloupec se vkládá do prvního cílového, druhý do druhého, atd.).
* Sloupce cílové a zdrojové tabulky se musí shodovat v počtu.
* Měly by se shodovat i typy odpovídajících sloupců. Různé databázové systémy jsou ohledně toho různě tolerantní – například většinou lze číselný sloupec nebo datum do textového (uloží se jako číslo v textové podobě), při pokusu uložit text do čísla se buď uloží nula nebo se vyvolá varování či chyba, stejně jako při pokusu vložit neodpovídající hodnotu do specifického typu (geometrického, složeného).

== Vložení nového nebo úprava existujícího záznamu ==
Pro vložení nového záznamu, pokud neexistuje, nebo úpravu takového záznamu, který již existuje, mají různé [[SŘBD]] v SQL různé formulace prostředků, jak to učinit.
=== MERGE ===
Asi nejvíce používaný a podporovaný je příkaz <code>[[MERGE]]</code>, který je standardem SQL od verze SQL-99.
=== Obdoby MERGE ===
Dále jsou to méně standardní příkazy SQL, které vkládání či editaci existujícího/neexistujícího záznamu řeší s částečnou podporou v různých databázových systémech:
* <code>[[MERGE#REPLACE|REPLACE INTO…]]</code> (např. [[MySQL]], [[ProgreSQL]])
* <code>[[MERGE#UPSERT|UPSERT]]</code> (např. Microsoft SQL Azure, [[MongoDB]]).
* <code>[[MERGE#INSERT OR REPLACE|INSERT OR REPLACE]]</code> ([[SQLite]])
* <code>[[MERGE#UPDATE OR INSERT INTO|UPDATE OR INSERT INTO]]</code> ([[Firebird]])

=== …ON DUPLICATE KEY ===
<code>ON DUPLICATE KEY</code> je volitelná klauzule příkazu <code>INSERT</code>, která funguje jako obdoba <code>MERGE</code>. Existuje např. v MySQL. Stejně jako u <code>MERGE</code> je zde specifikováno chování pro vkládání (záznam neexistuje) tak pro editaci (záznam již existuje).

<syntaxhighlight lang="sql">
INSERT INTO hledane_vyrazy(id,vyraz,pocet_hledani) VALUES(178,"Britney Spears",1)
ON DUPLICATE KEY UPDATE pocet_hledani=pocet_hledani+1;
</syntaxhighlight>

Alternativou k tomu by byly buď dva SQL příkazy nebo zapojení správy chyb, které ne každý databázový stroj podporuje. Konstrukce <code>ON DUPLICATE KEY</code> je naproti tomu součástí standardu SQL-99.<!--údajně-->

Tato formulace sice patří mezi ty delší, na druhou stranu umožňuje (pod)příkazem [[UPDATE]] reagovat na existenci záznamu změnou jiných sloupců než které by bylo vloženy v případě neexistence záznamu. Na rozdíl od <code>REPLACE INTO</code>, který specifikuje hodnoty sloupců pro oba případy existence či neexistence záznamu, je pomocí <code>INSERT … ON DUPLICATE KEY UPDATE…</code> možno v případě existence záznamu s duplicitním primárním klíčem specifikovat hodnoty jen pro některé sloupce s tím, že ostatní zůstanou nezměněny.

Např. u MySQL existuje funkce <code>[http://dev.mysql.com/doc/mysql/en/miscellaneous-functions.html#function_values VALUES]</code> s parametrem názvu sloupce, která vrací hodnotu tohoto sloupce v momentu vkládání a dá se tedy opisně použít v klauzuli <code>ON DUPLICATE KEY</code> místo opakování hodnoty (literálu) – je to vhodné v případech, že vkládaná hodnota je velmi dlouhá.

== Další vlastnosti ==
=== Výchozí hodnoty ===
Většina relačních databází u definice tabulkového pole umožňuje stanovit výchozí (implicitní, výchozí) hodnotu. Pokud při vkládání dané políčko nespecifikujeme, vloží se do něj automaticky tato implicitní hodnota. Stejný efekt bude mít, pokud jako hodnotu použijeme klíčové slovo <tt>DEFAULT</tt>, které výchozí hodnotu pro daný sloupec reprezentuje.

=== Povinné zadání ===
Na úrovni databáze (jejího [[SŘBD]]) lze vhodným nastavením vynutit povinné zadání vybraných sloupců při vkládáním nového záznamu – s tím, že pokud zadány nebudou, databázový engine nedovolí daný záznam vložit a místo toho hodí chybovou hlášku. Nastavení spočívá v kombinaci <tt>DEFAULT NULL</tt> a <tt>NOT NULL</tt> v atributech sloupce – jinými slovy: nechť výchozí hodnota je [[NULL]], ale nechť není nedovoleno vložit řádek s hodnotou NULL u tohoto sloupce.

=== Automatická čísla ===
Relační databáze taktéž povolují vytvoření primárního [[index (databáze)|indexu]] (primárního klíče) tabulky, jehož hodnota je určována nezávisle na explicitně vložené hodnotě (např. v [[MS Access]], [[MSSQL]] se jedná o speciální typ ''automatické číslo'' a při vložení nového záznamu se toto pole musí vynechat, v [[MySQL]] má pole příznak <tt>AUTO_INCREMENT</tt> a při vložení se místo něj může specifikovat např. [[prázdný řetězec]] nebo <tt>DEFAULT</tt>).

=== Duplicitní hodnoty ===
Spolu s tabulkami mohou být vytvořeny její tzv. [[Index (databáze)#Typy indexů|unikátní indexy]] – [[de facto]] mechanismus, který vyloučí, aby pro určité pole v tabulce existovaly duplicitní hodnoty (tím, že v případě pokusu o vložení takového záznamu databázový stroj ohlásí chybu).

=== LAST_INSERT_ID ===
Některé databáze jako [[Oracle Database|Oracle]], [[MySQL]], [[PostgreSQL]] definují speciální hodnotu <tt>LAST_INSERT_ID</tt>, která reprezentuje hodnotu primárního klíče (nejčastěji nazývaného ID – odtud název) naposledy vloženého záznamu. Pokud je třeba nově vytvořený záznam vzápětí upravit (nebo provést jiné změny týkající se tohoto záznamu), lze tuto hodnotu použít. <tt>LAST_INSERT_ID</tt> není zahrnuta ve standardu SQL'92.

Jiný způsob, jak zjistit hodnotu primárního klíče právě vloženého řádku, je s použitím [[trigger]]u <tt>[BEFORE|AFTER] INSERT</tt> s odkazem na kvazi-sloupec <tt>NEW.id</tt>.
{{SQL}}

[[Kategorie:SQL]]