Compartilhar via

Usar chaves geradas automaticamente

  • Artigo

Baixar Driver JDBC

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; é construída uma instrução SQL que adicionará dados à tabela; 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();
    }
}

Confira também

Como usar instruções com o JDBC Driver