pg_insert
Wstawia tablicę do tabeli
&reftitle.description;
mixedpg_insert
resourceidentyfikator_połączenia
stringnazwa_tabeli
arraytablica_asocjacyjna
intopcjePGSQL_DML_EXEC
pg_insert wstawia wartości parametru tablica_asocjacyjna
do tabeli określonej przez parametr nazwa_tabeli.
Jeśli określono jakieś opcje,
funkcja pg_convert stosuje
do parametru tablica_asocjacyjna określone opcje.
&reftitle.parameters;
identyfikator_połączenia
Identyfikator połączenia do bazy PostgreSQL.
nazwa_tabeli
Nazwa tabeli, do której mają zostać dodane wiersze. Tabela nazwa_tabeli musi mieć
przynajmniej tyle kolumn, ile elementów ma tablica_asocjacyjna.
tablica_asocjacyjna
Tablica (ang. array), której klucze to nazwy pól w tabeli nazwa_tabeli,
oraz której wartościami są wartości tych pól, które mają zostać wpisane.
opcje
Dowolna kombinacja dowolnej ilości parametrów: PGSQL_CONV_OPTS,
PGSQL_DML_NO_CONV,
PGSQL_DML_ESCAPE,
PGSQL_DML_EXEC,
PGSQL_DML_ASYNC oraz
PGSQL_DML_STRING. Gdy PGSQL_DML_STRING jest zawarty w parametrze
opcje, zwrócony zostanie łańcuch zapytania z URL (ang. query string). Kiedy ustawione jest
PGSQL_DML_NO_CONV lub PGSQL_DML_ESCAPE, funkcja nie wykonuje pg_convert
wewnętrznie.
&reftitle.returnvalues;
Zwraca zasób połączenia w razie powodzenia, &return.falseforfailure;. Zwraca łańcuch (ang. string)
jeśli PGSQL_DML_STRING zostało wprowadzone
poprzez parametr opcje.
&reftitle.examples;
pg_insert - przykład
]]>
&reftitle.changelog;
&Version;
&Description;
5.6.0
Dopóki nie jest przekazana stała PGSQL_DML_STRING funkcja
zwraca teraz zasób połączenia zamiast &true; w wypadku powodzenia.
5.6.0
Funkcja nie jest dłużej eksperymentalna. Dodano stałą PGSQL_DML_ESCAPE oraz
wsparcie typów danych &true;/&false; i &null;.
5.5.3/5.4.19
Bezpośredni atak SQL injection na parametr nazwa_tabeli i pośredni
na identyfikatory został uniemożliwiony.
&reftitle.seealso;
pg_convert