9.2 使用 AUTO-INCREMENT

AUTO_INCREMENT 資料行可以用於在 MySQL 中產生主索引鍵或 id 值,但不限於這些用途。本節說明如何在使用 X DevAPI 新增資料列時擷取 AUTO_INCREMENT 值。如需更多背景資訊,請參閱使用 AUTO_INCREMENT

X DevAPI 提供 getAutoIncrementValue() 方法,可傳回操作成功插入的第一個 AUTO_INCREMENT 資料行值,該值取自 table.insert() 的傳回值。在下列範例中,假設表格包含一個設定了 AUTO_INCREMENT 屬性的 PRIMARY KEY 資料行

res = myTable.insert(['name']).values('Mats').values('Otto').execute();
print(res.getAutoIncrementValue());

table.insert() 操作插入了多個資料列。getAutoIncrementValue() 只傳回為第一個插入的資料列產生的 AUTO_INCREMENT 資料行值,因此在此範例中,只傳回包含 Mats 的資料列的值。這樣做的原因是為了方便在其他伺服器上輕鬆重現相同的操作。