Available in versions: Dev (3.20) | Latest (3.19) | 3.18 | 3.17 | 3.16 | 3.15 | 3.14 | 3.13 | 3.12 | 3.11 | 3.10
This documentation is for the unreleased development version of jOOQ. Click on the above version links to get this documentation for a supported version of jOOQ.
ALTER TABLE .. ADD COLUMN IF NOT EXISTS
Applies to ✅ Open Source Edition ✅ Express Edition ✅ Professional Edition ✅ Enterprise Edition
A popular subclause of DDL statements that jOOQ can usually emulate, is the IF EXISTS clause:
Dialect support
This example using jOOQ:
alterTable("t").dropIfExists("c")
Translates to the following dialect specific expressions:
Aurora Postgres, CockroachDB, DuckDB, Exasol, H2, MariaDB, Postgres, Teradata, YugabyteDB
ALTER TABLE t DROP IF EXISTS c
BigQuery, ClickHouse, Trino
ALTER TABLE t DROP COLUMN IF EXISTS c
DB2
BEGIN
DECLARE CONTINUE HANDLER FOR SQLSTATE '42703' BEGIN END;
DECLARE CONTINUE HANDLER FOR SQLSTATE '42704' BEGIN END;
EXECUTE IMMEDIATE '
ALTER TABLE t DROP c
';
END
Hana
DO BEGIN
DECLARE EXIT HANDLER FOR SQL_ERROR_CODE 257 BEGIN END;
DECLARE EXIT HANDLER FOR SQL_ERROR_CODE 260 BEGIN END;
DECLARE EXIT HANDLER FOR SQL_ERROR_CODE 397 BEGIN END;
EXECUTE IMMEDIATE '
ALTER TABLE t DROP (c)
';
END;
Oracle
BEGIN
EXECUTE IMMEDIATE '
ALTER TABLE t DROP COLUMN c
';
EXCEPTION
WHEN others THEN
IF sqlerrm LIKE 'ORA-00904%' THEN NULL;
ELSIF sqlerrm LIKE 'ORA-02443%' THEN NULL;
ELSE RAISE;
END IF;
END;
SQLDataWarehouse
BEGIN TRY
EXEC sp_executesql N'
ALTER TABLE t DROP COLUMN c
';
END TRY
BEGIN CATCH
IF error_number() != 4924 and error_number() != 3728 and error_number() != 3727 BEGIN
DECLARE @ErrorMessage NVARCHAR(4000) = ERROR_MESSAGE();
DECLARE @ErrorSeverity INT = ERROR_SEVERITY();
DECLARE @ErrorState INT = ERROR_STATE();
RAISERROR (@ErrorMessage, @ErrorSeverity, @ErrorState);
END;
END CATCH
SQLServer
BEGIN TRY
EXEC sp_executesql N'
ALTER TABLE t DROP COLUMN c
';
END TRY
BEGIN CATCH
IF error_number() != 4924 and error_number() != 3728 and error_number() != 3727 THROW;
END CATCH
ASE, Access, Aurora MySQL, Derby, Firebird, HSQLDB, Informix, MemSQL, MySQL, Redshift, SQLite, Snowflake, Sybase, Vertica
/* UNSUPPORTED */
Generated with jOOQ 3.20. Translate your own SQL on our website
Feedback
Do you have any feedback about this page? We'd love to hear it!