Keine Cache-Version
Caching deaktiviert Standardeinstellung für diese Seite:aktiviert (code DEF204)Wenn die Anzeige zu langsam ist, können Sie den Benutzermodus deaktivieren, um die zwischengespeicherte Version anzuzeigen.
Rechercher dans le manuel MySQL
28.7.7.38 mysql_insert_id()
uint64_t mysql_insert_id(MYSQL *mysql)
Description
Returns the value generated for an
AUTO_INCREMENT column by the previous
INSERT or
UPDATE statement. Use this
function after you have performed an
INSERT statement into a table
that contains an AUTO_INCREMENT field, or
have used INSERT or
UPDATE to set a column value
with
LAST_INSERT_ID(.
expr)
The return value of
mysql_insert_id() is always
zero unless explicitly updated under one of the following
conditions:
INSERTstatements that store a value into anAUTO_INCREMENTcolumn. This is true whether the value is automatically generated by storing the special valuesNULLor0into the column, or is an explicit nonspecial value.In the case of a multiple-row
INSERTstatement,mysql_insert_id()returns the first automatically generatedAUTO_INCREMENTvalue that was successfully inserted.If no rows are successfully inserted,
mysql_insert_id()returns 0.If an
INSERT ... SELECTstatement is executed, and no automatically generated value is successfully inserted,mysql_insert_id()returns the ID of the last inserted row.If an
INSERT ... SELECTstatement usesLAST_INSERT_ID(,expr)mysql_insert_id()returnsexpr.INSERTstatements that generate anAUTO_INCREMENTvalue by insertingLAST_INSERT_ID(into any column or by updating any column toexpr)LAST_INSERT_ID(.expr)If the previous statement returned an error, the value of
mysql_insert_id()is undefined.
The return value of
mysql_insert_id() can be
simplified to the following sequence:
If there is an
AUTO_INCREMENTcolumn, and an automatically generated value was successfully inserted, return the first such value.If
LAST_INSERT_ID(occurred in the statement, returnexpr)expr, even if there was anAUTO_INCREMENTcolumn in the affected table.The return value varies depending on the statement used. When called after an
INSERTstatement:If there is an
AUTO_INCREMENTcolumn in the table, and there were some explicit values for this column that were successfully inserted into the table, return the last of the explicit values.
When called after an
INSERT ... ON DUPLICATE KEY UPDATEstatement:If there is an
AUTO_INCREMENTcolumn in the table and there were some explicit successfully inserted values or some updated values, return the last of the inserted or updated values.
mysql_insert_id() returns
0 if the previous statement does not use an
AUTO_INCREMENT value. If you need to save
the value for later, be sure to call
mysql_insert_id() immediately
after the statement that generates the value.
The value of mysql_insert_id()
is affected only by statements issued within the current
client connection. It is not affected by statements issued by
other clients.
The LAST_INSERT_ID() SQL
function will contain the value of the first automatically
generated value that was successfully inserted.
LAST_INSERT_ID() is not reset
between statements because the value of that function is
maintained in the server. Another difference from
mysql_insert_id() is that
LAST_INSERT_ID() is not updated
if you set an AUTO_INCREMENT column to a
specific nonspecial value. See
Section 12.15, “Information Functions”.
mysql_insert_id() returns
0 following a
CALL statement for a stored
procedure that generates an AUTO_INCREMENT
value because in this case
mysql_insert_id() applies to
CALL and not the statement
within the procedure. Within the procedure, you can use
LAST_INSERT_ID() at the SQL
level to obtain the AUTO_INCREMENT value.
The reason for the differences between
LAST_INSERT_ID() and
mysql_insert_id() is that
LAST_INSERT_ID() is made easy
to use in scripts while
mysql_insert_id() tries to
provide more exact information about what happens to the
AUTO_INCREMENT column.
The OK packet used in the client/server protocol holds
information such as is used for session state tracking. When
clients read the OK packet to know whether there is a
session state change, this resets values such as the last
insert ID and the number of affected rows. Such changes
cause mysql_insert_id() to
return 0 after execution of commands including but not
necessarily limited to COM_PING,
COM_REFRESH, and
COM_INIT_DB.
A user-specified
AUTO_INCREMENTvalue in a multiINSERTstatement falls within the range between the currentAUTO_INCREMENTvalue and the sum of the current and number of rows affected values.
Deutsche Übersetzung
Sie haben gebeten, diese Seite auf Deutsch zu besuchen. Momentan ist nur die Oberfläche übersetzt, aber noch nicht der gesamte Inhalt.Wenn Sie mir bei Übersetzungen helfen wollen, ist Ihr Beitrag willkommen. Alles, was Sie tun müssen, ist, sich auf der Website zu registrieren und mir eine Nachricht zu schicken, in der Sie gebeten werden, Sie der Gruppe der Übersetzer hinzuzufügen, die Ihnen die Möglichkeit gibt, die gewünschten Seiten zu übersetzen. Ein Link am Ende jeder übersetzten Seite zeigt an, dass Sie der Übersetzer sind und einen Link zu Ihrem Profil haben.
Vielen Dank im Voraus.
Dokument erstellt 26/06/2006, zuletzt geändert 26/10/2018
Quelle des gedruckten Dokuments:https://www.gaudry.be/de/mysql-rf-mysql-insert-id.html
Die Infobro ist eine persönliche Seite, deren Inhalt in meiner alleinigen Verantwortung liegt. Der Text ist unter der CreativeCommons-Lizenz (BY-NC-SA) verfügbar. Weitere Informationen auf die Nutzungsbedingungen und dem Autor.
Referenzen
Diese Verweise und Links verweisen auf Dokumente, die während des Schreibens dieser Seite konsultiert wurden, oder die zusätzliche Informationen liefern können, aber die Autoren dieser Quellen können nicht für den Inhalt dieser Seite verantwortlich gemacht werden.
Der Autor Diese Website ist allein dafür verantwortlich, wie die verschiedenen Konzepte und Freiheiten, die mit den Nachschlagewerken gemacht werden, hier dargestellt werden. Denken Sie daran, dass Sie mehrere Quellinformationen austauschen müssen, um das Risiko von Fehlern zu reduzieren.
