This object represents an index on a table. Indexes consist of columns and optional prefixes for each column. The prefix specifies how many characters of the columns should be indexes (the first X chars). Some RDBMS's do not have a concept of index prefixes. Not all column types are likely to allow prefixes though this depends on the RDBMS. The order of the columns is significant.

INHERITS FROM

Alzabo::Index

Note: all relevant documentation from the superclass has been merged into this document.

METHODS

new

Parameters

table => Alzabo::Create::Table object
The table that this index is indexing.
columns => [ { column => Alzabo::Create::Column object, prefix => $prefix }, repeat as needed ... ]
This is a list of columns that are being indexes. The prefix part of the hashref is optional.
unique => $boolean
Indicates whether or not this is a unique index.
fulltext => $boolean
Indicates whether or not this is a fulltext index.

Returns

A new Alzabo::Create::Index object.

table

Returns

The Alzabo::Create::Table object to which the index belongs.

columns

Returns

An ordered list of the Alzabo::Create::Column objects that are being indexed.

add_column

Add a column to the index.

Parameters

column => Alzabo::Create::Column object
prefix => $prefix (optional)

delete_column (`Alzabo::Create::Column` object)

Delete the given column from the index.

prefix (`Alzabo::Create::Column` object)

A column prefix is, to the best of my knowledge, a MySQL specific concept, and as such cannot be set when using an RDBMSRules module for a different RDBMS. However, it is important enough for MySQL to have the functionality be present. It allows you to specify that the index should only look at a certain portion of a field (the first N characters). This prefix is required to index any sort of BLOB column in MySQL.

Returns

This method returns the prefix for the column in the index. If there is no prefix for this column in the index, then it returns undef.

set_prefix

Parameters

column => Alzabo::Create::Column object
prefix => $prefix

unique

Returns

A boolean value indicating whether or not the index is a unique index.

set_unique ($boolean)

Set whether or not the index is a unique index.

fulltext

Returns

A boolean value indicating whether or not the index is a fulltext index.

set_fulltext ($boolean)

Set whether or not the index is a fulltext index.

register_column_name_change

Parameters

column => Alzabo::Create::Column object
The column (with the new name already set).
old_name => $old_name

Called by the owning table object when a column changes. You should never need to call this yourself.

id

The id is generated from the table, column and prefix information for the index. This is useful as a canonical name for a hash key, for example.

Returns

A string that is the id for the index.

AUTHOR

Dave Rolsky, <autarch@urth.org>

Alzabo::Create::Index - Index objects for schema creation