Package io.debezium.connector.jdbc.dialect.postgres

Class PostgresDatabaseDialect

java.lang.Object

io.debezium.connector.jdbc.dialect.GeneralDatabaseDialect

io.debezium.connector.jdbc.dialect.postgres.PostgresDatabaseDialect

All Implemented Interfaces:

DatabaseDialect

public class PostgresDatabaseDialect
extends GeneralDatabaseDialect

A DatabaseDialect implementation for PostgreSQL.

Author:

Chris Cranford

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	PostgresDatabaseDialect.PostgresDatabaseDialectProvider

Constructor Summary

Constructors

Modifier	Constructor	Description
private	PostgresDatabaseDialect(JdbcSinkConnectorConfig config, org.hibernate.SessionFactory sessionFactory)

Method Summary

Modifier and Type	Method	Description
String	getAlterTableColumnPrefix()	Gets the prefix used before adding each column-clause to ALTER TABLE statements.
String	getAlterTablePrefix()	Gets the prefix used before adding column-clauses in ALTER TABLE statements.
String	getAlterTableSuffix()	Gets the suffix used after adding the column-clauses in ALTER TABLE statements.
String	getByteArrayFormat()	Returns the default format for binding a byte array
protected Optional<String>	getDatabaseTimeZoneQuery()
String	getFormattedBoolean(boolean value)	Format a boolean.
String	getFormattedDateTimeWithNanos(TemporalAccessor value)	Format a date and time with nonoseconds.
String	getFormattedTime(TemporalAccessor value)	Format a time.
int	getMaxTimestampPrecision()	Gets the maximum precision allowed for a dialect's timestamp data type.
int	getMaxVarcharLengthInKey()	Gets the maximum length of a VARCHAR field in a primary key column.
String	getQueryBindingWithValueCast(ColumnDescriptor column, org.apache.kafka.connect.data.Schema schema, Type type)	Returns the SQL binding fragment for a column, schema, and type mapping.
String	getUpsertStatement(TableDescriptor table, SinkRecordDescriptor record)	Construct a UPSERT statement specific for this dialect.
TableDescriptor	readTable(Connection connection, TableId tableId)	Read the table structure data from the database.
protected void	registerTypes()
protected String	resolveColumnNameFromField(String fieldName)
boolean	tableExists(Connection connection, TableId tableId)	Check whether the specified table exists.

Methods inherited from class io.debezium.connector.jdbc.dialect.GeneralDatabaseDialect

addColumnDefaultValue, bindValue, columnNameFromField, columnNameFromField, columnQueryBindingFromField, getAlterTableColumnDelimiter, getAlterTableColumnSuffix, getAlterTableStatement, getColumnNamingStrategy, getConfig, getCreateTableStatement, getDatabaseTimeZone, getDatabaseTimeZoneQueryResult, getDatabaseVersion, getDefaultDecimalPrecision, getDefaultTimestampPrecision, getDeleteStatement, getFormattedDate, getFormattedDateTime, getFormattedTimestamp, getFormattedTimestampWithTimeZone, getFormattedTimeWithTimeZone, getIdentifierHelper, getInsertStatement, getMaxNVarcharLengthInKey, getMaxVarbinaryLength, getQualifiedTableName, getSchemaType, getTableId, getTruncateStatement, getTypeName, getTypeName, getTypeName, getUpdateStatement, getVersion, isIdentifierUppercaseWhenNotQuoted, isNegativeScaleAllowed, isTimeZoneSet, registerType, resolveColumnName, resolveMissingFields, shouldBindTimeWithTimeZoneAsDatabaseTimeZone, toIdentifier, toIdentifier

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface io.debezium.connector.jdbc.dialect.DatabaseDialect

getMaxTimePrecision, getTimeQueryBinding

Constructor Details

PostgresDatabaseDialect

private PostgresDatabaseDialect(JdbcSinkConnectorConfig config,
 org.hibernate.SessionFactory sessionFactory)

Method Details

getMaxTimestampPrecision

public int getMaxTimestampPrecision()

Description copied from interface: DatabaseDialect

Gets the maximum precision allowed for a dialect's timestamp data type.

Returns:

maximum timestamp precision

tableExists

public boolean tableExists(Connection connection,
 TableId tableId)
                    throws SQLException

Description copied from interface: DatabaseDialect

Check whether the specified table exists.

Specified by:

tableExists in interface DatabaseDialect

Overrides:

tableExists in class GeneralDatabaseDialect

Parameters:

connection - the database connection to be used, should not be null.

tableId - the table identifier, should not be null.

Returns:

true if the table exists, false otherwise

Throws:

SQLException - if a database exception occurs

readTable

public TableDescriptor readTable(Connection connection,
 TableId tableId)
                          throws SQLException

Description copied from interface: DatabaseDialect

Read the table structure data from the database.

Specified by:

readTable in interface DatabaseDialect

Overrides:

readTable in class GeneralDatabaseDialect

Parameters:

connection - the database connection to be used, should not be null.

tableId - the table identifier, should not be null.

Returns:

the table relational model if it exists

Throws:

SQLException - if the table does not exist or a database exception occurs

getAlterTablePrefix

public String getAlterTablePrefix()

Description copied from interface: DatabaseDialect

Gets the prefix used before adding column-clauses in ALTER TABLE statements.

Specified by:

getAlterTablePrefix in interface DatabaseDialect

Overrides:

getAlterTablePrefix in class GeneralDatabaseDialect

Returns:

the alter table column-clauses prefix

getAlterTableSuffix

public String getAlterTableSuffix()

Description copied from interface: DatabaseDialect

Gets the suffix used after adding the column-clauses in ALTER TABLE statements.

Specified by:

getAlterTableSuffix in interface DatabaseDialect

Overrides:

getAlterTableSuffix in class GeneralDatabaseDialect

Returns:

the alter table column-clauses suffix

getAlterTableColumnPrefix

public String getAlterTableColumnPrefix()

Description copied from interface: DatabaseDialect

Gets the prefix used before adding each column-clause to ALTER TABLE statements.

Specified by:

getAlterTableColumnPrefix in interface DatabaseDialect

Overrides:

getAlterTableColumnPrefix in class GeneralDatabaseDialect

Returns:

the alter table prefix just before each column-clause

getUpsertStatement

public String getUpsertStatement(TableDescriptor table,
 SinkRecordDescriptor record)

Description copied from interface: DatabaseDialect

Construct a UPSERT statement specific for this dialect.

Specified by:

getUpsertStatement in interface DatabaseDialect

Overrides:

getUpsertStatement in class GeneralDatabaseDialect

Parameters:

table - the current relational table model, should not be null

record - the current sink record being processed, should not be null

Returns:

the upsert SQL statement to be executed, never null

getQueryBindingWithValueCast

public String getQueryBindingWithValueCast(ColumnDescriptor column,
 org.apache.kafka.connect.data.Schema schema,
 Type type)

Description copied from interface: DatabaseDialect

Returns the SQL binding fragment for a column, schema, and type mapping.

Specified by:

getQueryBindingWithValueCast in interface DatabaseDialect

Overrides:

getQueryBindingWithValueCast in class GeneralDatabaseDialect

Parameters:

column - the relational column type, never null

schema - the field schema type, never null

type - the resolved field type, never null

Returns:

the query binding SQL fragment

getByteArrayFormat

public String getByteArrayFormat()

Description copied from interface: DatabaseDialect

Returns the default format for binding a byte array

Specified by:

getByteArrayFormat in interface DatabaseDialect

Overrides:

getByteArrayFormat in class GeneralDatabaseDialect

Returns:

the format for binding a byte array

getFormattedBoolean

public String getFormattedBoolean(boolean value)

Description copied from interface: DatabaseDialect

Format a boolean.

Specified by:

getFormattedBoolean in interface DatabaseDialect

Overrides:

getFormattedBoolean in class GeneralDatabaseDialect

Parameters:

value - the boolean value

Returns:

the formatted string value

getFormattedDateTimeWithNanos

public String getFormattedDateTimeWithNanos(TemporalAccessor value)

Description copied from interface: DatabaseDialect

Format a date and time with nonoseconds.

Specified by:

getFormattedDateTimeWithNanos in interface DatabaseDialect

Overrides:

getFormattedDateTimeWithNanos in class GeneralDatabaseDialect

Parameters:

value - the value to be formatted, never null

Returns:

the formatted string value

getFormattedTime

public String getFormattedTime(TemporalAccessor value)

Description copied from interface: DatabaseDialect

Format a time.

Specified by:

getFormattedTime in interface DatabaseDialect

Overrides:

getFormattedTime in class GeneralDatabaseDialect

Parameters:

value - the value to be formatted, never null

Returns:

the formatted string value

getDatabaseTimeZoneQuery

protected Optional<String> getDatabaseTimeZoneQuery()

Overrides:

getDatabaseTimeZoneQuery in class GeneralDatabaseDialect

registerTypes

protected void registerTypes()

Overrides:

registerTypes in class GeneralDatabaseDialect

getMaxVarcharLengthInKey

public int getMaxVarcharLengthInKey()

Description copied from interface: DatabaseDialect

Gets the maximum length of a VARCHAR field in a primary key column.

Specified by:

getMaxVarcharLengthInKey in interface DatabaseDialect

Overrides:

getMaxVarcharLengthInKey in class GeneralDatabaseDialect

Returns:

maximum varchar field length when participating in the primary key

resolveColumnNameFromField

protected String resolveColumnNameFromField(String fieldName)

Overrides:

resolveColumnNameFromField in class GeneralDatabaseDialect