- skip to content

# Database Abstraction Layer

### User Tools

- Login

### Site Tools

- Recent changes
- Media Manager
- Sitemap

### Sidebar

##### Resources

- Reference Manual
- User Guide
- The Data Dictionary
- ADOdb-xmlschema
- ADOdb Active Record
- Performance Monitoring
- Date/Time Library
- Session Management Library
- Unsupported Addons
- Coding Standards

##### Supported Databases

- Access
- ADO
- CSV
- Firebird
- Frontbase
- IBM DB2
- Informix
- Interbase
- LDAP
- Microsoft SQL Server
- MySQL
- Netezza
- ODBC
- ODBTP
- Oracle
- PDO
- Postgresql
- SAP ADS
- SAP ASE
- SAP Maxdb
- SAP Sqlanywhere
- Sqlite
- Sybase
- Plain Text
- Visual Foxpro

##### Other

- Feature Comparison Matrix
- Connection Matrix
- Include File Guide

v5:dictionary:addcolumnsql

# addColumnSql

##### See Also

Column Attributes Reference

##### Syntax

    array addColumnSql(
        string $tableName,
        string $columnData
        )

## Description

The method `addColumnSql()` creates the SQL statement necessary to add one or more columns to an existing table, given by `$tableName`, with the attributes specified in the string `$columnData`. The column(s) must not already exist in the specified table. To add multiple columns, separate each column specification with a ','.

The information specified in the `$columnData` string must conform to the Column Attributes standard.

In order to actually create the column, the returned array must be passed to the executeSqlArray() method.

## Usage

    /*
     * Connecting to IBM DB2 database
    */

    /*
     * Create dictionary object
    */
    $dict = NewDataDictionary($db);
    /*
     * Add 2 new columns to table
    */
    $columns = 'ACTNOTES X, ACTMAXSALE N 12.2';
    $sqlarray = $dict->addColumnSql('ACT',$columns);

    print_r($sqlarray);

    /*
     * Prints
    Array
    (
     [0] => ALTER TABLE ACT ADD ACTNOTES VARCHAR(3600)
     [1] => ALTER TABLE ACT ADD ACTMAXSALE DECIMAL(12,2)
    )
    */

    /*
     * Now execute the statements to actually create the columns
     */
    $ok = $dict->executeSqlArray($sqlarray);

v5/dictionary/addcolumnsql.txt · Last modified: 2016/01/12 17:06 by mnewnham

### Page Tools

- Show pagesource
- Old revisions
- Backlinks
- Rename Page
- Back to top