Standard SQL object identifiers come in 3 parts:
[catalog].[schema].[object]. The catalog is an object that
groups a set of Schema instances, which again group a set of objects,
where objects can be Table, Sequence, Routine and
many other types of objects.
If your RDBMS supports catalogs, and jOOQ supports using catalogs with your RDBMS, then generated catalog references can be used to fully qualify objects
Example:
// Assuming import static org.jooq.impl.DSL.*;
using(configuration)
.select(CATALOG.SCHEMA.ACTOR.FIRST_NAME, CATALOG.SCHEMA.ACTOR.LAST_NAME)
.from(CATALOG.SCHEMA.ACTOR)
.fetch();
Compatibility:
jOOQ supports catalogs in SQLDialect#SQLSERVER and related dialects,
such as SQLDialect#SQLDATAWAREHOUSE. Database products like
SQLDialect#MYSQL and related dialects, such as
SQLDialect#MARIADB use catalogs ("databases") instead of schemas, and
lack schema support. For historic reasons, jOOQ treats MySQL catalogs as
schemas and does not support any catalog qualifier in MySQL.
Instances can be created using DSL#catalog(Name) and overloads.
| Modifier and Type | Method and Description |
|---|---|
| public @Nullable Schema | |
| public @Nullable Schema | |
| public @NotNull List | |
| public @NotNull Stream |
| getSchema | back to summary |
|---|---|
| public @Nullable Schema getSchema(String name) Get a schema by its name (case-sensitive) in this catalog, or
| |
| getSchema | back to summary |
|---|---|
| public @Nullable Schema getSchema(Name name) Get a schema by its qualified or unqualified name in this catalog, or
| |
| getSchemas | back to summary |
|---|---|
| public @NotNull List List all schemas contained in this catalog.
| |
| schemaStream | back to summary |
|---|---|
| public @NotNull Stream Stream all schemas contained in this catalog.
| |