com.splicemachine.derby.impl.sql.execute.actions

Class AlterTableConstantOperation

java.lang.Object

com.splicemachine.derby.impl.sql.execute.actions.DDLConstantOperation

com.splicemachine.derby.impl.sql.execute.actions.DDLSingleTableConstantOperation

com.splicemachine.derby.impl.sql.execute.actions.IndexConstantOperation

com.splicemachine.derby.impl.sql.execute.actions.AlterTableConstantOperation

All Implemented Interfaces:

ConstantAction, ScopeNamed

Direct Known Subclasses:

ModifyColumnConstantOperation, TruncateTableConstantOperation

public class AlterTableConstantOperation
extends IndexConstantOperation

This class describes actions that are ALWAYS performed for an ALTER TABLE Statement at Execution time.

Field Summary

Fields

Modifier and Type	Field and Description
protected int	behavior
protected ColumnInfo[]	columnInfo
protected IndexRowGenerator[]	compressIRGs
protected ConstantAction[]	constraintActions
protected java.lang.String	indexNameForStatistics
protected UUID	schemaId
protected SchemaDescriptor	sd
protected java.lang.String	tableName

Fields inherited from class com.splicemachine.derby.impl.sql.execute.actions.IndexConstantOperation

indexName, schemaName

Fields inherited from class com.splicemachine.derby.impl.sql.execute.actions.DDLSingleTableConstantOperation

tableId

Constructor Summary

Constructors

Constructor and Description
AlterTableConstantOperation(SchemaDescriptor sd, java.lang.String tableName, UUID tableId, ColumnInfo[] columnInfo, ConstantAction[] constraintActions, int behavior, java.lang.String indexNameForStatistics) Make the AlterAction for an ALTER TABLE statement.

Method Summary

Modifier and Type	Method and Description
protected void	doIndexUpdate(DataDictionary dd, TableDescriptor td, TransactionController tc, int index, long[] newIndexCongloms, ConglomerateDescriptor cd, java.util.Properties properties, boolean statisticsExist, DataValueDescriptor[] rowArray, ColumnOrdering[] columnOrder, int[] collationIds)
void	executeConstantAction(Activation activation) Run this constant action.
protected void	executeConstantActionBody(Activation activation)
protected void	executeConstraintActions(Activation activation)
protected static void	executeUpdate(LanguageConnectionContext lcc, java.lang.String updateStmt)
protected int	getAffectedIndexes(TableDescriptor td) Get info on the indexes on the table being compressed.
protected Txn	getChainedTransaction(TransactionController tc, Txn txnToWaitFor, long tableConglomId, java.lang.String alterTableActionName)
java.lang.String	getScopeName()
protected TableDescriptor	getTableDescriptor(LanguageConnectionContext lcc)
protected void	prepareDataDictionary(Activation activation) Do top-level DDL data dictionary prep for ALTER_TABLE.
java.lang.String	toString()
protected void	transformAndWriteToNewConglomerate(Activation activation, TxnView parentTxn, com.splicemachine.ddl.DDLMessage.DDLChange ddlChange, long baseConglomNumber, long destConglom, long demarcationPoint)
protected void	updateAllIndexes(Activation activation, long newHeapConglom, TableDescriptor td, TransactionController tc)
protected void	updateIndex(long newBaseConglom, Activation activation, TransactionController tc, TableDescriptor td, int index, long[] newIndexCongloms)
protected ConglomerateDescriptor	updateTableConglomerateDescriptor(TableDescriptor tableDescriptor, long newConglomNum, SchemaDescriptor sd, LanguageConnectionContext lcc, ConstraintConstantOperation constraintAction) Do what's necessary to update a table descriptor that's been modified due to alter table actions.

Methods inherited from class com.splicemachine.derby.impl.sql.execute.actions.IndexConstantOperation

beginChildTransaction, getIndexName, populateIndex, setIndexName

Methods inherited from class com.splicemachine.derby.impl.sql.execute.actions.DDLSingleTableConstantOperation

dropConglomerate, dropConglomerate, dropConstraint, dropConstraint, dropConstraint, dropIndex, executeConglomReplacement, getConglomReplacementAction, recreateUniqueConstraintBackingIndexAsUniqueWhenNotNull

Methods inherited from class com.splicemachine.derby.impl.sql.execute.actions.DDLConstantOperation

addColumnDependencies, adjustUDTDependencies, adjustUDTDependencies, constructToString, getAndCheckSchemaDescriptor, getBlockedTables, getSchemaDescriptorForCreate, noGrantCheck, noRevokeCheck, storeConstraintDependenciesOnPrivileges, storeViewTriggerDependenciesOnPrivileges, waitForConcurrentTransactions, waitsForConcurrentTransactions

Methods inherited from class java.lang.Object

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

Field Detail

sd

protected SchemaDescriptor sd

tableName

protected java.lang.String tableName

schemaId

protected UUID schemaId

columnInfo

protected ColumnInfo[] columnInfo

constraintActions

protected ConstantAction[] constraintActions

behavior

protected int behavior

indexNameForStatistics

protected java.lang.String indexNameForStatistics

compressIRGs

protected IndexRowGenerator[] compressIRGs

Constructor Detail

AlterTableConstantOperation

public AlterTableConstantOperation(SchemaDescriptor sd,
                                   java.lang.String tableName,
                                   UUID tableId,
                                   ColumnInfo[] columnInfo,
                                   ConstantAction[] constraintActions,
                                   int behavior,
                                   java.lang.String indexNameForStatistics)

Make the AlterAction for an ALTER TABLE statement.

Parameters:

sd - descriptor for the table's schema.

tableName - Name of table.

tableId - UUID of table

columnInfo - Information on all the columns in the table.

constraintActions - ConstraintConstantAction[] for constraints

behavior - drop behavior for dropping column

indexNameForStatistics - Will name the index whose statistics

Method Detail

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

executeConstantAction

public void executeConstantAction(Activation activation)
                           throws StandardException

Run this constant action.

Parameters:

activation - the activation in which to run the action

Throws:

StandardException - if an error happens during execution of the action

executeConstantActionBody

protected void executeConstantActionBody(Activation activation)
                                  throws StandardException

Throws:

StandardException

prepareDataDictionary

protected void prepareDataDictionary(Activation activation)
                              throws StandardException

Do top-level DDL data dictionary prep for ALTER_TABLE. For in-place data dictionary changes, this will suffice. For more fine-grained DDL work, like PK add/drop, we will need to copy the conglomerate contents by creating a sub txn to get the table demarcation point (last active txn), create the appropriate row translator, start a PK DDL prepare and execute the changes.
Executing this method will do no harm in that case.

Parameters:

activation - the activation execution the alter table.

Throws:

StandardException

executeConstraintActions

protected void executeConstraintActions(Activation activation)
                                 throws StandardException

Throws:

StandardException

updateAllIndexes

protected void updateAllIndexes(Activation activation,
                                long newHeapConglom,
                                TableDescriptor td,
                                TransactionController tc)
                         throws StandardException

Throws:

StandardException

updateIndex

protected void updateIndex(long newBaseConglom,
                           Activation activation,
                           TransactionController tc,
                           TableDescriptor td,
                           int index,
                           long[] newIndexCongloms)
                    throws StandardException

Throws:

StandardException

doIndexUpdate

protected void doIndexUpdate(DataDictionary dd,
                             TableDescriptor td,
                             TransactionController tc,
                             int index,
                             long[] newIndexCongloms,
                             ConglomerateDescriptor cd,
                             java.util.Properties properties,
                             boolean statisticsExist,
                             DataValueDescriptor[] rowArray,
                             ColumnOrdering[] columnOrder,
                             int[] collationIds)
                      throws StandardException

Throws:

StandardException

getAffectedIndexes

protected int getAffectedIndexes(TableDescriptor td)
                          throws StandardException

Get info on the indexes on the table being compressed.

Throws:

StandardException - Thrown on error

getTableDescriptor

protected TableDescriptor getTableDescriptor(LanguageConnectionContext lcc)
                                      throws StandardException

Throws:

StandardException

executeUpdate

protected static void executeUpdate(LanguageConnectionContext lcc,
                                    java.lang.String updateStmt)
                             throws StandardException

Throws:

StandardException

updateTableConglomerateDescriptor

protected ConglomerateDescriptor updateTableConglomerateDescriptor(TableDescriptor tableDescriptor,
                                                                   long newConglomNum,
                                                                   SchemaDescriptor sd,
                                                                   LanguageConnectionContext lcc,
                                                                   ConstraintConstantOperation constraintAction)
                                                            throws StandardException

Do what's necessary to update a table descriptor that's been modified due to alter table actions. Sometimes an action only requires changing the conglomerate number since a new conglomerate has been created to replaced the old. Other times the table descriptor's main conglomerate descriptor needs to be dropped and recreated.

Parameters:

tableDescriptor - the table descriptor that's being effected.

newConglomNum - the conglomerate number of the conglomerate that's been created to replace the old.

sd - descriptor for the schema in which the new conglomerate lives.

lcc - language connection context required for coordination.

constraintAction - constraint being created, dropped, etc

Returns:

the modified conglomerate descriptor.

Throws:

StandardException

getChainedTransaction

protected Txn getChainedTransaction(TransactionController tc,
                                    Txn txnToWaitFor,
                                    long tableConglomId,
                                    java.lang.String alterTableActionName)
                             throws StandardException

Throws:

StandardException

transformAndWriteToNewConglomerate

protected void transformAndWriteToNewConglomerate(Activation activation,
                                                  TxnView parentTxn,
                                                  com.splicemachine.ddl.DDLMessage.DDLChange ddlChange,
                                                  long baseConglomNumber,
                                                  long destConglom,
                                                  long demarcationPoint)
                                           throws java.io.IOException,
                                                  StandardException

Throws:

java.io.IOException

StandardException

getScopeName

public java.lang.String getScopeName()

Specified by:

getScopeName in interface ScopeNamed

Overrides:

getScopeName in class IndexConstantOperation