/ 
Fey-0.11
River stage one • 6 direct dependents • 9 total dependents
/ Fey::SQL::Update

NAME

Fey::SQL::Update - Represents a UPDATE query

SYNOPSIS

my $sql = Fey::SQL->new_update();

# UPDATE Part
#    SET quantity = 10
#  WHERE part_id IN (1, 5)
$sql->update($Part);
$sql->set( $quantity, 10 );
$sql->where( $part_id, 'IN', 1, 5 );

print $sql->sql($dbh);

DESCRIPTION

This class represents a UPDATE query.

METHODS

This class provides the following methods:

Constructor

To construct an object of this class, call $query->update() on a Fey::SQL object.

$update->update()

This method specifies the UPDATE clause of the query. It expects one or more Fey::Table objects (not aliases). Most RDBMS implementations only allow for a single table here, but some (like MySQL) do allow for multi-table updates.

$update->set(...)

This method takes a list of key/value pairs. The keys should be column objects, and the value can be one of the following:

  • a plain scalar, including undef

    This will be passed to Fey::Literal->new_from_scalar().

  • Fey::Literal object

  • Fey::Column object

    A column alias cannot be used.

  • Fey::Placeholder object

$update->where(...)

See the Fey::SQL section on WHERE Clauses for more details.

$update->order_by(...)

See the Fey::SQL section on ORDER BY Clauses for more details.

$update->limit(...)

See the Fey::SQL section on LIMIT Clauses for more details.

$update->sql($dbh)

Returns the full SQL statement which this object represents. A DBI handle must be passed so that identifiers can be properly quoted.

$update->bind_params()

See the Fey::SQL section on Bind Parameters for more details.

ROLES

This class does Fey::Role::SQL::HasWhereClause, Fey::Role::SQL::HasOrderByClause, and Fey::Role::SQL::HasLimitClause roles.

AUTHOR

Dave Rolsky, <autarch@urth.org>

BUGS

See Fey for details on how to report bugs.

COPYRIGHT & LICENSE

Copyright 2006-2008 Dave Rolsky, All Rights Reserved.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.