Usar chaves geradas automaticamente
O Microsoft JDBC Driver para SQL Server oferece suporte às APIs opcionais do JDBC 3.0 para recuperar identificadores de linha gerados automaticamente. O principal valor deste recurso é fornecer um modo de disponibilizar valores de IDENTITY para um aplicativo que esteja atualizando uma tabela de banco de dados sem precisar de uma consulta e de uma segunda viagem de ida e volta ao servidor.
Como o SQL Server não é compatível com pseudocolunas para identificadores, as atualizações que precisam usar o recurso de chave gerada automaticamente devem operar em uma tabela que contenha uma coluna IDENTITY. O SQL Server permite somente uma coluna IDENTITY por tabela. O conjunto de resultados retornado pelo método getGeneratedKeys da classe SQLServerStatement só terá uma coluna, com o nome de coluna retornado GENERATED_KEYS. Se forem solicitadas chaves geradas em uma tabela que não tenha uma coluna de IDENTITY, o driver JDBC retornará um conjunto de resultados nulo.
Como exemplo, crie a seguinte tabela no banco de dados de exemplo AdventureWorks2022:
CREATE TABLE TestTable
(Col1 int IDENTITY,
Col2 varchar(50),
Col3 int);
No exemplo a seguir, uma conexão aberta com o banco de dados de exemplo AdventureWorks2022 é passada para a função, uma instrução SQL é construída que adicionará dados à tabela e, em seguida, a instrução é executada e o valor da coluna IDENTITY é exibido.
public static void executeInsertWithKeys(Connection con) {
try(Statement stmt = con.createStatement();) {
String SQL = "INSERT INTO TestTable (Col2, Col3) VALUES ('S', 50)";
int count = stmt.executeUpdate(SQL, Statement.RETURN_GENERATED_KEYS);
ResultSet rs = stmt.getGeneratedKeys();
ResultSetMetaData rsmd = rs.getMetaData();
int columnCount = rsmd.getColumnCount();
if (rs.next()) {
do {
for (int i=1; i<=columnCount; i++) {
String key = rs.getString(i);
System.out.println("KEY " + i + " = " + key);
}
} while(rs.next());
}
else {
System.out.println("NO KEYS WERE GENERATED.");
}
}
// Handle any errors that may have occurred.
catch (SQLException e) {
e.printStackTrace();
}
}