## Class TMssqlCommandBuilder

Description

TMssqlCommandBuilder provides specifics methods to create limit/offset query commands for MSSQL servers.

- since: 3.1
- version: $Id: TDbCommandBuilder.php 1863 2007-04-12 12:43:49Z wei $
- author: Wei Zhuo <weizho[at]gmail[dot]com>

Located in /Data/Common/Mssql/TMssqlCommandBuilder.php (line 24)

    TComponent
       |
       --TDbCommandBuilder
          |
          --TMssqlCommandBuilder

Method Summary
string applyLimitOffset (string $sql, [integer $limit = -1], [integer $offset = -1])
array findOrdering (string $sql)
integer getLastInsertID ()
string joinOrdering (array $orders)
array reverseDirection (array $orders)
sql rewriteLimitOffsetSql (string $sql, integer $limit, integer $offset)
Methods
applyLimitOffset (line 81)

Overrides parent implementation. Alters the sql to apply $limit and $offset.

The idea for limit with offset is done by modifying the sql on the fly with numerous assumptions on the structure of the sql string. The modification is done with reference to the notes from http://troels.arvin.dk/db/rdbms/#select-limit-offset

     SELECT * FROM (
      SELECT TOP n * FROM (
        SELECT TOP z columns      -- (z=n+skip)
        FROM tablename
        ORDER BY key ASC
      ) AS FOO ORDER BY key DESC -- ('FOO' may be anything)
     ) AS BAR ORDER BY key ASC    -- ('BAR' may be anything)

Regular expressions are used to alter the SQL query. The resulting SQL query may be malformed for complex queries. The following restrictions apply

- return: SQL with limit and offset.
- access: public

string applyLimitOffset (string $sql, [integer $limit = -1], [integer $offset = -1])

- string $sql: SQL query string.
- integer $limit: maximum number of rows, -1 to ignore limit.
- integer $offset: row offset, -1 to ignore offset.

Redefinition of:

TDbCommandBuilder::applyLimitOffset()
  Alters the sql to apply $limit and $offset. Default implementation is applicable for PostgreSQL, MySQL and SQLite.

findOrdering (line 118)

Base on simplified syntax http://msdn2.microsoft.com/en-us/library/aa259187(SQL.80).aspx

- return: ordering expression as key and ordering direction as value
- access: protected

array findOrdering (string $sql)

- string $sql

getLastInsertID (line 30)

Overrides parent implementation. Uses "SELECT @@Identity".

- return: last insert id, null if none is found.
- access: public

integer getLastInsertID ()

Redefinition of:

TDbCommandBuilder::getLastInsertID()
  Iterate through all the columns and returns the last insert id of the first column that has a sequence or serial.

joinOrdering (line 150)

- return: concat the orderings
- access: protected

string joinOrdering (array $orders)

- array $orders: ordering obtained from findOrdering()

reverseDirection (line 165)

- return: ordering with reversed direction.
- access: protected

array reverseDirection (array $orders)

- array $orders: original ordering

rewriteLimitOffsetSql (line 100)

Rewrite sql to apply $limit > and $offset > 0 for MSSQL database.

See http://troels.arvin.dk/db/rdbms/#select-limit-offset

- return: modified sql query applied with limit and offset.
- access: protected

sql rewriteLimitOffsetSql (string $sql, integer $limit, integer $offset)

- integer $limit: > 0
- integer $offset: > 0
- string $sql: sql query

#### Inherited Methods

Inherited From TDbCommandBuilder

> TDbCommandBuilder::__construct()
> TDbCommandBuilder::applyCriterias()
> TDbCommandBuilder::applyLimitOffset()
> TDbCommandBuilder::applyOrdering()
> TDbCommandBuilder::bindArrayValues()
> TDbCommandBuilder::bindColumnValues()
> TDbCommandBuilder::createCommand()
> TDbCommandBuilder::createCountCommand()
> TDbCommandBuilder::createDeleteCommand()
> TDbCommandBuilder::createFindCommand()
> TDbCommandBuilder::createInsertCommand()
> TDbCommandBuilder::createUpdateCommand()
> TDbCommandBuilder::getColumnBindings()
> TDbCommandBuilder::getDbConnection()
> TDbCommandBuilder::getInsertFieldBindings()
> TDbCommandBuilder::getLastInsertID()
> TDbCommandBuilder::getPdoType()
> TDbCommandBuilder::getSearchCondition()
> TDbCommandBuilder::getSearchExpression()
> TDbCommandBuilder::getTableInfo()
> TDbCommandBuilder::hasIntegerKey()
> TDbCommandBuilder::setDbConnection()
> TDbCommandBuilder::setTableInfo()

Inherited From TComponent

> TComponent::addParsedObject()
> TComponent::attachEventHandler()
> TComponent::canGetProperty()
> TComponent::canSetProperty()
> TComponent::createdOnTemplate()
> TComponent::detachEventHandler()
> TComponent::evaluateExpression()
> TComponent::evaluateStatements()
> TComponent::getEventHandlers()
> TComponent::getSubProperty()
> TComponent::hasEvent()
> TComponent::hasEventHandler()
> TComponent::hasProperty()
> TComponent::raiseEvent()
> TComponent::setSubProperty()
> TComponent::__get()
> TComponent::__set()

Documentation generated on Sun, 11 Jan 2009 20:23:10 -0500 by phpDocumentor 1.3.0RC4