Available in versions: Dev (3.21) | Latest (3.20) | 3.19 | 3.18 | 3.17 | 3.16 | 3.15 | 3.14 | 3.13 | 3.12 | 3.11
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, Databricks, 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.21. Support in older jOOQ versions may differ. Translate your own SQL on our website
Feedback
Do you have any feedback about this page? We'd love to hear it!