pg_insert
Wstawia tablicę do tabeli
&reftitle.description;
PgSql\Resultstringboolpg_insert
PgSql\Connectionconnection
stringtable_name
arrayvalues
intflagsPGSQL_DML_EXEC
pg_insert wstawia wartości parametru values
do tabeli określonej przez parametr table_name.
Jeśli parametr flags jest określony,
to do warunków podanych conditions stosowana jest funkcja pg_convert
z określonymi flagami.
Domyślnie pg_insert przekazuje surowe wartości.
Wartości muszą mieć dodane znaki ucieczki lub należy podać flagę PGSQL_DML_ESCAPE
w parametrze flags.
PGSQL_DML_ESCAPE dodaje cudzysłowy i znaki ucieczki do parametrów/identyfikatorów.
W związku z tym nazwy tabeli i kolumn stają się wrażliwe na wielkość znaków.
Note that neither escape nor prepared query can protect LIKE query,
JSON, Array, Regex, etc. These parameters should be handled
according to their contexts. i.e. Escape/validate values.
&reftitle.parameters;
connection
&pgsql.parameter.connection;
table_name
Nazwa tabeli, do której mają zostać dodane wiersze. Tabela table_name musi mieć
przynajmniej tyle kolumn, ile elementów ma tablica values.
values
Tablica (ang. array), której klucze to nazwy pól w tabeli table_name,
oraz której wartościami są wartości tych pól, które mają zostać wpisane.
flags
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. Kiedy ustawione jest
PGSQL_DML_NO_CONV lub PGSQL_DML_ESCAPE, funkcja nie wykonuje pg_convert
wewnętrznie.
&reftitle.returnvalues;
&return.success;. Zwraca łańcuch (ang. string) jeśli PGSQL_DML_STRING zostało przekazane
poprzez parametr flags.
&reftitle.errors;
Gdy określona tabela jest nieprawidłowa, rzucany jest ValueError.
Jeśli wartość lub typ pola nie pasuje poprawnie do typu PostreSQL,
to rzucany jest ValueError lub TypeError.
&reftitle.changelog;
&Version;
&Description;
8.3.0
Rzuca teraz błąd ValueError jeśli podana tabela jest niepoprawna;
wcześniej emitowane było ostrzeżenie (E_WARNING).
8.3.0
Funkcja rzuca teraz błąd ValueError lub TypeError
jeśli wartość lub typ pola nie psuje poprawnie do typu PostreSQL;
wcześniej emitowane było ostrzeżenie (E_WARNING).
&pgsql.changelog.return-result-object;
&pgsql.changelog.connection-object;
&reftitle.examples;
Przykład użycia pg_insert
]]>
&reftitle.seealso;
pg_convert