pg_insert
Überträgt Werte aus einem Array in eine Tabelle
&reftitle.description;
PgSql\Resultstringboolpg_insert
PgSql\Connectionconnection
stringtable_name
arrayvalues
intflagsPGSQL_DML_EXEC
pg_insert fügt die Werte des
values in die Tabelle
table_name ein.
Falls flags angegeben wurde, wird
pg_convert mit den angegebenen Flags auf das Array
values angewendet.
Standardmäßig übergibt pg_insert Rohwerte. Die Werte
müssen entweder maskiert werden oder es muss die Option PGSQL_DML_ESCAPE
angegeben werden. PGSQL_DML_ESCAPE maskiert Parameter und Bezeichner und
setzt sie in Anführungszeichen. Daher muss bei Tabellen- und Spaltennamen
zwischen Groß- und Kleinschreibung unterschieden werden.
Es ist zu beachten, dass weder die Maskierung noch eine vorbereitete
Abfrage LIKE-Abfragen, JSON, Array, Regex usw. schützen können. Diese
Parameter sollten im Kontext behandelt werden, &dh; Werte maskieren und
validieren.
&reftitle.parameters;
connection
&pgsql.parameter.connection;
table_name
Der Name der Tabelle, in die die Zeilen eingefügt werden sollen.
table_name muss mindestens soviele Spalten
haben, wie das values Elemente.
values
Ein array, dessen Indizes die Feldnamen der Tabelle
table_name sind und dessen Werte die Werte sind,
die in die entprechenden Spalten eingefügt werden sollen.
flags
Jede Kombination aus PGSQL_CONV_OPTS,
PGSQL_DML_NO_CONV,
PGSQL_DML_ESCAPE,
PGSQL_DML_EXEC,
PGSQL_DML_ASYNC und
PGSQL_DML_STRING. Falls
PGSQL_DML_STRING bei den
flags angegeben wurde, wird der Abfrage-String
zurückgegeben. Werden PGSQL_DML_NO_CONV oder
PGSQL_DML_ESCAPE angegeben, wird
pg_convert intern nicht aufgerufen.
&reftitle.returnvalues;
&return.success;. Oder gibt bei Erfolg einen &string; zurück, wenn
PGSQL_DML_STRING über flags
übergeben wird.
&reftitle.errors;
Wenn die angegebene Tabelle ungültig ist, wird ein
ValueError geworfen.
Wenn der Wert oder der Typ eines Feldes nicht mit einem PostgreSQL-Typ
übereinstimmt, wird ein ValueError oder
TypeError geworfen.
&reftitle.changelog;
&Version;
&Description;
8.3.0
Wenn die angegebene Tabelle ungültig ist, wird nun ein
ValueError geworfen; zuvor wurde ein
E_WARNING ausgegeben.
8.3.0
Wenn der Wert oder Typ eines Feldes nicht mit einem PostgreSQL-Typ
übereinstimmt, wird nun ein ValueError oder
TypeError geworfen; zuvor wurde ein
E_WARNING ausgegeben.
&pgsql.changelog.return-result-object;
&pgsql.changelog.connection-object;
&reftitle.examples;
pg_insert-Beispiel
]]>
&reftitle.seealso;
pg_convert