SQL-Abstract-More-1.42000755000000000000 014553555043 15100 5ustar00unknownunknown000000000000SQL-Abstract-More-1.42/Build.PL000444000000000000 223214526355532 16531 0ustar00unknownunknown000000000000use 5.008; use strict; use warnings; use Module::Build; my $builder = Module::Build->new( module_name => 'SQL::Abstract::More', license => 'perl', dist_author => 'Laurent Dami ', dist_version_from => 'lib/SQL/Abstract/More.pm', requires => { 'perl' => 5.008, 'MRO::Compat' => 0, 'SQL::Abstract::Classic' => 0, 'Params::Validate' => 0, 'parent' => 0, 'namespace::clean' => 0, 'Scalar::Util' => 0, }, configure_requires => { 'Module::Build' => 0, }, build_requires => { # dependencies below should really be 'test_requires' .. but it does not work in perl 5.10 :-( 'Test::More' => 0, 'Test::Exception' => 0, 'SQL::Abstract::Test' => 0, 'List::MoreUtils' => 0, }, add_to_cleanup => [ 'SQL-Abstract-More-*' ], meta_merge => { resources => { repository => 'https://github.com/damil/SQL-Abstract-More', } }, ); $builder->create_build_script(); SQL-Abstract-More-1.42/Changes000444000000000000 1332114553553236 16552 0ustar00unknownunknown000000000000Revision history for SQL-Abstract-More 1.42 22.01.2024 - backcompat : accept select(-from => $arrayref) and select(-from => $scalarref) 1.41 21.01.2024 - support for subqueries as columns in a select list or as a source in -from clause - new parameter ->select(... -as => $alias) - support table aliases on simple tables - internal refactorings for better clarity of the select() method 1.40 19.11.2023 - new dialect "Oracle12c" for using query_limiting clauses in Oracle version 12c or greater - internals : replaced Module::Install by Module::Build 1.39 22.07.2022 - back to SQL::Abstract::Classic as default parent class, because of compatibility issues with special_operators 1.38 02.04.2022 - support -having without -group_by, since some DBMS admit this syntax (Rouzier++) 1.37 29.01.2021 - avoid defined-or operator (//), not admitted in perl 5.8 1.36 28.01.2021 - fix inheritance bug with SQL::Abstract v2.0 (RT#134151) - can inherit from SQL::Abstract::Classic through '-extends' arg to import() 1.35 24.01.2021 - new arg -final_clause for with() - temporary fix for RT#134127 -- wait for resolution of RT#134128 1.34 01.01.2021 - support for common table expressions (WITH RECURSIVE) - support for -add_sql parameter in insert/update/delete (additional SQL keywords) - support for insert(-select => ..) - internals : - rearrange update() because the parent method was refactored in SQLA 1.85 - report errors through puke/belch instead of croak/carp - fixed tests for bind_params() -- no longer necessary to monkey patch DBD::Mock, and the old tests were plainly wrong ! 1.33 14.01.2018 - removed the option introduced in 1.32, replaced by new syntax for "USING" 1.32 08.01.2018 - new option "join_with_USING" 1.31 12.12.2017 - align _insert_values / _insert_value on new parent SQLA architecture - does() also handles overloaded SCALAR and CODE dereferencing and is visible by external modules 1.30 29.10.2017 - fix typo in dependency on SQL::Abstract (require v1.84, not 1.74) 1.29 28.10.2017 - syntax >=< for full outer joins - support for joins in update() (rouzier++) - support for -returning arg in update() - Respect +- prefixes for update and delete and allow binds for select order by (rouzier++) 1.28 05.07.2016 - support for quoting table and column names - fix warning 'redundant' appeared in perl 5.22 1.27 06.04.2015 - added support for IN clauses with multicolumns 1.26 16.10.2014 - RT 99455 : ignore initial or trailing spaces in column alias parsing 1.25 03.10.2014 - fixed Scalar::Does dependency in Makefile.PL 1.24 03.10.2014 - RT 99182 : recent versions of Scalar::Does are too heavy, drop the dependency 1.23 13.08.2014 - bug fix, v1.22 no longer accepted syntax x|alias when x has length 1 1.22 09.08.2014 - avoid interference of '|' for column aliases with builtin DBMS operators - also accept new() args as a hashref - run the whole SQLA test suite against SQLAM 1.21 20.04.2014 - fix missing test dependency - switch to Module::Install 1.20 18.04.2014 - support for -order_by/-limit in update() and delete() (MySQL accepts that!) - -limit => 0 is no longer ignored 1.19 01.02.2014 - better implementation for bind values within join specifications 1.18 31.01.2014 - added support for bind values (as quoted strings) within join specifications 1.17 22.07.2013 - fixed incorrect treatment of -limit for "RowNum" dialect (used by Oracle) 1.16 16.07.2013 - fixed doc for join() (description of the return value) - fix for RT 86895 (incorrect treatment of -order_by / -group_by) 1.15 18.04.2013 - bind values with types : dropped syntax [$value, \%type] because of conflicts with "OR" clauses of shape [$condition1, \%condition2]; so only DBIx::Class-like syntax will be accepted 1.14 14.04.2013 - fix bug introduced in v1.13 (return "" instead of return ()) 1.13 14.04.2013 - "looks_like_ternary_bind_param" renamed as "is_bind_value_with_type" - support for DBIx::Class syntax of bind values with types 1.12 08.04.2013 - fix missing bits for supporting arrayrefs in insert(), update() - improvements in doc 1.11 07.04.2013 - bind_params supports 3-args form of DBI::bind_param() - values in select(), insert(), update() can be arrayrefs [$value, \%type] 1.10 15.01.2013 - support for -desc/-asc in -order_by (compatibility with SQL::Abstract) 1.09 08.12.2012 - dependency on SQL::Abstract 1.73 because of -ident/-value 1.08 30.11.2012 - [rt.cpan.org #81305] replace \'=foo.bar' by {'=' => {-ident => 'foo.bar'}} - [rt.cpan.org #81485] systematically order "keys %hash" for perl 5.17.6 1.07 20.10.2012 - replace reftype tests by Scalar::Does - no longer warns on -where => {field => {-in => $scalar}} 1.06 02.08.2012 - fix in test that no longer passed with SQL::Abstract::Test v1.73 1.05 31.05.2012 - forgot dependency on MRO::Compat 1.04 29.05.2012 - [rt.cpan.org #77374] Use namespace::clean instead of namespace::autoclean - added support for set operators (UNION/INTERSECT/MINUS/etc.) 1.03 17.03.2012 - added support for Oracle INSERT ... RETURNING .. INTO .. - croak() instead of die() upon errors 1.02 13.03.2012 - unbless arrayrefs passed to _where_field_IN, to make SQLA happy 1.01 08.03.2012 - fixed sql_dialect for Oracle : no 'AS' keyword in table aliases 1.00 15.12.2011 - added methods insert(), update(), delete() 0.06 13.12.2011 - new parameter 'max_members_IN' 0.05 07.10.2011 - limit_offset dialect "RowNum", for @§%#! Oracle 0.04 28.08.2011 - doc fix, thanks to Terrence Brannon 0.03 07.08.2011 - added dependency on 'parent.pm' in Build.PL 0.02 03.08.2011 - Fixed stupid pod test 0.01 31.07.2011 - First release (code extracted and refactored from DBIx::DataModel) SQL-Abstract-More-1.42/MANIFEST000444000000000000 56114526356045 16351 0ustar00unknownunknown000000000000Changes lib/SQL/Abstract/More.pm Build.PL MANIFEST This list of files META.yml META.json README t/01-sql_abstract_more.t t/02-order-by.t t/03-join_with_constants.t t/04-multicols_in.t t/05-join-with-using.t t/06_with_table_expression.t t/07-import.t t/99_sqla_tests.t t/classic/parent_classic.t t/lib/UsurpSQLA.pm t/rt_084972.t t/rt_086895.t t/rt_099455.t xt/pod.t SQL-Abstract-More-1.42/META.json000444000000000000 300714553555043 16656 0ustar00unknownunknown000000000000{ "abstract" : "extension of SQL::Abstract with more constructs and more flexible API", "author" : [ "Laurent Dami " ], "dynamic_config" : 1, "generated_by" : "Module::Build version 0.4232", "license" : [ "perl_5" ], "meta-spec" : { "url" : "http://search.cpan.org/perldoc?CPAN::Meta::Spec", "version" : 2 }, "name" : "SQL-Abstract-More", "prereqs" : { "build" : { "requires" : { "List::MoreUtils" : "0", "SQL::Abstract::Test" : "0", "Test::Exception" : "0", "Test::More" : "0" } }, "configure" : { "requires" : { "Module::Build" : "0" } }, "runtime" : { "requires" : { "MRO::Compat" : "0", "Params::Validate" : "0", "SQL::Abstract::Classic" : "0", "Scalar::Util" : "0", "namespace::clean" : "0", "parent" : "0", "perl" : "5.008" } } }, "provides" : { "SQL::Abstract::More" : { "file" : "lib/SQL/Abstract/More.pm", "version" : "1.42" } }, "release_status" : "stable", "resources" : { "license" : [ "http://dev.perl.org/licenses/" ], "repository" : { "url" : "https://github.com/damil/SQL-Abstract-More" } }, "version" : "1.42", "x_serialization_backend" : "JSON::PP version 4.05" } SQL-Abstract-More-1.42/META.yml000444000000000000 171414553555043 16511 0ustar00unknownunknown000000000000--- abstract: 'extension of SQL::Abstract with more constructs and more flexible API' author: - 'Laurent Dami ' build_requires: List::MoreUtils: '0' SQL::Abstract::Test: '0' Test::Exception: '0' Test::More: '0' configure_requires: Module::Build: '0' dynamic_config: 1 generated_by: 'Module::Build version 0.4232, CPAN::Meta::Converter version 2.150010' license: perl meta-spec: url: http://module-build.sourceforge.net/META-spec-v1.4.html version: '1.4' name: SQL-Abstract-More provides: SQL::Abstract::More: file: lib/SQL/Abstract/More.pm version: '1.42' requires: MRO::Compat: '0' Params::Validate: '0' SQL::Abstract::Classic: '0' Scalar::Util: '0' namespace::clean: '0' parent: '0' perl: '5.008' resources: license: http://dev.perl.org/licenses/ repository: https://github.com/damil/SQL-Abstract-More version: '1.42' x_serialization_backend: 'CPAN::Meta::YAML version 0.018' SQL-Abstract-More-1.42/README000444000000000000 204714526340314 16111 0ustar00unknownunknown000000000000SQL-Abstract-More This subclass of L handles a few additional SQL constructs, and provides an improved API with named parameters instead of positional parameters. It was designed for the specific needs of L but is published as a separate distribution, because it may possibly be useful for other needs. INSTALLATION To install this module, run the following commands: perl Makefile.PL make (or gmake on Windows Strawberry Perl) make test make install SUPPORT AND DOCUMENTATION After installing, you can find documentation for this module with the perldoc command. perldoc SQL::Abstract::More The same documentation is also available at https://metacpan.org/module/SQL::Abstract::More LICENSE AND COPYRIGHT Copyright (C) 2011-2023 Laurent Dami This program is free software; you can redistribute it and/or modify it under the terms of either: the GNU General Public License as published by the Free Software Foundation; or the Artistic License. See https://dev.perl.org/licenses/ for more information. SQL-Abstract-More-1.42/lib000755000000000000 014553555043 15646 5ustar00unknownunknown000000000000SQL-Abstract-More-1.42/lib/SQL000755000000000000 014553555043 16305 5ustar00unknownunknown000000000000SQL-Abstract-More-1.42/lib/SQL/Abstract000755000000000000 014553555043 20050 5ustar00unknownunknown000000000000SQL-Abstract-More-1.42/lib/SQL/Abstract/More.pm000444000000000000 26266714553554510 21526 0ustar00unknownunknown000000000000package SQL::Abstract::More; use strict; use warnings; # no "use parent ..." here -- the inheritance is specified dynamically in the # import() method -- inheriting either from SQL::Abstract or SQL::Abstract::Classic use MRO::Compat; use mro 'c3'; # implements next::method use Params::Validate qw/validate SCALAR SCALARREF CODEREF ARRAYREF HASHREF UNDEF BOOLEAN/; use Scalar::Util qw/blessed reftype/; # remove all previously defined or imported functions use namespace::clean; # declare error-reporting functions from SQL::Abstract sub puke(@); sub belch(@); # these will be defined later in import() our $VERSION = '1.42'; our @ISA; sub import { my $class = shift; # parent class specified from environment variable, or default value my $parent_sqla = $ENV{SQL_ABSTRACT_MORE_EXTENDS} || 'SQL::Abstract::Classic'; # parent class specified through -extends => .. when calling import() $parent_sqla = $_[1] if @_ >= 2 && $_[0] eq '-extends'; # syntactic sugar : 'Classic' is expanded into SQLA::Classic $parent_sqla = 'SQL::Abstract::Classic' if $parent_sqla eq 'Classic'; # make sure that import() is never called with different parents if (my $already_isa = $ISA[0]) { $already_isa eq $parent_sqla or die "cannot use SQL::Abstract::More -extends => '$parent_sqla', " . "this module was already loaded with -extends => '$already_isa'"; # the rest of the import() job was already performed, so just return from here return; } # load the parent, inherit from it, import puke() and belch() eval qq{use parent '$parent_sqla'; *puke = \\&${parent_sqla}::puke; *belch = \\&${parent_sqla}::belch; }; # local override of some methods for insert() and update() _setup_insert_inheritance($parent_sqla); _setup_update_inheritance($parent_sqla); } #---------------------------------------------------------------------- # Utility functions -- not methods -- declared _after_ # namespace::clean so that they can remain visible by external # modules. In particular, DBIx::DataModel imports these functions. #---------------------------------------------------------------------- # shallow_clone(): copies of the top-level keys and values, blessed into the same class sub shallow_clone { my ($orig, %override) = @_; my $class = ref $orig or puke "arg must be an object"; my $clone = {%$orig, %override}; return bless $clone, $class; } # does(): cheap version of Scalar::Does my %meth_for = ( ARRAY => '@{}', HASH => '%{}', SCALAR => '${}', CODE => '&{}', ); sub does ($$) { my ($data, $type) = @_; my $reft = reftype $data; return defined $reft && $reft eq $type || blessed $data && overload::Method($data, $meth_for{$type}); } #---------------------------------------------------------------------- # global variables #---------------------------------------------------------------------- # builtin methods for "Limit-Offset" dialects my %limit_offset_dialects = ( LimitOffset => sub {my ($self, $limit, $offset) = @_; $offset ||= 0; return "LIMIT ? OFFSET ?", $limit, $offset;}, LimitXY => sub {my ($self, $limit, $offset) = @_; $offset ||= 0; return "LIMIT ?, ?", $offset, $limit;}, LimitYX => sub {my ($self, $limit, $offset) = @_; $offset ||= 0; return "LIMIT ?, ?", $limit, $offset;}, OffsetFetchRows => sub {my ($self, $limit, $offset) = @_; $offset ||= 0; return "OFFSET ? ROWS FETCH NEXT ? ROWS ONLY", $offset, $limit;}, RowNum => sub { my ($self, $limit, $offset) = @_; # HACK below borrowed from SQL::Abstract::Limit. Not perfect, though, # because it brings back an additional column. Should borrow from # DBIx::Class::SQLMaker::LimitDialects, which does the proper job ... # but it says : "!!! THIS IS ALSO HORRIFIC !!! /me ashamed"; so # I'll only take it as last resort; still exploring other ways. # See also L : within that ORM an additional layer is # added to take advantage of Oracle scrollable cursors (for Oracle < 12c). my $sql = "SELECT * FROM (" . "SELECT subq_A.*, ROWNUM rownum__index FROM (%s) subq_A " . "WHERE ROWNUM <= ?" . ") subq_B WHERE rownum__index >= ?"; no warnings 'uninitialized'; # in case $limit or $offset is undef # row numbers start at 1 return $sql, $offset + $limit, $offset + 1; }, ); # builtin join operators with associated sprintf syntax my %common_join_syntax = ( '<=>' => '%s INNER JOIN %s ON %s', '=>' => '%s LEFT OUTER JOIN %s ON %s', '<=' => '%s RIGHT OUTER JOIN %s ON %s', '==' => '%s NATURAL JOIN %s', '>=<' => '%s FULL OUTER JOIN %s ON %s', ); my %right_assoc_join_syntax = %common_join_syntax; s/JOIN %s/JOIN (%s)/ foreach values %right_assoc_join_syntax; # specification of parameters accepted by the new() method my %params_for_new = ( table_alias => {type => SCALAR|CODEREF, default => '%s AS %s' }, column_alias => {type => SCALAR|CODEREF, default => '%s AS %s' }, limit_offset => {type => SCALAR|CODEREF, default => 'LimitOffset' }, join_syntax => {type => HASHREF, default => \%common_join_syntax}, join_assoc_right => {type => BOOLEAN, default => 0 }, max_members_IN => {type => SCALAR, optional => 1 }, multicols_sep => {type => SCALAR|SCALARREF, optional => 1 }, has_multicols_in_SQL => {type => BOOLEAN, optional => 1 }, sql_dialect => {type => SCALAR, optional => 1 }, select_implicitly_for=> {type => SCALAR|UNDEF, optional => 1 }, ); # builtin collection of parameters, for various databases my %sql_dialects = ( MsAccess => { join_assoc_right => 1, join_syntax => \%right_assoc_join_syntax}, BasisJDBC => { column_alias => "%s %s", max_members_IN => 255 }, MySQL_old => { limit_offset => "LimitXY" }, Oracle => { limit_offset => "RowNum", max_members_IN => 999, table_alias => '%s %s', column_alias => '%s %s', has_multicols_in_SQL => 1, }, ); $sql_dialects{Oracle12c} = {%{$sql_dialects{Oracle}}, limit_offset => "OffsetFetchRows"}; # operators for compound queries my @set_operators = qw/union union_all intersect minus except/; # specification of parameters accepted by select, insert, update, delete my %params_for_select = ( -columns => {type => SCALAR|ARRAYREF, default => '*'}, -from => {type => SCALAR|SCALARREF|ARRAYREF}, -where => {type => SCALAR|ARRAYREF|HASHREF, optional => 1}, (map {-$_ => {type => ARRAYREF, optional => 1}} @set_operators), -group_by => {type => SCALAR|ARRAYREF, optional => 1}, -having => {type => SCALAR|ARRAYREF|HASHREF, optional => 1}, -order_by => {type => SCALAR|ARRAYREF|HASHREF, optional => 1}, -page_size => {type => SCALAR, optional => 1}, -page_index => {type => SCALAR, optional => 1, depends => '-page_size'}, -limit => {type => SCALAR, optional => 1}, -offset => {type => SCALAR, optional => 1, depends => '-limit'}, -for => {type => SCALAR|UNDEF, optional => 1}, -want_details => {type => BOOLEAN, optional => 1}, -as => {type => SCALAR, optional => 1}, ); my %params_for_insert = ( -into => {type => SCALAR}, -values => {type => SCALAR|ARRAYREF|HASHREF, optional => 1}, -select => {type => HASHREF, optional => 1}, -columns => {type => ARRAYREF, optional => 1}, -returning => {type => SCALAR|ARRAYREF|HASHREF, optional => 1}, -add_sql => {type => SCALAR, optional => 1}, ); my %params_for_update = ( -table => {type => SCALAR|SCALARREF|ARRAYREF}, -set => {type => HASHREF}, -where => {type => SCALAR|ARRAYREF|HASHREF, optional => 1}, -order_by => {type => SCALAR|ARRAYREF|HASHREF, optional => 1}, -limit => {type => SCALAR, optional => 1}, -returning => {type => SCALAR|ARRAYREF|HASHREF, optional => 1}, -add_sql => {type => SCALAR, optional => 1}, ); my %params_for_delete = ( -from => {type => SCALAR}, -where => {type => SCALAR|ARRAYREF|HASHREF, optional => 1}, -order_by => {type => SCALAR|ARRAYREF|HASHREF, optional => 1}, -limit => {type => SCALAR, optional => 1}, -add_sql => {type => SCALAR, optional => 1}, ); my %params_for_WITH = ( -table => {type => SCALAR}, -columns => {type => SCALAR|ARRAYREF, optional => 1}, -as_select => {type => HASHREF}, -final_clause => {type => SCALAR, optional => 1}, ); #---------------------------------------------------------------------- # object creation #---------------------------------------------------------------------- sub new { my $class = shift; my %params = does($_[0], 'HASH') ? %{$_[0]} : @_; # extract params for this subclass my %more_params; foreach my $key (keys %params_for_new) { $more_params{$key} = delete $params{$key} if exists $params{$key}; } # import params from SQL dialect, if any ... but explict params above have precedence my $dialect = delete $more_params{sql_dialect}; if ($dialect) { my $dialect_params = $sql_dialects{$dialect} or puke "no such sql dialect: $dialect"; $more_params{$_} ||= $dialect_params->{$_} foreach keys %$dialect_params; } # check parameters for this class my @more_params = %more_params; my $more_self = validate(@more_params, \%params_for_new); # check some of the params for parent -- because SQLA doesn't do it :-( !$params{quote_char} || exists $params{name_sep} or belch "when 'quote_char' is present, 'name_sep' should be present too"; # call parent constructor my $self = $class->next::method(%params); # inject into $self $self->{$_} = $more_self->{$_} foreach keys %$more_self; # arguments supplied as scalars are transformed into coderefs ref $self->{column_alias} or $self->_make_sub_column_alias; ref $self->{table_alias} or $self->_make_sub_table_alias; ref $self->{limit_offset} or $self->_choose_LIMIT_OFFSET_dialect; # regex for parsing join specifications my @join_ops = sort {length($b) <=> length($a) || $a cmp $b} keys %{$self->{join_syntax}}; my $joined_ops = join '|', map quotemeta, @join_ops; $self->{join_regex} = qr[ ^ # initial anchor ($joined_ops)? # $1: join operator (i.e. '<=>', '=>', etc.)) ([[{])? # $2: opening '[' or '{' (.*?) # $3: content of brackets []}]? # closing ']' or '}' $ # final anchor ]x; return $self; } #---------------------------------------------------------------------- # support for WITH or WITH RECURSIVE #---------------------------------------------------------------------- sub with_recursive { my $self = shift; my $new_instance = $self->with(@_); $new_instance->{WITH}{sql} =~ s/^WITH\b/WITH RECURSIVE/; return $new_instance; } sub with { my $self = shift; ! $self->{WITH} or puke "calls to the with() or with_recursive() method cannot be chained"; @_ or puke "->with() : missing arguments"; # create a copy of the current object with an additional attribute WITH my $clone = shallow_clone($self, WITH => {sql => "", bind => []}); # assemble SQL and bind values for each table expression my @table_expressions = does($_[0], 'ARRAY') ? @_ : ( [ @_]); foreach my $table_expression (@table_expressions) { my %args = validate(@$table_expression, \%params_for_WITH); my ($sql, @bind) = $self->select(%{$args{-as_select}}); $clone->{WITH}{sql} .= ", " if $clone->{WITH}{sql}; $clone->{WITH}{sql} .= $args{-table}; $clone->{WITH}{sql} .= "(" . join(", ", @{$args{-columns}}) . ")" if $args{-columns}; $clone->{WITH}{sql} .= " AS ($sql) "; $clone->{WITH}{sql} .= $args{-final_clause} . " " if $args{-final_clause}; push @{$clone->{WITH}{bind}}, @bind; } # add the initial keyword WITH substr($clone->{WITH}{sql}, 0, 0, 'WITH '); return $clone; } sub _prepend_WITH_clause { my ($self, $ref_sql, $ref_bind) = @_; return if !$self->{WITH}; substr($$ref_sql, 0, 0, $self->{WITH}{sql}); unshift @$ref_bind, @{$self->{WITH}{bind}}; } #---------------------------------------------------------------------- # the select method #---------------------------------------------------------------------- sub select { my $self = shift; # if this method was called with positional args, just delegate to the parent return $self->next::method(@_) if !&_called_with_named_args; # parse arguments my %args = validate(@_, \%params_for_select); # infrastructure for collecting fragments of sql and bind args my ($sql, @bind) = (""); my $add_sql_bind = sub { $sql .= shift; push @bind, @_}; # closure to add to ($sql, @bind) # parse columns and datasource my ($cols, $post_select, $cols_bind, $aliased_columns) = $self->_parse_columns($args{-columns}); my ($from, $from_bind, $aliased_tables) = $self->_parse_from($args{-from}); $add_sql_bind->("", @$cols_bind, @$from_bind); # generate main ($sql, @bind) through the old positional API $add_sql_bind->($self->next::method($from, $cols, $args{-where})); # add @post_select clauses if needed (for ex. -distinct) my $all_post_select = join " ", @$post_select; $sql =~ s[^SELECT ][SELECT $all_post_select ]i if $all_post_select; # add set operators (UNION, INTERSECT, etc) if needed foreach my $set_op (@set_operators) { if (my $val_set_op = $args{-$set_op}) { my ($sql_set_op, @bind_set_op) = $self->_parse_set_operator($set_op => $val_set_op, $cols, $from); $add_sql_bind->($sql_set_op, @bind_set_op); } } # add GROUP BY if needed if ($args{-group_by}) { my $sql_grp = $self->where(undef, $args{-group_by}); $sql_grp =~ s/\bORDER\b/GROUP/; $add_sql_bind->($sql_grp); } # add HAVING if needed (often together with -group_by, but not always) if ($args{-having}) { my ($sql_having, @bind_having) = $self->where($args{-having}); $sql_having =~ s/\bWHERE\b/HAVING/; $add_sql_bind->(" $sql_having", @bind_having); } # add ORDER BY if needed if (my $order = $args{-order_by}) { $add_sql_bind->($self->_order_by($order)); } # add pagination if needed (either -page_* args or -limit/-offset) $self->_translate_page_into_limit_offset(\%args) if $args{-page_index} or $args{-page_size}; if (defined $args{-limit}) { my ($limit_sql, @limit_bind) = $self->limit_offset(@args{qw/-limit -offset/}); if ($limit_sql =~ /%s/) { $sql = sprintf $limit_sql, $sql; # rewrite the whole $sql push @bind, @limit_bind; } else { $add_sql_bind->(" $limit_sql", @limit_bind); } } # add FOR clause if needed my $for = exists $args{-for} ? $args{-for} : $self->{select_implicitly_for}; $add_sql_bind->(" FOR $for") if $for; # add alias if select() is used as a subquery if (my $alias = $args{-as}) { $sql = "($sql)|$alias"; } # initial WITH clause $self->_prepend_WITH_clause(\$sql, \@bind); # return results return $args{-want_details} ? {aliased_tables => $aliased_tables, aliased_columns => $aliased_columns, sql => $sql, bind => \@bind} : ($sql, @bind); } sub _parse_columns { my ($self, $columns) = @_; # the -columns arg can be an arrayref or a plain scalar => unify into an array my @cols = ref $columns ? @$columns : ($columns); # initial members of the columns list starting with "-" are extracted # into a separate list @post_select, later re-injected into the SQL (for ex. '-distinct') my @post_select; push @post_select, shift @cols while @cols && $cols[0] =~ s/^-//; # loop over columns, handling aliases and subqueries my @cols_bind; my %aliased_columns; foreach my $col (@cols) { # deal with subquery of shape \ [$sql, @bind] if (_is_subquery($col)) { my ($sql, @col_bind) = @$$col; $sql =~ s{^(select.*)}{($1)}is; # if subquery is a plain SELECT, put it in parenthesis $col = $sql; push @cols_bind, @col_bind; } # extract alias, if any if ($col =~ /^\s* # ignore insignificant leading spaces (.*[^|\s]) # any non-empty string, not ending with ' ' or '|' \| # followed by a literal '|' (\w+) # followed by a word (the alias)) \s* # ignore insignificant trailing spaces $/x) { $aliased_columns{$2} = $1; $col = $self->column_alias($1, $2); } } return (\@cols, \@post_select, \@cols_bind, \%aliased_columns); } sub _parse_from { my ($self, $from) = @_; my @from_bind; my $aliased_tables = {}; my $join_info = $self->_compute_join_info($from); if ($join_info) { $from = \($join_info->{sql}); @from_bind = @{$join_info->{bind}}; $aliased_tables = $join_info->{aliased_tables}; } else { # if -from is a subquery, separate the $sql and @bind parts if (_is_subquery($from)) { my ($sql, @bind) = @$$from; $sql =~ s{^(\s*select.*)}{($1)}is; # if subquery is a plain SELECT, put it in parenthesis $from = $sql; push @from_bind, @bind; } # conditions below : compatibility with old SQL::Abstract syntax for $source elsif (does($from, 'ARRAY')) { $from = join ", ", @$from; } elsif (does($from, 'SCALAR')) { $from = $$from; } my $table_spec = $self->_parse_table($from); $from = $table_spec->{sql}; $aliased_tables = $table_spec->{aliased_tables}; } return ($from, \@from_bind, $aliased_tables); } sub _parse_set_operator { my ($self, $set_op, $val_set_op, $cols, $from) = @_; my %sub_args = @$val_set_op; $sub_args{-columns} ||= $cols; $sub_args{-from} ||= $from; local $self->{WITH}; # temporarily disable the WITH part during the subquery my ($sql, @bind) = $self->select(%sub_args); (my $sql_op = uc($set_op)) =~ s/_/ /g; return (" $sql_op $sql", @bind); } sub _translate_page_into_limit_offset { my ($self, $args) = @_; not exists $args->{$_} or puke "-page_size conflicts with $_" for qw/-limit -offset/; $args->{-limit} = $args->{-page_size}; if ($args->{-page_index}) { $args->{-offset} = ($args->{-page_index} - 1) * $args->{-page_size}; } } #---------------------------------------------------------------------- # insert #---------------------------------------------------------------------- sub _setup_insert_inheritance { my ($parent_sqla) = @_; # if the parent has method '_expand_insert_value' (SQL::Abstract >= v2.0), # we need to override it in this subclass if ($parent_sqla->can('_expand_insert_value')) { *_expand_insert_value = sub { my ($self, $v) = @_; my $k = our $Cur_Col_Meta; if (ref($v) eq 'ARRAY') { if ($self->{array_datatypes} || $self->is_bind_value_with_type($v)) { return +{ -bind => [ $k, $v ] }; } my ($sql, @bind) = @$v; $self->_assert_bindval_matches_bindtype(@bind); return +{ -literal => $v }; } if (ref($v) eq 'HASH') { if (grep !/^-/, keys %$v) { belch "HASH ref as bind value in insert is not supported"; return +{ -bind => [ $k, $v ] }; } } if (!defined($v)) { return +{ -bind => [ $k, undef ] }; } return $self->expand_expr($v); }; } # otherwise, if the parent is an old SQL::Abstract or it is SQL::Abstract::Classic elsif ($parent_sqla->can('_insert_values')) { # if the parent has no method '_insert_value', this is the old # monolithic _insert_values() method. We must override it if (!$parent_sqla->can('_insert_value')) { *_insert_values = sub { my ($self, $data) = @_; my (@values, @all_bind); foreach my $column (sort keys %$data) { my ($values, @bind) = $self->_insert_value($column, $data->{$column}); push @values, $values; push @all_bind, @bind; } my $sql = $self->_sqlcase('values')." ( ".join(", ", @values)." )"; return ($sql, @all_bind); }; } # now override the _insert_value() method *_insert_value = sub { # unfortunately, we can't just override the ARRAYREF part, so the whole # parent method is copied here my ($self, $column, $v) = @_; my (@values, @all_bind); $self->_SWITCH_refkind($v, { ARRAYREF => sub { if ($self->{array_datatypes} # if array datatype are activated || $self->is_bind_value_with_type($v)) { # or if this is a bind val push @values, '?'; push @all_bind, $self->_bindtype($column, $v); } else { # else literal SQL with bind my ($sql, @bind) = @$v; $self->_assert_bindval_matches_bindtype(@bind); push @values, $sql; push @all_bind, @bind; } }, ARRAYREFREF => sub { # literal SQL with bind my ($sql, @bind) = @${$v}; $self->_assert_bindval_matches_bindtype(@bind); push @values, $sql; push @all_bind, @bind; }, # THINK : anything useful to do with a HASHREF ? HASHREF => sub { # (nothing, but old SQLA passed it through) #TODO in SQLA >= 2.0 it will die instead belch "HASH ref as bind value in insert is not supported"; push @values, '?'; push @all_bind, $self->_bindtype($column, $v); }, SCALARREF => sub { # literal SQL without bind push @values, $$v; }, SCALAR_or_UNDEF => sub { push @values, '?'; push @all_bind, $self->_bindtype($column, $v); }, }); my $sql = CORE::join(", ", @values); return ($sql, @all_bind); } } } sub insert { my $self = shift; my @old_API_args; my $returning_into; my $sql_to_add; my $fix_RT134127; if (&_called_with_named_args) { # extract named args and translate to old SQLA API my %args = validate(@_, \%params_for_insert); $old_API_args[0] = $args{-into} or puke "insert(..) : need -into arg"; if ($args{-values}) { # check mutually exclusive parameters !$args{$_} or puke "insert(-into => .., -values => ...) : cannot use $_ => " for qw/-select -columns/; $old_API_args[1] = $args{-values}; } elsif ($args{-select}) { local $self->{WITH}; # temporarily disable the WITH part during the subquery my ($sql, @bind) = $self->select(%{$args{-select}}); $old_API_args[1] = \ [$sql, @bind]; if (my $cols = $args{-columns}) { $old_API_args[0] .= "(" . CORE::join(", ", @$cols) . ")"; } $fix_RT134127 = 1 if ($SQL::Abstract::VERSION || 0) >= 2.0; } else { puke "insert(-into => ..) : need either -values arg or -select arg"; } # deal with -returning arg ($returning_into, my $old_API_options) = $self->_compute_returning($args{-returning}); push @old_API_args, $old_API_options if $old_API_options; # SQL to add after the INSERT keyword $sql_to_add = $args{-add_sql}; } else { @old_API_args = @_; } # get results from parent method my ($sql, @bind) = $self->next::method(@old_API_args); # temporary fix for RT#134127 due to a change of behaviour of insert() in SQLA V2.0 # .. waiting for SQLA to fix RT#134128 $sql =~ s/VALUES SELECT/SELECT/ if $fix_RT134127; # inject more stuff if using Oracle's "RETURNING ... INTO ..." if ($returning_into) { $sql .= ' INTO ' . join(", ", ("?") x @$returning_into); push @bind, @$returning_into; } # SQL to add after the INSERT keyword $sql =~ s/\b(INSERT)\b/$1 $sql_to_add/i if $sql_to_add; # initial WITH clause $self->_prepend_WITH_clause(\$sql, \@bind); return ($sql, @bind); } #---------------------------------------------------------------------- # update #---------------------------------------------------------------------- sub _setup_update_inheritance { my ($parent_sqla) = @_; # if the parent has method '_expand_update_set_value' (SQL::Abstract >= v2.0), # we need to override it in this subclass if ($parent_sqla->can('_expand_update_set_values')) { *_parent_update = $parent_sqla->can('update'); *_expand_update_set_values = sub { my ($self, undef, $data) = @_; $self->expand_expr({ -list => [ map { my ($k, $set) = @$_; $set = { -bind => $_ } unless defined $set; +{ -op => [ '=', { -ident => $k }, $set ] }; } map { my $k = $_; my $v = $data->{$k}; (ref($v) eq 'ARRAY' ? ($self->{array_datatypes} || $self->is_bind_value_with_type($v) ? [ $k, +{ -bind => [ $k, $v ] } ] : [ $k, +{ -literal => $v } ]) : do { local our $Cur_Col_Meta = $k; [ $k, $self->_expand_expr($v) ] } ); } sort keys %$data ] }); }; } # otherwise, if the parent is an old SQL::Abstract or it is SQL::Abstract::Classic else { # if the parent has method '_update_set_values()', it is a SQLA version >=1.85. # We can just use its update() method as _parent_update(). if ($parent_sqla->can('_update_set_values')) { *_parent_update = $parent_sqla->can('update'); } # otherwise, it's the old monolithic update() method. We need to supply our own # version as _parent_update(). else { *_parent_update = sub { my $self = shift; my $table = $self->_table(shift); my $data = shift || return; my $where = shift; my $options = shift; # first build the 'SET' part of the sql statement puke "Unsupported data type specified to \$sql->update" unless ref $data eq 'HASH'; my ($sql, @all_bind) = $self->_update_set_values($data); $sql = $self->_sqlcase('update ') . $table . $self->_sqlcase(' set ') . $sql; if ($where) { my($where_sql, @where_bind) = $self->where($where); $sql .= $where_sql; push @all_bind, @where_bind; } if ($options->{returning}) { my ($returning_sql, @returning_bind) = $self->_update_returning($options); $sql .= $returning_sql; push @all_bind, @returning_bind; } return wantarray ? ($sql, @all_bind) : $sql; }; *_update_returning = sub { my ($self, $options) = @_; my $f = $options->{returning}; my $fieldlist = $self->_SWITCH_refkind($f, { ARRAYREF => sub {join ', ', map { $self->_quote($_) } @$f;}, SCALAR => sub {$self->_quote($f)}, SCALARREF => sub {$$f}, }); return $self->_sqlcase(' returning ') . $fieldlist; }; } # now override or supply the _update_set_value() method *_update_set_values = sub { my ($self, $data) = @_; my (@set, @all_bind); for my $k (sort keys %$data) { my $v = $data->{$k}; my $r = ref $v; my $label = $self->_quote($k); $self->_SWITCH_refkind($v, { ARRAYREF => sub { if ($self->{array_datatypes} # array datatype || $self->is_bind_value_with_type($v)) { # or bind value with type push @set, "$label = ?"; push @all_bind, $self->_bindtype($k, $v); } else { # literal SQL with bind my ($sql, @bind) = @$v; $self->_assert_bindval_matches_bindtype(@bind); push @set, "$label = $sql"; push @all_bind, @bind; } }, ARRAYREFREF => sub { # literal SQL with bind my ($sql, @bind) = @${$v}; $self->_assert_bindval_matches_bindtype(@bind); push @set, "$label = $sql"; push @all_bind, @bind; }, SCALARREF => sub { # literal SQL without bind push @set, "$label = $$v"; }, HASHREF => sub { my ($op, $arg, @rest) = %$v; puke 'Operator calls in update must be in the form { -op => $arg }' if (@rest or not $op =~ /^\-(.+)/); local $self->{_nested_func_lhs} = $k; my ($sql, @bind) = $self->_where_unary_op($1, $arg); push @set, "$label = $sql"; push @all_bind, @bind; }, SCALAR_or_UNDEF => sub { push @set, "$label = ?"; push @all_bind, $self->_bindtype($k, $v); }, }); } # generate sql my $sql = CORE::join ', ', @set; return ($sql, @all_bind); }; } } sub update { my $self = shift; my $join_info; my @old_API_args; my $returning_into; my %args; if (&_called_with_named_args) { %args = validate(@_, \%params_for_update); # compute join info if the datasource is a join $join_info = $self->_compute_join_info($args{-table}); $args{-table} = \($join_info->{sql}) if $join_info; @old_API_args = @args{qw/-table -set -where/}; # deal with -returning arg ($returning_into, my $old_API_options) = $self->_compute_returning($args{-returning}); push @old_API_args, $old_API_options if $old_API_options; } else { @old_API_args = @_; } # call parent method and merge with bind values from $join_info my ($sql, @bind) = $self->_parent_update(@old_API_args); unshift @bind, @{$join_info->{bind}} if $join_info; # handle additional args if needed $self->_handle_additional_args_for_update_delete(\%args, \$sql, \@bind, qr/UPDATE/); # inject more stuff if using Oracle's "RETURNING ... INTO ..." if ($returning_into) { $sql .= ' INTO ' . join(", ", ("?") x @$returning_into); push @bind, @$returning_into; } # initial WITH clause $self->_prepend_WITH_clause(\$sql, \@bind); return ($sql, @bind); } #---------------------------------------------------------------------- # delete #---------------------------------------------------------------------- sub delete { my $self = shift; my @old_API_args; my %args; if (&_called_with_named_args) { %args = validate(@_, \%params_for_delete); @old_API_args = @args{qw/-from -where/}; } else { @old_API_args = @_; } # call parent method my ($sql, @bind) = $self->next::method(@old_API_args); # maybe need to handle additional args $self->_handle_additional_args_for_update_delete(\%args, \$sql, \@bind, qr/DELETE/); # initial WITH clause $self->_prepend_WITH_clause(\$sql, \@bind); return ($sql, @bind); } #---------------------------------------------------------------------- # auxiliary methods for insert(), update() and delete() #---------------------------------------------------------------------- sub _compute_returning { my ($self, $arg_returning) = @_; my ($returning_into, $old_API_options); if ($arg_returning) { # if present, "-returning" may be a scalar, arrayref or hashref; the latter # is interpreted as .. RETURNING ... INTO ... if (does $arg_returning, 'HASH') { my @keys = sort keys %$arg_returning or puke "-returning => {} : the hash is empty"; $old_API_options = {returning => \@keys}; $returning_into = [@{$arg_returning}{@keys}]; } else { $old_API_options = {returning => $arg_returning}; } } return ($returning_into, $old_API_options); } sub _handle_additional_args_for_update_delete { my ($self, $args, $sql_ref, $bind_ref, $keyword_regex) = @_; if (defined $args->{-order_by}) { my ($sql_ob, @bind_ob) = $self->_order_by($args->{-order_by}); $$sql_ref .= $sql_ob; push @$bind_ref, @bind_ob; } if (defined $args->{-limit}) { # can't call $self->limit_offset(..) because there shouldn't be any offset $$sql_ref .= $self->_sqlcase(' limit ?'); push @$bind_ref, $args->{-limit}; } if (defined $args->{-add_sql}) { $$sql_ref =~ s/\b($keyword_regex)\b/$1 $args->{-add_sql}/i; } } sub _order_by { my ($self, $order) = @_; # force scalar into an arrayref $order = [$order] if not ref $order; # restructure array data if (does $order, 'ARRAY') { my @clone = @$order; # because we will modify items # '-' and '+' prefixes are translated into {-desc/asc => } hashrefs foreach my $item (@clone) { next if !$item or ref $item; $item =~ s/^-// and $item = {-desc => $item} and next; $item =~ s/^\+// and $item = {-asc => $item}; } $order = \@clone; } return $self->next::method($order); } #---------------------------------------------------------------------- # other public methods #---------------------------------------------------------------------- # same pattern for 3 invocation methods foreach my $attr (qw/table_alias column_alias limit_offset/) { no strict 'refs'; *{$attr} = sub { my $self = shift; my $method = $self->{$attr}; # grab reference to method body $self->$method(@_); # invoke }; } # readonly accessor methods foreach my $key (qw/join_syntax join_assoc_right max_members_IN multicols_sep has_multicols_in_SQL/) { no strict 'refs'; *{$key} = sub {shift->{$key}}; } # invocation method for 'join' sub join { my $self = shift; # start from the right if right-associative @_ = reverse @_ if $self->{join_assoc_right}; # shift first single item (a table) before reducing pairs (op, table) my $combined = shift; $combined = $self->_parse_table($combined) unless ref $combined; # reduce pairs (op, table) while (@_) { # shift 2 items : next join specification and next table my $join_spec = shift; my $table_spec = shift or puke "improper number of operands"; $join_spec = $self->_parse_join_spec($join_spec) unless ref $join_spec; $table_spec = $self->_parse_table($table_spec) unless ref $table_spec; $combined = $self->_single_join($combined, $join_spec, $table_spec); } return $combined; # {sql=> .., bind => [..], aliased_tables => {..}} } # utility for merging several "where" clauses sub merge_conditions { my $self = shift; my %merged; foreach my $cond (@_) { if (does $cond, 'HASH') { foreach my $col (sort keys %$cond) { $merged{$col} = $merged{$col} ? [-and => $merged{$col}, $cond->{$col}] : $cond->{$col}; } } elsif (does $cond, 'ARRAY') { $merged{-nest} = $merged{-nest} ? {-and => [$merged{-nest}, $cond]} : $cond; } elsif ($cond) { $merged{$cond} = \""; } } return \%merged; } # utility for calling either bind_param or bind_param_inout our $INOUT_MAX_LEN = 99; # chosen arbitrarily; see L sub bind_params { my ($self, $sth, @bind) = @_; $sth->isa('DBI::st') or puke "sth argument is not a DBI statement handle"; foreach my $i (0 .. $#bind) { my $val = $bind[$i]; if (does $val, 'SCALAR') { # a scalarref is interpreted as an INOUT parameter $sth->bind_param_inout($i+1, $val, $INOUT_MAX_LEN); } elsif (does $val, 'ARRAY' and my ($bind_meth, @args) = $self->is_bind_value_with_type($val)) { # either 'bind_param' or 'bind_param_inout', with 2 or 3 args $sth->$bind_meth($i+1, @args); } else { # other cases are passed directly to DBI::bind_param $sth->bind_param($i+1, $val); } } } sub is_bind_value_with_type { my ($self, $val) = @_; # compatibility with DBIx::Class syntax of shape [\%args => $val], # see L if ( @$val == 2 && does($val->[0], 'HASH') && grep {$val->[0]{$_}} qw/dbd_attrs sqlt_size sqlt_datatype dbic_colname/) { my $args = $val->[0]; if (my $attrs = $args->{dbd_attrs}) { return (bind_param => $val->[1], $attrs); } elsif (my $size = $args->{sqlt_size}) { return (bind_param_inout => $val, $size); } # other options like 'sqlt_datatype', 'dbic_colname' are not supported else { puke "unsupported options for bind type : " . CORE::join(", ", sort keys %$args); } # NOTE : the following DBIx::Class shortcuts are not supported # [ $name => $val ] === [ { dbic_colname => $name }, $val ] # [ \$dt => $val ] === [ { sqlt_datatype => $dt }, $val ] # [ undef, $val ] === [ {}, $val ] } # in all other cases, this is not a bind value with type return (); } #---------------------------------------------------------------------- # private utility methods for 'join' #---------------------------------------------------------------------- sub _compute_join_info { my ($self, $table_arg) = @_; if (does($table_arg, 'ARRAY') && $table_arg->[0] eq '-join') { my @join_args = @$table_arg; shift @join_args; # drop initial '-join' return $self->join(@join_args); } else { return; } } sub _parse_table { my ($self, $table) = @_; # extract alias, if any (recognized as "table|alias") ($table, my $alias) = split /\|/, $table, 2; # build a table spec return { sql => $self->table_alias($table, $alias), bind => [], name => ($alias || $table), aliased_tables => {$alias ? ($alias => $table) : ()}, }; } sub _parse_join_spec { my ($self, $join_spec) = @_; # parse the join specification $join_spec or puke "empty join specification"; my ($op, $bracket, $cond_list) = ($join_spec =~ $self->{join_regex}) or puke "incorrect join specification : $join_spec\n$self->{join_regex}"; $op ||= '<=>'; $bracket ||= '{'; $cond_list ||= ''; # extract constants (strings between quotes), replaced by placeholders my $regex = qr/' # initial quote ( # begin capturing group [^']* # any non-quote chars (?: # begin non-capturing group '' # pair of quotes [^']* # any non-quote chars )* # this non-capturing group 0 or more times ) # end of capturing group ' # ending quote /x; my $placeholder = '_?_'; # unlikely to be counfounded with any value my @constants; while ($cond_list =~ s/$regex/$placeholder/) { push @constants, $1; }; s/''/'/g for @constants; # replace pairs of quotes by single quotes # accumulate conditions as pairs ($left => \"$op $right") my @conditions; my @using; foreach my $cond (split /,\s*/, $cond_list) { # parse the condition (left and right operands + comparison operator) my ($left, $cmp, $right) = split /([<>=!^]{1,2})/, $cond; if ($cmp && $right) { # if operands are not qualified by table/alias name, add sprintf hooks $left = '%1$s.' . $left unless $left =~ /\./; $right = '%2$s.' . $right unless $right =~ /\./ or $right eq $placeholder; # add this pair into the list; right operand is either a bind value # or an identifier within the right table $right = $right eq $placeholder ? shift @constants : {-ident => $right}; push @conditions, $left, {$cmp => $right}; } elsif ($cond =~ /^\w+$/) { push @using, $cond; } else {puke "can't parse join condition: $cond"} } # build join hashref my $join_hash = {operator => $op}; $join_hash->{using} = \@using if @using; $join_hash->{condition} = $bracket eq '[' ? [@conditions] : {@conditions} if @conditions; return $join_hash; } sub _single_join { my $self = shift; # if right-associative, restore proper left-right order in pair @_ = reverse @_ if $self->{join_assoc_right}; my ($left, $join_spec, $right) = @_; # syntax for assembling all elements my $syntax = $self->{join_syntax}{$join_spec->{operator}}; my ($sql, @bind); { no if $] ge '5.022000', warnings => 'redundant'; # because sprintf instructions may _intentionally_ omit %.. parameters if ($join_spec->{using}) { not $join_spec->{condition} or puke "join specification has both {condition} and {using} fields"; $syntax =~ s/\bON\s+%s/USING (%s)/; $sql = CORE::join ",", @{$join_spec->{using}}; } elsif ($join_spec->{condition}) { not $join_spec->{using} or puke "join specification has both {condition} and {using} fields"; # compute the "ON" clause ($sql, @bind) = $self->where($join_spec->{condition}); $sql =~ s/^\s*WHERE\s+//; # substitute left/right tables names for '%1$s', '%2$s' $sql = sprintf $sql, $left->{name}, $right->{name}; } # build the final sql $sql = sprintf $syntax, $left->{sql}, $right->{sql}, $sql; } # add left/right bind parameters (if any) into the list unshift @bind, @{$left->{bind}}, @{$right->{bind}}; # build result and return my %result = (sql => $sql, bind => \@bind); $result{name} = ($self->{join_assoc_right} ? $left : $right)->{name}; $result{aliased_tables} = $left->{aliased_tables}; foreach my $alias (keys %{$right->{aliased_tables}}) { $result{aliased_tables}{$alias} = $right->{aliased_tables}{$alias}; } return \%result; } #---------------------------------------------------------------------- # override of parent's "_where_field_IN" #---------------------------------------------------------------------- sub _where_field_IN { my ($self, $k, $op, $vals) = @_; # special algorithm if the key is multi-columns (contains a multicols_sep) if ($self->{multicols_sep}) { my @cols = split m[$self->{multicols_sep}], $k; if (@cols > 1) { if ($self->{has_multicols_in_SQL}) { # DBMS accepts special SQL syntax for multicolumns return $self->_multicols_IN_through_SQL(\@cols, $op, $vals); } else { # DBMS doesn't accept special syntax, so we must use boolean logic return $self->_multicols_IN_through_boolean(\@cols, $op, $vals); } } } # special algorithm if the number of values exceeds the allowed maximum my $max_members_IN = $self->{max_members_IN}; if ($max_members_IN && does($vals, 'ARRAY') && @$vals > $max_members_IN) { my @vals = @$vals; my @slices; while (my @slice = splice(@vals, 0, $max_members_IN)) { push @slices, \@slice; } my @clauses = map {{-$op, $_}} @slices; my $connector = $op =~ /^not/i ? '-and' : '-or'; unshift @clauses, $connector; my ($sql, @bind) = $self->where({$k => \@clauses}); $sql =~ s/\s*where\s*\((.*)\)/$1/i; return ($sql, @bind); } # otherwise, call parent method $vals = [@$vals] if blessed $vals; # because SQLA dies on blessed arrayrefs return $self->next::method($k, $op, $vals); } sub _multicols_IN_through_SQL { my ($self, $cols, $op, $vals) = @_; # build initial sql my $n_cols = @$cols; my $sql_cols = CORE::join(',', map {$self->_quote($_)} @$cols); my $sql = "($sql_cols) " . $self->_sqlcase($op); # dispatch according to structure of $vals return $self->_SWITCH_refkind($vals, { ARRAYREF => sub { # list of tuples # deal with special case of empty list (like the parent class) my $n_tuples = @$vals; if (!$n_tuples) { my $sql = ($op =~ /\bnot\b/i) ? $self->{sqltrue} : $self->{sqlfalse}; return ($sql); } # otherwise, build SQL and bind values for the list of tuples my @bind; foreach my $val (@$vals) { does($val, 'ARRAY') or $val = [split m[$self->{multicols_sep}], $val]; @$val == $n_cols or puke "op '$op' with multicols: tuple with improper number of cols"; push @bind, @$val; } my $single_tuple = "(" . CORE::join(',', (('?') x $n_cols)) . ")"; my $all_tuples = CORE::join(', ', (($single_tuple) x $n_tuples)); $sql .= " ($all_tuples)"; return ($sql, @bind); }, SCALARREF => sub { # literal SQL $sql .= " ($$vals)"; return ($sql); }, ARRAYREFREF => sub { # literal SQL with bind my ($inner_sql, @bind) = @$$vals; $sql .= " ($inner_sql)"; return ($sql, @bind); }, FALLBACK => sub { puke "op '$op' with multicols requires a list of tuples or literal SQL"; }, }); } sub _multicols_IN_through_boolean { my ($self, $cols, $op, $vals) = @_; # can't handle anything else than a list of tuples does($vals, 'ARRAY') && @$vals or puke "op '$op' with multicols requires a non-empty list of tuples"; # assemble SQL my $n_cols = @$cols; my $sql_cols = CORE::join(' AND ', map {$self->_quote($_) . " = ?"} @$cols); my $sql = "(" . CORE::join(' OR ', (("($sql_cols)") x @$vals)) . ")"; $sql = "NOT $sql" if $op =~ /\bnot\b/i; # assemble bind values my @bind; foreach my $val (@$vals) { does($val, 'ARRAY') or $val = [split m[$self->{multicols_sep}], $val]; @$val == $n_cols or puke "op '$op' with multicols: tuple with improper number of cols"; push @bind, @$val; } # return the whole thing return ($sql, @bind); } #---------------------------------------------------------------------- # override parent's methods for decoding arrayrefs #---------------------------------------------------------------------- sub _where_hashpair_ARRAYREF { my ($self, $k, $v) = @_; if ($self->is_bind_value_with_type($v)) { $self->_assert_no_bindtype_columns; my $sql = CORE::join ' ', $self->_convert($self->_quote($k)), $self->_sqlcase($self->{cmp}), $self->_convert('?'); my @bind = ($v); return ($sql, @bind); } else { return $self->next::method($k, $v); } } sub _where_field_op_ARRAYREF { my ($self, $k, $op, $vals) = @_; if ($self->is_bind_value_with_type($vals)) { $self->_assert_no_bindtype_columns; my $sql = CORE::join ' ', $self->_convert($self->_quote($k)), $self->_sqlcase($op), $self->_convert('?'); my @bind = ($vals); return ($sql, @bind); } else { return $self->next::method($k, $op, $vals); } } sub _assert_no_bindtype_columns { my ($self) = @_; $self->{bindtype} ne 'columns' or puke 'values of shape [$val, \%type] are not compatible' . 'with ...->new(bindtype => "columns")'; } #---------------------------------------------------------------------- # method creations through closures #---------------------------------------------------------------------- sub _make_sub_column_alias { my ($self) = @_; my $syntax = $self->{column_alias}; $self->{column_alias} = sub { my ($self, $name, $alias) = @_; return $name if !$alias; # quote $name unless it is an SQL expression (then the user should quote it) $name = $self->_quote($name) unless $name =~ /[()]/; # assemble syntax my $sql = sprintf $syntax, $name, $self->_quote($alias); # return a string ref to avoid quoting by SQLA return \$sql; }; } sub _make_sub_table_alias { my ($self) = @_; my $syntax = $self->{table_alias}; $self->{table_alias} = sub { my ($self, $name, $alias) = @_; return $name if !$alias; # assemble syntax my $sql = sprintf $syntax, $self->_quote($name), $self->_quote($alias); return $sql; }; } sub _choose_LIMIT_OFFSET_dialect { my $self = shift; my $dialect = $self->{limit_offset}; my $method = $limit_offset_dialects{$dialect} or puke "no such limit_offset dialect: $dialect"; $self->{limit_offset} = $method; } #---------------------------------------------------------------------- # utility functions (not methods) #---------------------------------------------------------------------- sub _called_with_named_args { return $_[0] && !ref $_[0] && substr($_[0], 0, 1) eq '-'; } sub _is_subquery { my $arg = shift; return does($arg, 'REF') && does($$arg, 'ARRAY'); } 1; # End of SQL::Abstract::More __END__ =head1 NAME SQL::Abstract::More - extension of SQL::Abstract with more constructs and more flexible API =head1 SYNOPSIS use SQL::Abstract::More; # will inherit from SQL::Abstract::Classic; #or use SQL::Abstract::More -extends => 'SQL::Abstract'; # will inherit from SQL::Abstract; my $sqla = SQL::Abstract::More->new(); my ($sql, @bind); # ex1: named parameters, select DISTINCT, ORDER BY, LIMIT/OFFSET ($sql, @bind) = $sqla->select( -columns => [-distinct => qw/col1 col2/], -from => 'Foo', -where => {bar => {">" => 123}}, -order_by => [qw/col1 -col2 +col3/], # BY col1, col2 DESC, col3 ASC -limit => 100, -offset => 300, ); # ex2: column aliasing, join ($sql, @bind) = $sqla->select( -columns => [ qw/Foo.col_A|a Bar.col_B|b /], -from => [-join => qw/Foo fk=pk Bar /], ); # ex3: INTERSECT (or similar syntax for UNION) ($sql, @bind) = $sqla->select( -columns => [qw/col1 col2/], -from => 'Foo', -where => {col1 => 123}, -intersect => [ -columns => [qw/col3 col4/], -from => 'Bar', -where => {col3 => 456}, ], ); # ex4 : subqueries my $subq1 = [ $sqla->select(-columns => 'f|x', -from => 'Foo', -union => [-columns => 'b|x', -from => 'Bar', -where => {barbar => 123}], -as => 'Foo_union_Bar', ) ]; my $subq2 = [ $sqla->select(-columns => 'MAX(amount)', -from => 'Expenses', -where => {exp_id => {-ident => 'x'}, date => {">" => '01.01.2024'}}, -as => 'max_amount', ) ]; ($sql, @bind) = $sqla->select( -columns => ['x', \$subq2], -from => \$subq1, -order_by => 'x', ); # ex5: passing datatype specifications ($sql, @bind) = $sqla->select( -from => 'Foo', -where => {bar => [{dbd_attrs => {ora_type => ORA_XMLTYPE}}, $xml]}, ); my $sth = $dbh->prepare($sql); $sqla->bind_params($sth, @bind); $sth->execute; # ex6: multicolumns-in $sqla = SQL::Abstract::More->new( multicols_sep => '/', has_multicols_in_SQL => 1, ); ($sql, @bind) = $sqla->select( -from => 'Foo', -where => {"foo/bar/buz" => {-in => ['1/a/X', '2/b/Y', '3/c/Z']}}, ); # ex7: merging several criteria my $merged = $sqla->merge_conditions($cond_A, $cond_B, ...); ($sql, @bind) = $sqla->select(..., -where => $merged, ..); # ex8: insert / update / delete ($sql, @bind) = $sqla->insert( -add_sql => 'OR IGNORE', # SQLite syntax -into => $table, -values => {col => $val, ...}, ); ($sql, @bind) = $sqla->insert( -into => $table, -columns => [qw/a b/], -select => {-from => 'Bar', -columns => [qw/x y/], -where => ...}, ); ($sql, @bind) = $sqla->update( -table => $table, -set => {col => $val, ...}, -where => \%conditions, ); ($sql, @bind) = $sqla->delete ( -from => $table -where => \%conditions, ); # ex9 : initial WITH clause -- example borrowed from https://sqlite.org/lang_with.html ($sql, @bind) = $sqla->with_recursive( [ -table => 'parent_of', -columns => [qw/name parent/], -as_select => {-columns => [qw/name mom/], -from => 'family', -union => [-columns => [qw/name dad/], -from => 'family']}, ], [ -table => 'ancestor_of_alice', -columns => [qw/name/], -as_select => {-columns => [qw/parent/], -from => 'parent_of', -where => {name => 'Alice'}, -union_all => [-columns => [qw/parent/], -from => [qw/-join parent_of {name} ancestor_of_alice/]], }, ], )->select( -columns => 'family.name', -from => [qw/-join ancestor_of_alice {name} family/], -where => {died => undef}, -order_by => 'born', ); =head1 DESCRIPTION This module generates SQL from Perl data structures. It is a subclass of L or L, fully compatible with the parent class, but with many improvements : =over =item * methods take arguments as I instead of positional parameters. This is more flexible for identifying and assembling various SQL clauses, like C<-where>, C<-order_by>, C<-group_by>, etc. =item * additional SQL constructs like C<-union>, C<-group_by>, C, C<-with_recursive>, etc. are supported =item * subqueries can be used in a column list or as a datasource (i.e C<< SELECT ... FROM (SELECT ..) >>) =item * C clauses can range over multiple columns (tuples) =item * values passed to C. This default clause can always be overridden by an explicit C<-for> in a given select : my $sqla = SQL::Abstract->new(-select_implicitly_for => 'READ ONLY'); ($sql, @bind) = $sqla->select(-from => 'Foo'); # SELECT * FROM FOO FOR READ ONLY ($sql, @bind) = $sqla->select(-from => 'Foo', -for => 'UPDATE'); # SELECT * FROM FOO FOR UPDATE ($sql, @bind) = $sqla->select(-from => 'Foo', -for => undef); # SELECT * FROM FOO =item sql_dialect This is actually a "meta-argument" : it injects a collection of regular arguments, tuned for a specific SQL dialect. Dialects implemented so far are : =over =item MsAccess For Microsoft Access. Overrides the C syntax to be right-associative. =item BasisJDBC For Livelink Collection Server (formerly "Basis"), accessed through a JDBC driver. Overrides the C syntax. Sets C to 255. =item MySQL_old For old versions of MySQL. Overrides the C syntax. Recent versions of MySQL do not need that because they now implement the regular "LIMIT ? OFFSET ?" ANSI syntax. =item Oracle For old versions of Oracle. Overrides the C to use the "RowNum" dialect (beware, this injects an additional column C into your resultset). Also sets C to 999 and C to true. =item Oracle12c For Oracle starting from version 12c. Like the "Oracle" dialect, except for C which uses C. =back =back =head1 INSTANCE METHODS =head2 select # positional parameters, directly passed to the parent class ($sql, @bind) = $sqla->select($table, $columns, $where, $order); # named parameters, handled in this class ($sql, @bind) = $sqla->select( -columns => \@columns, # OR: -columns => [-distinct => @columns], -from => $table || \@joined_tables, -where => \%where, -union => [ %select_subargs ], # OR -intersect, -minus, etc -order_by => \@order, -group_by => \@group_by, -having => \%having_criteria, -limit => $limit, -offset => $offset, # OR: -page_size => $size, -page_index => $index, -for => $purpose, ); my $details = $sqla->select(..., want_details => 1); # keys in %$details: sql, bind, aliased_tables, aliased_columns If called with positional parameters, as in L, C<< select() >> just forwards the call to the parent class. Otherwise, if called with named parameters, as in the example above, some additional SQL processing is performed. The following named arguments can be specified : =over =item C<< -columns => \@columns >> C<< \@columns >> is a reference to an array of SQL column specifications (i.e. column names, C<*> or C, functions, etc.). A '|' in a column is translated into a column aliasing clause: this is convenient when using perl C<< qw/.../ >> operator for columns, as in -columns => [ qw/table1.longColumn|t1lc table2.longColumn|t2lc/ ] SQL column aliasing is then generated through the L method. If L is defined, aliased columns will be quoted, unless they contain parentheses, in which case they are considered as SQL expressions for which the user should handle the quoting himself. For example if C is "`", -columns => [ qw/foo.bar|fb length(buz)|lbuz/ ] will produce SELECT `foo`.`bar` AS fb, length(buz) AS lbuz and not SELECT `foo`.`bar` AS fb, length(`buz`) AS lbuz Initial items in C<< @columns >> that start with a minus sign are shifted from the array, i.e. they are not considered as column names, but are re-injected later into the SQL (without the minus sign), just after the C, values assigned to columns can have associated SQL types; see L. Parameters C<-into> and C<-values> are passed verbatim to the parent method. Parameters C<-select> and C<-columns> are used for selecting from subqueries -- this is incompatible with the C<-values> parameter. Parameter C<-returning> is optional and only supported by some database vendors (see L); if the C<$return_structure> is =over =item * a scalar or an arrayref, it is passed directly to the parent method =item * a hashref, it is interpreted as a SQL clause "RETURNING .. INTO ..", as required in particular by Oracle. Hash keys are field names, and hash values are references to variables that will receive the results. Then it is the client code's responsibility to use L for binding the variables and retrieving the results, but the L method in the present module is there for help. Example: ($sql, @bind) = $sqla->insert( -into => $table, -values => {col => $val, ...}, -returning => {key_col => \my $generated_key}, ); my $sth = $dbh->prepare($sql); $sqla->bind_params($sth, @bind); $sth->execute; print "The new key is $generated_key"; =back Optional parameter C<-add_sql> is used with some specific SQL dialects, for injecting additional SQL keywords after the C keyword. Examples : $sqla->insert(..., -add_sql => 'IGNORE') # produces "INSERT IGNORE ..." -- MySQL $sqla->insert(..., -add_sql => 'OR IGNORE') # produces "INSERT OR IGNORE ..." -- SQLite =head2 update # positional parameters, directly passed to the parent class ($sql, @bind) = $sqla->update($table, \%fieldvals, \%where); # named parameters, handled in this class ($sql, @bind) = $sqla->update( -table => $table, -set => {col => $val, ...}, -where => \%conditions, -order_by => \@order, -limit => $limit, -returning => $return_structure, -add_sql => $keyword, ); This works in the same spirit as the L method above. Positional parameters are supported for backwards compatibility with the old API; but named parameters should be preferred because they improve the readability of the client's code. Few DBMS would support parameters C<-order_by> and C<-limit>, but MySQL does -- see L. Optional parameter C<-returning> works like for the L method. Optional parameter C<-add_sql> is used with some specific SQL dialects, for injecting additional SQL keywords after the C keyword. Examples : $sqla->update(..., -add_sql => 'IGNORE') # produces "UPDATE IGNORE ..." -- MySQL $sqla->update(..., -add_sql => 'OR IGNORE') # produces "UPDATE OR IGNORE ..." -- SQLite =head2 delete # positional parameters, directly passed to the parent class ($sql, @bind) = $sqla->delete($table, \%where); # named parameters, handled in this class ($sql, @bind) = $sqla->delete ( -from => $table -where => \%conditions, -order_by => \@order, -limit => $limit, -add_sql => $keyword, ); Positional parameters are supported for backwards compatibility with the old API; but named parameters should be preferred because they improve the readability of the client's code. Few DBMS would support parameters C<-order_by> and C<-limit>, but MySQL does -- see L. Optional parameter C<-add_sql> is used with some specific SQL dialects, for injecting additional SQL keywords after the C keyword. Examples : $sqla->delete(..., -add_sql => 'IGNORE') # produces "DELETE IGNORE ..." -- MySQL $sqla->delete(..., -add_sql => 'OR IGNORE') # produces "DELETE OR IGNORE ..." -- SQLite =head2 with_recursive, with my $new_sqla = $sqla->with_recursive( # or: $sqla->with( [ -table => $CTE_table_name, -columns => \@CTE_columns, -as_select => \%select_args ], [ -table => $CTE_table_name2, -columns => \@CTE_columns2, -as_select => \%select_args2 ], ... ); ($sql, @bind) = $new_sqla->insert(...); # or, if there is only one table expression my $new_sqla = $sqla->with_recursive( -table => $CTE_table_name, -columns => \@CTE_columns, -as_select => \%select_args, ); Returns a new instance with an encapsulated I, i.e. a kind of local view that can be used as a table name for the rest of the SQL statement -- see L for an explanation of such expressions, or, if you are using Oracle, see the documentation for so-called I in SELECT statements. Further calls to C method. =item C<-final_clause> An optional SQL clause that will be added after the table expression. This may be needed for example for an Oracle I, like ($sql, @bind) = $sqla->with_recursive( -table => ..., -as_select => ..., -final_clause => "CYCLE x SET is_cycle TO '1' DEFAULT '0'", )->select(...); =back If there is only one table expression, its arguments can be passed directly as an array instead of a single arrayref. =head2 table_alias my $sql = $sqla->table_alias($table_name, $alias); Returns the SQL fragment for aliasing a table. If C<$alias> is empty, just returns C<$table_name>. =head2 column_alias Like C, but for column aliasing. =head2 limit_offset ($sql, @bind) = $sqla->limit_offset($limit, $offset); Generates C<($sql, @bind)> for a LIMIT-OFFSET clause. =head2 join my $join_info = $sqla->join( ... ); my $sth = $dbh->prepare($join_info->{sql}); $sth->execute(@{$join_info->{bind}}) while (my ($alias, $aliased) = each %{$join_info->{aliased_tables}}) { say "$alias is an alias for table $aliased"; } Generates join information for a JOIN clause, taking as input a collection of joined tables with their join conditions. The following example gives an idea of the available syntax : ($sql, @bind) = $sqla->join(qw[ Table1|t1 ab=cd Table2|t2 <=>{ef>gh,ij{t1.op=qr} Table4 ]); This will generate Table1 AS t1 INNER JOIN Table2 AS t2 ON t1.ab=t2.cd INNER JOIN Table3 ON t2.ef>Table3.gh AND t2.ij. More precisely, the arguments to C should be a list containing an odd number of elements, where the odd positions are I and the even positions are I. =head3 Table specifications A table specification for join is a string containing the table name, possibly followed by a vertical bar and an alias name. For example C or C are valid table specifications. These are converted into internal hashrefs with keys C, C, C, C, like this : { sql => "Table1 AS t1" bind => [], name => "t1" aliased_tables => {"t1" => "Table1"} } Such hashrefs can be passed directly as arguments, instead of the simple string representation. =head3 Join specifications A join specification is a string containing an optional I, possibly followed by a pair of curly braces or square brackets containing the I. Default builtin join operators are C<< <=> >>, C<< => >>, C<< <= >>, C<< == >>, corresponding to the following SQL JOIN clauses : '<=>' => '%s INNER JOIN %s ON %s', '=>' => '%s LEFT OUTER JOIN %s ON %s', '<=' => '%s RIGHT JOIN %s ON %s', '==' => '%s NATURAL JOIN %s', '>=<' => '%s FULL OUTER JOIN %s ON %s', This operator table can be overridden through the C parameter of the L method. The join conditions are a comma-separated list of binary column comparisons, like for example {ab=cd,Table1.ef common conventions, if the list of comparisons is within curly braces, it will become an C; if it is within square brackets, it will become an C. Join specifications expressed as strings are converted into internal hashrefs with keys C and C, like this : { operator => '<=>', condition => { '%1$s.ab' => {'=' => {-ident => '%2$s.cd'}}, '%1$s.ef' => {'=' => {-ident => 'Table2.gh'}}}, } The C is a key into the C table; the associated value is a C format string, with placeholders for the left and right operands, and the join condition. The C is a structure suitable for being passed as argument to L. Places where the names of left/right tables (or their aliases) are expected should be expressed as C placeholders, i.e. respectively C<%1$s> and C<%2$s>. Usually the right-hand side of the condition refers to a column of the right table; in such case it should B belong to the C<@bind> list, so this is why we need to use the C<-ident> operator from L. Only when the right-hand side is a string constant (string within quotes) does it become a bind value : for example ->join(qw/Table1 {ab=cd,ef='foobar'}) Table2/) is parsed into [ 'Table1', { operator => '<=>', condition => { '%1$s.ab' => {'=' => {-ident => '%2$s.cd'}}, '%1$s.ef' => {'=' => 'foobar'} }, }, 'Table2', ] Hashrefs for join specifications as shown above can be passed directly as arguments, instead of the simple string representation. For example the L ORM uses hashrefs for communicating with C. =head3 joins with USING clause instead of ON In most DBMS, when column names on both sides of a join are identical, the join can be expressed as SELECT * FROM T1 INNER JOIN T2 USING (A, B) instead of SELECT * FROM T1 INNER JOIN T2 ON T1.A=T2.A AND T1.B=T2.B The advantage of this syntax with a USING clause is that the joined columns will appear only once in the results, and they do not need to be prefixed by a table name if they are needed in the select list or in the WHERE part of the SQL. To express joins with the USING syntax in C, just mention the column names within curly braces, without any equality operator. For example ->join(qw/Table1 {a,b} Table2 {c} Table3/) will generate SELECT * FROM Table1 INNER JOIN Table2 USING (a,b) INNER JOIN Table3 USING (c) In this case the internal hashref representation has the following shape : { operator => '<=>', using => [ 'a', 'b'], } When they are generated directy by the client code, internal hashrefs must have I a C field I a C field; it is an error to have both. =head3 Return value The structure returned by C is a hashref with the following keys : =over =item sql a string containing the generated SQL =item bind an arrayref of bind values =item aliased_tables a hashref where keys are alias names and values are names of aliased tables. =back =head2 merge_conditions my $conditions = $sqla->merge_conditions($cond_A, $cond_B, ...); This utility method takes a list of "C" conditions and merges all of them in a single hashref. For example merging ( {a => 12, b => {">" => 34}}, {b => {"<" => 56}, c => 78} ) produces {a => 12, b => [-and => {">" => 34}, {"<" => 56}], c => 78}); =head2 bind_params $sqla->bind_params($sth, @bind); For each C<$value> in C<@bind>: =over =item * if the value is a scalarref, call $sth->bind_param_inout($index, $value, $INOUT_MAX_LEN) (see L). C<$INOUT_MAX_LEN> defaults to 99, which should be good enough for most uses; should you need another value, you can change it by setting local $SQL::Abstract::More::INOUT_MAX_LEN = $other_value; =item * if the value is an arrayref that matches L, then call the method and arguments returned by L. =item * for all other cases, call $sth->bind_param($index, $value); =back This method is useful either as a convenience for Oracle statements of shape C<"INSERT ... RETURNING ... INTO ..."> (see L method above), or as a way to indicate specific datatypes to the database driver. =head2 is_bind_value_with_type my ($method, @args) = $sqla->is_bind_value_with_type($value); If C<$value> is a ref to a pair C<< [\%args, $orig_value] >> : =over =item * if C<%args> is of shape C<< {dbd_attrs => \%sql_type} >>, then return C<< ('bind_param', $orig_value, \%sql_type) >>. =item * if C<%args> is of shape C<< {sqlt_size => $num} >>, then return C<< ('bind_param_inout', $orig_value, $num) >>. =back Otherwise, return C<()>. =head1 BIND VALUES WITH TYPES At places where L would expect a plain value, C also accepts a pair, i.e. an arrayref of 2 elements, where the first element is a type specification, and the second element is the value. This is convenient when the DBD driver needs additional information about the values used in the statement. The usual type specification is a hashref C<< {dbd_attrs => \%type} >>, where C<\%type> is passed directly as third argument to L, and therefore is specific to the DBD driver. Another form of type specification is C<< {sqlt_size => $num} >>, where C<$num> will be passed as buffer size to L. Here are some examples ($sql, @bind) = $sqla->insert( -into => 'Foo', -values => {bar => [{dbd_attrs => {ora_type => ORA_XMLTYPE}}]}, ); ($sql, @bind) = $sqla->select( -from => 'Foo', -where => {d_begin => {">" => [{dbd_attrs => {ora_type => ORA_DATE}}, $some_date]}}, ); When using this feature, the C<@bind> array will contain references that cannot be passed directly to L methods; so you should use L from the present module to perform the appropriate bindings before executing the statement. =head1 UTILITY FUNCTIONS =head2 shallow_clone my $clone = SQL::Abstract::More::shallow_clone($some_object, %override); Returns a shallow copy of the object passed as argument. A new hash is created with copies of the top-level keys and values, and it is blessed into the same class as the original object. Not to be confused with the full recursive copy performed by L. The optional C<%override> hash is also copied into C<$clone>; it can be used to add other attributes or to override existing attributes in C<$some_object>. =head2 does() if (SQL::Abstract::More::does $ref, 'ARRAY') {...} Very cheap version of a C method, that checks whether a given reference can act as an ARRAY, HASH, SCALAR or CODE. This was designed for the limited internal needs of this module and of L; for more complete implementations of a C method, see L, L or L. =head1 AUTHOR Laurent Dami, C<< >> =head1 ACKNOWLEDGEMENTS =over =item * L : support for C<-having> without C<-order_by> =item * L : pull request for fixing C<< -from => ['table'] >> =item * L : signaling a regression for C<< -from => \ 'table' >> =back =head1 SUPPORT You can find documentation for this module with the perldoc command. perldoc SQL::Abstract::More The same documentation is also available at L =head1 LICENSE AND COPYRIGHT Copyright 2011-2024 Laurent Dami. This program is free software; you can redistribute it and/or modify it under the terms of either: the GNU General Public License as published by the Free Software Foundation; or the Artistic License. See https://dev.perl.org/licenses/ for more information. =cut SQL-Abstract-More-1.42/t000755000000000000 014553555043 15343 5ustar00unknownunknown000000000000SQL-Abstract-More-1.42/t/01-sql_abstract_more.t000444000000000000 6776414553551640 21652 0ustar00unknownunknown000000000000 use strict; use warnings; no warnings 'qw'; use SQL::Abstract::More; use Test::More; use SQL::Abstract::Test import => [qw/is_same_sql_bind/]; diag( "Testing SQL::Abstract::More $SQL::Abstract::More::VERSION, " ."extends @SQL::Abstract::More::ISA, Perl $], $^X" ); use constant N_DBI_MOCK_TESTS => 2; my $sqla = SQL::Abstract::More->new; my ($sql, @bind, $join); #---------------------------------------------------------------------- # various forms of select() #---------------------------------------------------------------------- # old API transmitted to parent ($sql, @bind) = $sqla->select('Foo', 'bar', {bar => {">" => 123}}, ['bar']); is_same_sql_bind( $sql, \@bind, "SELECT bar FROM Foo WHERE bar > ? ORDER BY bar", [123], "old API (positional parameters)", ); # idem, new API ($sql, @bind) = $sqla->select( -columns => [qw/bar/], -from => 'Foo', -where => {bar => {">" => 123}}, -order_by => ['bar'] ); is_same_sql_bind( $sql, \@bind, "SELECT bar FROM Foo WHERE bar > ? ORDER BY bar", [123], "new API : named parameters", ); # pass one table as array ($sql, @bind) = $sqla->select( -columns => [qw/bar/], -from => ['Foo'], -where => {bar => {">" => 123}}, -order_by => ['bar'] ); is_same_sql_bind( $sql, \@bind, "SELECT bar FROM Foo WHERE bar > ? ORDER BY bar", [123], "-from => arrayref (1 table)", ); # pass several tables as array ($sql, @bind) = $sqla->select( -columns => [qw/bar/], -from => [qw/Foo Bar Buz/], -where => {bar => {">" => 123}}, ); is_same_sql_bind( $sql, \@bind, "SELECT bar FROM Foo, Bar, Buz WHERE bar > ?", [123], "-from => arrayref (several tables)", ); ($sql, @bind) = $sqla->select( -columns => [qw/bar/], -from => \ 'Foo', -where => {bar => {">" => 123}}, ); is_same_sql_bind( $sql, \@bind, "SELECT bar FROM Foo WHERE bar > ?", [123], "-from => scalarref", ); # -from with alias ($sql, @bind) = $sqla->select( -columns => [qw/bar/], -from => 'Foo|f', -where => {"f.bar" => 123}, ); is_same_sql_bind( $sql, \@bind, "SELECT bar FROM Foo AS f WHERE f.bar = ?", [123], "-from with alias" ); # -distinct ($sql, @bind) = $sqla->select( -columns => [-DISTINCT => qw/foo bar/], -from => 'Foo', ); is_same_sql_bind( $sql, \@bind, "SELECT DISTINCT foo, bar FROM Foo", [], ); # other minus signs ($sql, @bind) = $sqla->select( -columns => [-DISTINCT => -STRAIGHT_JOIN => qw/foo bar/], -from => 'Foo', ); is_same_sql_bind( $sql, \@bind, "SELECT DISTINCT STRAIGHT_JOIN foo, bar FROM Foo", [], ); ($sql, @bind) = $sqla->select( -columns => [-SQL_SMALL_RESULT => qw/foo bar/], -from => 'Foo', ); is_same_sql_bind( $sql, \@bind, "SELECT SQL_SMALL_RESULT foo, bar FROM Foo", [], ); ($sql, @bind) = $sqla->select( -columns => ["-/*+ FIRST_ROWS (100) */" => qw/foo bar/], -from => 'Foo', ); is_same_sql_bind( $sql, \@bind, "SELECT /*+ FIRST_ROWS (100) */ foo, bar FROM Foo", [], ); # subquery as column, simple example ($sql, @bind) = $sqla->select( -columns => ["col1", \ [ "(SELECT max(bar) FROM Bar WHERE bar < ?)|col2", 123], "col3"], -from => 'Foo', -where => {foo => 456}, ); is_same_sql_bind( $sql, \@bind, "SELECT col1, (SELECT max(bar) FROM Bar WHERE bar < ?) AS col2, col3 FROM Foo WHERE foo = ?", [123, 456], "subquery in select list", ); # subquery as column, example from the doc my ($subq_sql, @subq_bind) = $sqla->select( -columns => 'COUNT(*)', -from => 'Foo', -where => {bar_id => {-ident => 'Bar.bar_id'}, height => {-between => [100, 200]}}, ); my $subquery = ["($subq_sql)|col3", @subq_bind]; ($sql, @bind) = $sqla->select( -from => 'Bar', -columns => ['col1', 'col2', \$subquery, , 'col4'], # reference to an arrayref ! -where => {color => 'green'}, ); is_same_sql_bind( $sql, \@bind, "SELECT col1, col2, (SELECT COUNT(*) FROM Foo WHERE bar_id=Bar.bar_id and height BETWEEN ? AND ?) AS col3, col4 FROM Bar WHERE color = ?", [100, 200, 'green'], "subquery, example from the doc"); # subquery in the -from arg ($subq_sql, @subq_bind) = $sqla->select( -columns => [qw/a b c/], -from => 'Foo', -where => {foo => 123}, ); $subquery = ["($subq_sql)|subq", @subq_bind]; ($sql, @bind) = $sqla->select( -from => \$subquery, -columns => ['subq.*', 'count(*)|nb_a'], -where => {b => 456}, -group_by => 'a', ); is_same_sql_bind( $sql, \@bind, "SELECT subq.*, count(*) AS nb_a FROM (SELECT a, b, c FROM Foo WHERE foo = ?) AS subq WHERE b = ? GROUP BY a", [123, 456], "subquery in -from"); # subq example from the synopsis my $subq1 = [ $sqla->select(-columns => 'f|x', -from => 'Foo', -union => [-columns => 'b|x', -from => 'Bar', -where => {barbar => 123}], -as => 'Foo_union_Bar', ) ]; my $subq2 = [ $sqla->select(-columns => 'MAX(amount)', -from => 'Expenses', -where => {exp_id => {-ident => 'x'}, date => {">" => '01.01.2024'}}, -as => 'max_amount', ) ]; ($sql, @bind) = $sqla->select( -columns => ['x', \$subq2], -from => \$subq1, -order_by => 'x', ); is_same_sql_bind( $sql, \@bind, " SELECT x, (SELECT MAX(amount) FROM Expenses WHERE ( date > ? AND exp_id = x)) AS max_amount FROM (SELECT f AS x FROM Foo UNION SELECT b AS x FROM Bar WHERE barbar = ?) AS Foo_union_Bar ORDER BY x", ['01.01.2024', 123], "subqueries in column list and in source"); # subquery with -in my $subq = [ $sqla->select(-columns => 'x', -from => 'Bar', -where => {y => {"<" => 100}}) ]; ($sql, @bind) = $sqla->select( -from => 'Foo', -where => {x => {-in => \$subq}}, ); is_same_sql_bind( $sql, \@bind, "SELECT * FROM Foo WHERE (x IN (SELECT x FROM Bar WHERE ( y < ? )))", [100], "select -in => subquery", ); # -join ($sql, @bind) = $sqla->select( -from => [-join => qw/Foo fk=pk Bar/] ); is_same_sql_bind( $sql, \@bind, "SELECT * FROM Foo INNER JOIN Bar ON Foo.fk=Bar.pk", [], "select from join", ); # -join with bind values ($sql, @bind) = $sqla->select( -from => [-join => qw/Foo {fk=pk,other='abc'} Bar/] ); is_same_sql_bind( $sql, \@bind, "SELECT * FROM Foo INNER JOIN Bar ON Foo.fk=Bar.pk and Foo.other = ?", ['abc'], "select from join with bind value", ); # set operators ($sql, @bind) = $sqla->select( -columns => [qw/col1 col2/], -from => 'Foo', -where => {col1 => 123}, -intersect => [ -columns => [qw/col3 col4/], -from => 'Bar', -where => {col3 => 456}, ], ); is_same_sql_bind( $sql, \@bind, "SELECT col1, col2 FROM Foo WHERE col1 = ? " ." INTERSECT SELECT col3, col4 FROM Bar WHERE col3 = ?", [123, 456], "from q1 intersect q2", ); ($sql, @bind) = $sqla->select( -columns => [qw/col1 col2/], -from => 'Foo', -where => {col1 => 123}, -union_all => [ -where => {col2 => 456}, -union_all => [-columns => [qw/col1 col3/], -where => {col3 => 789}, ], ], -order_by => [qw/col1 col2/], ); is_same_sql_bind( $sql, \@bind, "SELECT col1, col2 FROM Foo WHERE col1 = ? " ." UNION ALL SELECT col1, col2 FROM Foo WHERE col2 = ?" ." UNION ALL SELECT col1, col3 FROM Foo WHERE col3 = ?" ." ORDER BY col1, col2", [123, 456, 789], "from q1 union_all q2", ); #-order_by ($sql, @bind) = $sqla->select( -from => 'Foo', -order_by => [qw/-foo +bar buz/], ); is_same_sql_bind( $sql, \@bind, "SELECT * FROM Foo ORDER BY foo DESC, bar ASC, buz", [], ); #-group_by / -having ($sql, @bind) = $sqla->select( -columns => [qw/foo SUM(bar)|sum_bar/], -from => 'Foo', -group_by => [qw/foo/], -having => {sum_bar => {">" => 10}}, ); is_same_sql_bind( $sql, \@bind, "SELECT foo, SUM(bar) AS sum_bar FROM Foo GROUP BY foo HAVING sum_bar > ?", [10], "group by / having", ); #-having ($sql, @bind) = $sqla->select( -columns => [qw/SUM(bar)|sum_bar/], -from => 'Foo', -where => { foo => 1 }, -having => {sum_bar => {">" => 10}}, ); is_same_sql_bind( $sql, \@bind, "SELECT SUM(bar) AS sum_bar FROM Foo WHERE ( foo = ? ) HAVING ( sum_bar > ? )", [1,10], "group by / having (2)", ); #-limit alone ($sql, @bind) = $sqla->select( -from => 'Foo', -limit => 100 ); is_same_sql_bind( $sql, \@bind, "SELECT * FROM Foo LIMIT ? OFFSET ?", [100, 0], ); ($sql, @bind) = $sqla->select( -from => 'Foo', -limit => 0, ); is_same_sql_bind( $sql, \@bind, "SELECT * FROM Foo LIMIT ? OFFSET ?", [0, 0], "limit 0", ); #-limit / -offset ($sql, @bind) = $sqla->select( -from => 'Foo', -limit => 100, -offset => 300, ); is_same_sql_bind( $sql, \@bind, "SELECT * FROM Foo LIMIT ? OFFSET ?", [100, 300], ); #-page_size / page_index ($sql, @bind) = $sqla->select( -from => 'Foo', -page_size => 50, -page_index => 2, ); is_same_sql_bind( $sql, \@bind, "SELECT * FROM Foo LIMIT ? OFFSET ?", [50, 50], ); # -for ($sql, @bind) = $sqla->select( -from => 'Foo', -for => "UPDATE", ); is_same_sql_bind( $sql, \@bind, "SELECT * FROM Foo FOR UPDATE", [], ); # -want_details my $details = $sqla->select( -columns => [ qw/f.col1|c1 b.col2|c2 /], -from => [-join => qw/Foo|f fk=pk Bar|b /], -want_details => 1, ); is_same_sql_bind( $details->{sql}, $details->{bind}, "SELECT f.col1 AS c1, b.col2 AS c2 FROM Foo AS f INNER JOIN Bar AS b ON f.fk=b.pk", [], ); is_deeply($details->{aliased_tables}, {f => 'Foo', b => 'Bar'}, "aliased tables"); is_deeply($details->{aliased_columns}, {c1 => 'f.col1', c2 => 'b.col2'}, "aliased columns"); # aliasing, do not conflict with "||" operator ($sql, @bind) = $sqla->select( -columns => [qw/A||B C||D|cd (E||F||G)|efg true|false|bool/], -from => 'Foo', ); is_same_sql_bind( $sql, \@bind, "SELECT A||B, C||D AS cd, (E||F||G) AS efg, true|false AS bool FROM Foo", [], "aliased cols with '|'" ); ($sql, @bind) = $sqla->select( -columns => [qw/NULL|a1 2|a2 x|a3/], -from => 'Foo', ); is_same_sql_bind( $sql, \@bind, "SELECT NULL AS a1, 2 AS a2, x AS a3 FROM Foo", [], "aliased cols with '|', single char on left-hand side" ); # bind_params with SQL types ($sql, @bind) = $sqla->select( -from => 'Foo', -where => {foo => [{dbd_attrs => {ora_type => 'TEST'}}, 123]}, ); is_same_sql_bind( $sql, \@bind, "SELECT * FROM Foo WHERE foo = ?", [ [{dbd_attrs => {ora_type => 'TEST'}}, 123] ], "SQL type with implicit = operator", ); ($sql, @bind) = $sqla->select( -from => 'Foo', -where => {bar => {"<" => [{dbd_attrs => {pg_type => 999}}, 456]}}, ); is_same_sql_bind( $sql, \@bind, "SELECT * FROM Foo WHERE bar < ?", [ [{dbd_attrs => {pg_type => 999}}, 456] ], "SQL type with explicit operator", ); ($sql, @bind) = $sqla->insert( -into => 'Foo', -values => {x => [{dbd_attrs => {pg_type => 999}}, 456]}, ); is_same_sql_bind( $sql, \@bind, "INSERT INTO Foo(x) VALUES(?)", [ [{dbd_attrs => {pg_type => 999}}, 456] ], "INSERT with SQL type", ); ($sql, @bind) = $sqla->update( -table => 'Foo', -set => {x => [{dbd_attrs => {pg_type => 999}}, 456]}, -where => {bar => 'buz'}, ); is_same_sql_bind( $sql, \@bind, "UPDATE Foo SET x = ? WHERE bar = ?", [ [{dbd_attrs => {pg_type => 999}}, 456], 'buz' ], "UPDATE with SQL type", ); # should not be interpreted as bind_params with SQL types ($sql, @bind) = $sqla->select( -from => 'Foo', -where => {bar => [{"=" => undef}, {"<" => 'foo'}]} ); is_same_sql_bind( $sql, \@bind, "SELECT * FROM Foo WHERE bar IS NULL OR bar < ?", [ 'foo' ], "OR arrayref pair which is not a value/type pair", ); #---------------------------------------------------------------------- # auxiliary methods : test an instance with standard parameters #---------------------------------------------------------------------- ($sql, @bind) = $sqla->column_alias(qw/Foo f/); is_same_sql_bind( $$sql, \@bind, "Foo AS f", [], "column alias", ); ($sql, @bind) = $sqla->column_alias(qw/Foo/); is_same_sql_bind( $sql, \@bind, "Foo", [], "column alias without alias", ); ($sql, @bind) = $sqla->table_alias(qw/Foo f/); is_same_sql_bind( $sql, \@bind, "Foo AS f", [], "table alias", ); ($sql, @bind) = $sqla->limit_offset(123, 456); is_same_sql_bind( $sql, \@bind, "LIMIT ? OFFSET ?", [123, 456], "limit offset", ); $join = $sqla->join(qw[Foo|f =>{fk_A=pk_A,fk_B=pk_B} Bar]); is_same_sql_bind( $join->{sql}, $join->{bind}, "Foo AS f LEFT OUTER JOIN Bar ON f.fk_A = Bar.pk_A AND f.fk_B = Bar.pk_B", [], "join syntax", ); $join = $sqla->join(qw[Foo <=>[A{sql}, $join->{bind}, "Foo INNER JOIN Bar ON Foo.A < Bar.B OR Foo.C < Bar.D", [], "join syntax with OR", ); $join = $sqla->join(qw[Foo == Bar]); is_same_sql_bind( $join->{sql}, $join->{bind}, "Foo NATURAL JOIN Bar", [], "natural join", ); # try most syntactic constructs $join = $sqla->join(qw[Table1|t1 ab=cd Table2|t2 <=>{ef>gh,ij{t1.mn=op} Table4]); is_same_sql_bind( $join->{sql}, $join->{bind}, "Table1 AS t1 INNER JOIN Table2 AS t2 ON t1.ab=t2.cd INNER JOIN Table3 ON t2.ef>Table3.gh AND t2.ijjoin(qw[Foo >=<{a=b} Bar]); is_same_sql_bind( $join->{sql}, $join->{bind}, "Foo FULL OUTER JOIN Bar ON Foo.a=Bar.b", [], "full outer join", ); # explicit tables in join condition $join = $sqla->join(qw[Table1|t1 t1.ab=t2.cd Table2|t2]); is_same_sql_bind( $join->{sql}, $join->{bind}, "Table1 AS t1 INNER JOIN Table2 AS t2 ON t1.ab=t2.cd", [], "explicit tables in join condition" ); my $merged = $sqla->merge_conditions( {a => 12, b => {">" => 34}}, {b => {"<" => 56}, c => 78}, ); is_deeply($merged, {a => 12, b => [-and => {">" => 34}, {"<" => 56}], c => 78}); #---------------------------------------------------------------------- # test a customized instance #---------------------------------------------------------------------- $sqla = SQL::Abstract::More->new(table_alias => '%1$s %2$s', limit_offset => "LimitXY", sql_dialect => "MsAccess"); $join = $sqla->join(qw[Foo|f =>{fk_A=pk_A,fk_B=pk_B} Bar]); is_same_sql_bind( $join->{sql}, $join->{bind}, "Foo f LEFT OUTER JOIN (Bar) ON f.fk_A = Bar.pk_A AND f.fk_B = Bar.pk_B", [], ); ($sql, @bind) = $sqla->limit_offset(123, 456); is_same_sql_bind( $sql, \@bind, "LIMIT ?, ?", [456, 123] ); ok($sqla->join_assoc_right, "join_assoc_right is true"); $sqla = SQL::Abstract::More->new(sql_dialect => 'Oracle'); ($sql, @bind) = $sqla->select( -columns => [qw/col1|c1 col2|c2/], -from => [-join => qw/Foo|f fk=pk Bar|b/], ); is_same_sql_bind( $sql, \@bind, "SELECT col1 c1, col2 c2 FROM Foo f INNER JOIN Bar b ON f.fk=b.pk", [] ); ($sql, @bind) = $sqla->select( -from => 'Foo', -limit => 10, -offset => 5, ); is_same_sql_bind( $sql, \@bind, "SELECT * FROM (SELECT subq_A.*, ROWNUM rownum__index FROM (SELECT * FROM Foo) subq_A WHERE ROWNUM <= ?) subq_B WHERE rownum__index >= ?", [15, 6], ); # Oracle12c version of limit/offset $sqla = SQL::Abstract::More->new(sql_dialect => 'Oracle12c'); ($sql, @bind) = $sqla->limit_offset(123, 456); is_same_sql_bind( $sql, \@bind, "OFFSET ? ROWS FETCH NEXT ? ROWS ONLY", [456, 123], "limit/offset for Oracle12c", ); #---------------------------------------------------------------------- # method redefinition #---------------------------------------------------------------------- $sqla = SQL::Abstract::More->new( limit_offset => sub { my ($self, $limit, $offset) = @_; defined $limit or die "NO LIMIT!"; $offset ||= 0; my $last = $offset + $limit; return ("ROWS ? TO ?", $offset, $last); # ($sql, @bind) }); ($sql, @bind) = $sqla->limit_offset(123, 456); is_same_sql_bind( $sql, \@bind, "ROWS ? TO ?", [456, 579] ); #---------------------------------------------------------------------- # max_members_IN #---------------------------------------------------------------------- $sqla = SQL::Abstract::More->new( max_members_IN => 10 ); my @vals = (1 .. 35); ($sql, @bind) = $sqla->where({foo => {-in => \@vals}}); is_same_sql_bind( $sql, \@bind, ' WHERE ( ( foo IN ( ?, ?, ?, ?, ?, ?, ?, ?, ?, ? ) ' . ' OR foo IN ( ?, ?, ?, ?, ?, ?, ?, ?, ?, ? ) ' . ' OR foo IN ( ?, ?, ?, ?, ?, ?, ?, ?, ?, ? ) ' . ' OR foo IN ( ?, ?, ?, ?, ?) ) )', [1 .. 35] ); ($sql, @bind) = $sqla->where({foo => {-not_in => \@vals}}); is_same_sql_bind( $sql, \@bind, ' WHERE ( ( foo NOT IN ( ?, ?, ?, ?, ?, ?, ?, ?, ?, ? ) ' . ' AND foo NOT IN ( ?, ?, ?, ?, ?, ?, ?, ?, ?, ? ) ' . ' AND foo NOT IN ( ?, ?, ?, ?, ?, ?, ?, ?, ?, ? ) ' . ' AND foo NOT IN ( ?, ?, ?, ?, ?) ) )', [1 .. 35] ); $sqla = SQL::Abstract::More->new( max_members_IN => 3 ); ($sql, @bind) = $sqla->where({foo => {-in => [1 .. 5]}, bar => {-not_in => [6 .. 10]}}); is_same_sql_bind( $sql, \@bind, ' WHERE ( ( bar NOT IN ( ?, ?, ? ) AND bar NOT IN ( ?, ? ) )' . ' AND ( foo IN ( ?, ?, ? ) OR foo IN ( ?, ? ) ) )', [6 .. 10, 1 .. 5] ); # test old API : passing a plain scalar value to -in ($sql, @bind) = $sqla->where({foo => {-in => 123}}); is_same_sql_bind( $sql, \@bind, ' WHERE ( foo IN (?) )', [123], ); #---------------------------------------------------------------------- # -in with objects #---------------------------------------------------------------------- my $vals = bless [1, 2], 'Array::PseudoScalar'; # doesn't matter if not loaded ($sql, @bind) = $sqla->where({foo => {-in => $vals}, bar => {-not_in => $vals}}); is_same_sql_bind( $sql, \@bind, ' WHERE ( bar NOT IN ( ?, ? ) AND foo IN ( ?, ? ) )', [1, 2, 1, 2], ); #---------------------------------------------------------------------- # select_implicitly_for #---------------------------------------------------------------------- my $sqla_RO = SQL::Abstract::More->new( select_implicitly_for => 'READ ONLY', ); ($sql, @bind) = $sqla_RO->select(-from => 'Foo'); is_same_sql_bind( $sql, \@bind, 'SELECT * FROM FOO FOR READ ONLY', [], "select_implicitly_for - basic", ); ($sql, @bind) = $sqla_RO->select(-from => 'Foo', -for => 'UPDATE'); is_same_sql_bind( $sql, \@bind, 'SELECT * FROM FOO FOR UPDATE', [], "select_implicitly_for - override", ); ($sql, @bind) = $sqla_RO->select(-from => 'Foo', -for => undef); is_same_sql_bind( $sql, \@bind, 'SELECT * FROM FOO', [], "select_implicitly_for - disable", ); #---------------------------------------------------------------------- # insert #---------------------------------------------------------------------- # usual, hashref syntax ($sql, @bind) = $sqla->insert( -into => 'Foo', -values => {foo => 1, bar => 2}, ); is_same_sql_bind( $sql, \@bind, 'INSERT INTO Foo(bar, foo) VALUES (?, ?)', [2, 1], "insert - hashref", ); # arrayref syntax ($sql, @bind) = $sqla->insert( -into => 'Foo', -values => [1, 2], ); is_same_sql_bind( $sql, \@bind, 'INSERT INTO Foo VALUES (?, ?)', [1, 2], "insert - arrayref", ); # insert .. select ($sql, @bind) = $sqla->insert( -into => 'Foo', -columns => [qw/a b/], -select => {-from => 'Bar', -columns => [qw/x y/]}, ); is_same_sql_bind( $sql, \@bind, 'INSERT INTO Foo(a, b) SELECT x, y FROM Bar', [], "insert .. select", ); # old API ($sql, @bind) = $sqla->insert('Foo', {foo => 1, bar => 2}); is_same_sql_bind( $sql, \@bind, 'INSERT INTO Foo(bar, foo) VALUES (?, ?)', [2, 1], ); ($sql, @bind) = eval {$sqla->insert(-foo => 3); }; ok($@, 'unknown arg to insert()'); # add_sql ($sql, @bind) = $sqla->insert( -into => 'Foo', -add_sql => 'IGNORE', # MySQL syntax -values => {foo => 1, bar => 2}, ); is_same_sql_bind( $sql, \@bind, 'INSERT IGNORE INTO Foo(bar, foo) VALUES (?, ?)', [2, 1], ); ($sql, @bind) = $sqla->insert( -into => 'Foo', -add_sql => 'OR IGNORE', # SQLite syntax -values => {foo => 1, bar => 2}, ); is_same_sql_bind( $sql, \@bind, 'INSERT OR IGNORE INTO Foo(bar, foo) VALUES (?, ?)', [2, 1], ); # returning ($sql, @bind) = $sqla->insert( -into => 'Foo', -values => {foo => 1, bar => 2}, -returning => 'key', ); is_same_sql_bind( $sql, \@bind, 'INSERT INTO Foo(bar, foo) VALUES (?, ?) RETURNING key', [2, 1], ); ($sql, @bind) = $sqla->insert( -into => 'Foo', -values => {foo => 1, bar => 2}, -returning => [qw/k1 k2/], ); is_same_sql_bind( $sql, \@bind, 'INSERT INTO Foo(bar, foo) VALUES (?, ?) RETURNING k1, k2', [2, 1], ); ($sql, @bind) = $sqla->insert( -into => 'Foo', -values => {foo => 1, bar => 2}, -returning => {k1 => \my $k1, k2 => \my $k2}, ); is_same_sql_bind( $sql, \@bind, 'INSERT INTO Foo(bar, foo) VALUES (?, ?) RETURNING k1, k2 INTO ?, ?', [2, 1, \$k2, \$k1], ); # bind_params SKIP: { eval "use DBD::Mock 1.48; 1" or skip "DBD::Mock 1.48 does not seem to be installed", N_DBI_MOCK_TESTS; my $dbh = DBI->connect('DBI:Mock:', '', '', {RaiseError => 1}); my $sth = $dbh->prepare($sql); $sqla->bind_params($sth, @bind); my $mock_params = $sth->{mock_params}; is_deeply($sth->{mock_params}, [2, 1, \$k2, \$k1], "bind_param_inout"); # test 3-args form of bind_param $sth = $dbh->prepare('INSERT INTO Foo(bar, foo) VALUES (?, ?)'); @bind= ([{dbd_attrs => {pg_type => 99}}, 123], [{dbd_attrs => {ora_type => 88}}, 456]); $sqla->bind_params($sth, @bind); is_deeply($sth->{mock_params}, [map {$_->[1]} @bind], 'bind_param($val, \%type) - values'); is_deeply($sth->{mock_param_attrs}, [map {$_->[0]{dbd_attrs}} @bind], 'bind_param($val, \%type) - attrs'); } #---------------------------------------------------------------------- # update #---------------------------------------------------------------------- # complete syntax ($sql, @bind) = $sqla->update( -table => 'Foo', -set => {foo => 1, bar => 2}, -where => {buz => 3}, ); is_same_sql_bind( $sql, \@bind, 'UPDATE Foo SET bar = ?, foo = ? WHERE buz = ?', [2, 1, 3], ); # without where ($sql, @bind) = $sqla->update( -table => 'Foo', -set => {foo => 1, bar => 2}, ); is_same_sql_bind( $sql, \@bind, 'UPDATE Foo SET bar = ?, foo = ?', [2, 1], ); # old API ($sql, @bind) = $sqla->update('Foo', {foo => 1, bar => 2}, {buz => 3}); is_same_sql_bind( $sql, \@bind, 'UPDATE Foo SET bar = ?, foo = ? WHERE buz = ?', [2, 1, 3], ); # MySQL supports -limit and -order_by in updates ! # see http://dev.mysql.com/doc/refman/5.6/en/update.html ($sql, @bind) = $sqla->update( -table => 'Foo', -set => {foo => 1, bar => 2}, -where => {buz => 3}, -order_by => 'baz', -limit => 10, ); is_same_sql_bind( $sql, \@bind, 'UPDATE Foo SET bar = ?, foo = ? WHERE buz = ? ORDER BY baz LIMIT ?', [2, 1, 3, 10], "update with -order_by/-limit", ); ($sql, @bind) = $sqla->update( -table => [-join => qw/Foo fk=pk Bar/], -set => {foo => 1, bar => 2}, ); is_same_sql_bind( $sql, \@bind, 'UPDATE Foo INNER JOIN Bar ON Foo.fk=Bar.pk SET bar = ?, foo = ?', [2, 1], ); # returning ($sql, @bind) = $sqla->update( -table => 'Foo', -set => {foo => 1}, -returning => 'key', ); is_same_sql_bind( $sql, \@bind, 'UPDATE Foo SET foo = ? RETURNING key', [1], 'update returning (scalar)', ); ($sql, @bind) = $sqla->update( -table => 'Foo', -set => {foo => 1}, -returning => [qw/k1 k2/], ); is_same_sql_bind( $sql, \@bind, 'UPDATE Foo SET foo = ? RETURNING k1, k2', [1], 'update returning (arrayref)', ); ($sql, @bind) = $sqla->update( -table => 'Foo', -set => {foo => 1}, -returning => {k1 => \my $kupd1, k2 => \my $kupd2}, ); is_same_sql_bind( $sql, \@bind, 'UPDATE Foo SET foo = ? RETURNING k1, k2 INTO ?, ?', [1, \$kupd1, \$kupd2], 'update returning (hashref)', ); # additional keywords ($sql, @bind) = $sqla->update( -add_sql => 'IGNORE', # MySQL syntax -table => 'Foo', -set => {foo => 1}, ); is_same_sql_bind( $sql, \@bind, 'UPDATE IGNORE Foo SET foo = ?', [1], 'update IGNORE', ); #---------------------------------------------------------------------- # delete #---------------------------------------------------------------------- # complete syntax ($sql, @bind) = $sqla->delete( -from => 'Foo', -where => {buz => 3}, ); is_same_sql_bind( $sql, \@bind, 'DELETE FROM Foo WHERE buz = ?', [3], ); # old API ($sql, @bind) = $sqla->delete('Foo', {buz => 3}); is_same_sql_bind( $sql, \@bind, 'DELETE FROM Foo WHERE buz = ?', [3], ); # MySQL supports -limit and -order_by in deletes ! # see http://dev.mysql.com/doc/refman/5.6/en/delete.html ($sql, @bind) = $sqla->delete( -from => 'Foo', -where => {buz => 3}, -order_by => 'baz', -limit => 10, ); is_same_sql_bind( $sql, \@bind, 'DELETE FROM Foo WHERE buz = ? ORDER BY baz LIMIT ?', [3, 10], "delete with -order_by/-limit", ); # additional keywords ($sql, @bind) = $sqla->delete( -from => 'Foo', -where => {buz => 3}, -add_sql => 'IGNORE', # MySQL syntax ); is_same_sql_bind( $sql, \@bind, 'DELETE IGNORE FROM Foo WHERE buz = ?', [3], 'delete IGNORE', ); #---------------------------------------------------------------------- # quote #---------------------------------------------------------------------- $sqla = SQL::Abstract::More->new({ quote_char => q{"}, name_sep => q{.} }); ($sql, @bind) = $sqla->select( -from => [ -join => qw( t1|left id=t1_id t2|link =>{t3_id=id} t3|right ) ], -columns => [ qw( left.id|left_id max("right"."id")|max_right_id ) ] ); is_same_sql_bind( $sql, \@bind, 'SELECT "left"."id" AS "left_id", max("right"."id") AS "max_right_id" ' . 'FROM "t1" AS "left" ' . 'INNER JOIN "t2" AS "link" ON ("left"."id" = "link"."t1_id")' . 'LEFT OUTER JOIN "t3" AS "right" ON ("link"."t3_id" = "right"."id")', [], ); #---------------------------------------------------------------------- # THE END #---------------------------------------------------------------------- done_testing(); SQL-Abstract-More-1.42/t/02-order-by.t000444000000000000 1051213771712523 17645 0ustar00unknownunknown000000000000use strict; use warnings; use Test::More; use Test::Exception; use SQL::Abstract::More; use SQL::Abstract::Test import => ['is_same_sql_bind']; # This test code is just copied from SQLA, in order to check if all # edge cases are still compatible. my @cases = ( { given => \'colA DESC', expects => ' ORDER BY colA DESC', expects_quoted => ' ORDER BY colA DESC', }, { given => 'colA', expects => ' ORDER BY colA', expects_quoted => ' ORDER BY `colA`', }, { # it may look odd, but this is the desired behaviour (mst) given => 'colA DESC', expects => ' ORDER BY colA DESC', expects_quoted => ' ORDER BY `colA DESC`', }, { given => [qw/colA colB/], expects => ' ORDER BY colA, colB', expects_quoted => ' ORDER BY `colA`, `colB`', }, { # it may look odd, but this is the desired behaviour (mst) given => ['colA ASC', 'colB DESC'], expects => ' ORDER BY colA ASC, colB DESC', expects_quoted => ' ORDER BY `colA ASC`, `colB DESC`', }, { given => {-asc => 'colA'}, expects => ' ORDER BY colA ASC', expects_quoted => ' ORDER BY `colA` ASC', }, { given => {-desc => 'colB'}, expects => ' ORDER BY colB DESC', expects_quoted => ' ORDER BY `colB` DESC', }, { given => [{-asc => 'colA'}, {-desc => 'colB'}], expects => ' ORDER BY colA ASC, colB DESC', expects_quoted => ' ORDER BY `colA` ASC, `colB` DESC', }, { given => ['colA', {-desc => 'colB'}], expects => ' ORDER BY colA, colB DESC', expects_quoted => ' ORDER BY `colA`, `colB` DESC', }, { given => undef, expects => '', expects_quoted => '', }, { given => [{-desc => [ qw/colA colB/ ] }], expects => ' ORDER BY colA DESC, colB DESC', expects_quoted => ' ORDER BY `colA` DESC, `colB` DESC', }, { given => [{-desc => [ qw/colA colB/ ] }, {-asc => 'colC'}], expects => ' ORDER BY colA DESC, colB DESC, colC ASC', expects_quoted => ' ORDER BY `colA` DESC, `colB` DESC, `colC` ASC', }, { given => [{-desc => [ qw/colA colB/ ] }, {-asc => [ qw/colC colD/ ] }], expects => ' ORDER BY colA DESC, colB DESC, colC ASC, colD ASC', expects_quoted => ' ORDER BY `colA` DESC, `colB` DESC, `colC` ASC, `colD` ASC', }, { given => [{-desc => [ qw/colA colB/ ] }, {-desc => 'colC' }], expects => ' ORDER BY colA DESC, colB DESC, colC DESC', expects_quoted => ' ORDER BY `colA` DESC, `colB` DESC, `colC` DESC', }, { given => [{ -asc => 'colA' }, { -desc => [qw/colB/] }, { -asc => [qw/colC colD/] }], expects => ' ORDER BY colA ASC, colB DESC, colC ASC, colD ASC', expects_quoted => ' ORDER BY `colA` ASC, `colB` DESC, `colC` ASC, `colD` ASC', }, { given => { -desc => \['colA LIKE ?', 'test'] }, expects => ' ORDER BY colA LIKE ? DESC', expects_quoted => ' ORDER BY colA LIKE ? DESC', bind => ['test'], }, { given => \['colA LIKE ? DESC', 'test'], expects => ' ORDER BY colA LIKE ? DESC', expects_quoted => ' ORDER BY colA LIKE ? DESC', bind => ['test'], }, { given => [ { -asc => \['colA'] }, { -desc => \['colB LIKE ?', 'test'] }, { -asc => \['colC LIKE ?', 'tost'] }], expects => ' ORDER BY colA ASC, colB LIKE ? DESC, colC LIKE ? ASC', expects_quoted => ' ORDER BY colA ASC, colB LIKE ? DESC, colC LIKE ? ASC', bind => [qw/test tost/], }, { given => [qw(-colA +colB)], expects => ' ORDER BY colA DESC, colB ASC', expects_quoted => ' ORDER BY `colA` DESC, `colB` ASC', }, ); plan tests => (scalar(@cases) * 2) + 2; my $sql = SQL::Abstract::More->new; my $sqlq = SQL::Abstract::More->new(quote_char => '`', name_sep => '.'); for my $case( @cases) { my ($stat, @bind); ($stat, @bind) = $sql->_order_by($case->{given}); is_same_sql_bind ( $stat, \@bind, $case->{expects}, $case->{bind} || [], ); ($stat, @bind) = $sqlq->_order_by($case->{given}); is_same_sql_bind ( $stat, \@bind, $case->{expects_quoted}, $case->{bind} || [], ); } throws_ok ( sub { $sql->_order_by({-desc => 'colA', -asc => 'colB' }) }, qr/hash passed .+ must have exactly one key/, 'Undeterministic order exception', ); throws_ok ( sub { $sql->_order_by({-desc => [ qw/colA colB/ ], -asc => [ qw/colC colD/ ] }) }, qr/hash passed .+ must have exactly one key/, 'Undeterministic order exception', ); SQL-Abstract-More-1.42/t/03-join_with_constants.t000444000000000000 223713771712524 22177 0ustar00unknownunknown000000000000use strict; use warnings; no warnings qw/qw/; use Test::More; use SQL::Abstract::More; use SQL::Abstract::Test import => ['is_same_sql_bind']; plan tests => 5; my $sqla = SQL::Abstract::More->new; my ($sql, @bind, $join); $join = $sqla->join(qw[Foo {fk_A=pk_A,B<'toto',C='123'} Bar]); is_same_sql_bind( $join->{sql}, $join->{bind}, "Foo INNER JOIN Bar ON Foo.B < ? AND Foo.C = ? AND Foo.fk_A = Bar.pk_A", ['toto', 123], ); $join = $sqla->join(qw[Foo {fk_A=pk_A,B<'to''to'''} Bar]); is_same_sql_bind( $join->{sql}, $join->{bind}, "Foo INNER JOIN Bar ON Foo.B < ? AND Foo.fk_A = Bar.pk_A", ["to'to'"], ); $join = $sqla->join(qw[Foo {fk_A=pk_A,B<'to{sql}, $join->{bind}, "Foo INNER JOIN Bar ON Foo.B < ? AND Foo.fk_A = Bar.pk_A", ['tojoin(qw[Foo {fk_A=pk_A,B<'to,to'} Bar]); is_same_sql_bind( $join->{sql}, $join->{bind}, "Foo INNER JOIN Bar ON Foo.B < ? AND Foo.fk_A = Bar.pk_A", ['to,to'], ); $join = $sqla->join(qw[Foo {fk_A=pk_A,B<'to{[}]to'} Bar]); is_same_sql_bind( $join->{sql}, $join->{bind}, "Foo INNER JOIN Bar ON Foo.B < ? AND Foo.fk_A = Bar.pk_A", ['to{[}]to'], ); SQL-Abstract-More-1.42/t/04-multicols_in.t000444000000000000 413613771712524 20613 0ustar00unknownunknown000000000000use strict; use warnings; no warnings qw/qw/; use Test::More; use SQL::Abstract::More; use SQL::Abstract::Test import => ['is_same_sql_bind']; my ($sql, @bind); # test multicols with SQL support my $sqla = SQL::Abstract::More->new( # multicols_sep => '/', multicols_sep => qr[\s*/\s*], has_multicols_in_SQL => 1, ); ($sql, @bind) = $sqla->where({ one_col => 999, "foo/bar" => {-in => ["1/a", "2/b"]}, "x/y/z" => {-not_in => ["X/Y/Z"]}, }); my @expected = ("WHERE (foo, bar) IN ((?, ?), (?, ?)) " ."AND one_col = ? " ."AND (x, y, z) NOT IN ((?, ?, ?))", [qw/1 a 2 b 999 X Y Z/]); is_same_sql_bind($sql, \@bind, @expected); # same test, but with values passed as arrayrefs ($sql, @bind) = $sqla->where({ one_col => 999, "foo/bar" => {-in => [[1, "a"], [2, "b"]]}, "x/y/z" => {-not_in => [[qw/X Y Z/]]}, }); is_same_sql_bind($sql, \@bind, @expected); # right-hand side as a subquery ($sql, @bind) = $sqla->where({ one_col => 999, "foo/bar" => {-in => \"SELECT (a, b) FROM FOOBAR"}, }); is_same_sql_bind($sql, \@bind, "WHERE (foo, bar) IN (SELECT (a, b) FROM FOOBAR)" ."AND one_col = ? ", [999]); # right-hand side as a subquery with bind values ($sql, @bind) = $sqla->where({ one_col => 999, "foo/bar" => {-in => \["SELECT (a, b) FROM FOOBAR WHERE a > ?", 1234]}, }); is_same_sql_bind($sql, \@bind, "WHERE (foo, bar) IN (SELECT (a, b) FROM FOOBAR WHERE a > ?)" ."AND one_col = ? ", [1234, 999]); # test multicols without SQL support $sqla = SQL::Abstract::More->new( # multicols_sep => '/', multicols_sep => qr[\s*/\s*], has_multicols_in_SQL => 0, ); ($sql, @bind) = $sqla->where({ one_col => 999, "foo/bar" => {-in => ["1/a", "2/b"]}, "x/y/z" => {-not_in => ["X/Y/Z"]}, }); is_same_sql_bind( $sql, \@bind, "WHERE ((foo = ? AND bar = ?) OR (foo = ? AND bar = ?)) " ."AND one_col = ? " ."AND NOT (x = ? AND y = ? AND z = ?)", [qw/1 a 2 b 999 X Y Z/], ); done_testing(); SQL-Abstract-More-1.42/t/05-join-with-using.t000444000000000000 240213771712524 21140 0ustar00unknownunknown000000000000use strict; use warnings; no warnings qw/qw/; use Test::More; use SQL::Abstract::More; use SQL::Abstract::Test import => ['is_same_sql_bind']; my $sqla = SQL::Abstract::More->new; my $join; # basic join $join = $sqla->join(qw[Foo {A} Bar]); is_same_sql_bind( $join->{sql}, $join->{bind}, "Foo INNER JOIN Bar USING (A)", [], "basic", ); # condition on two columns $join = $sqla->join(qw[Foo {A,B} Bar]); is_same_sql_bind( $join->{sql}, $join->{bind}, "Foo INNER JOIN Bar USING (A,B)", [], "cond on 2 cols", ); # several tables $join = $sqla->join(qw[Foo {A} Bar {B} Buz]); is_same_sql_bind( $join->{sql}, $join->{bind}, "Foo INNER JOIN Bar USING (A) INNER JOIN Buz USING (B)", [], "several tables", ); $join = $sqla->join('Foo', {operator => '=>', using => [qw/A B/]}, 'Bar'); is_same_sql_bind( $join->{sql}, $join->{bind}, "Foo LEFT OUTER JOIN Bar USING (A, B)", [], "structured join spec", ); eval { $join = $sqla->join('Foo', {operator => '=>', using => [qw/A/], condition => {"Foo.A" => {-ident => "Bar.A"}}}, 'Bar'); }; my $err = $@; like $err, qr/both.*condition.*using/, "proper error message"; done_testing; SQL-Abstract-More-1.42/t/06_with_table_expression.t000444000000000000 1601014003155457 22604 0ustar00unknownunknown000000000000use strict; use warnings; no warnings 'qw'; use SQL::Abstract::More; use Test::More; use SQL::Abstract::Test import => [qw/is_same_sql_bind/]; my $sqla = SQL::Abstract::More->new; my ($sql, @bind, $join); # NOTE: test cases below are inspired from the SQLite documentation for WITH clauses : # https://sqlite.org/lang_with.html # simple graph retrieval ($sql, @bind) = $sqla->with_recursive( -table => 'nodes', -columns => [qw/x/], -as_select => {-from => 'DUAL', -columns => [qw/59/], -union_all => [-from => [-join => qw/edge {bb=x} nodes/], -columns => [qw/aa/], ], }, )->select( -columns => 'x', -from => 'nodes', ); is_same_sql_bind( $sql, \@bind, q{WITH RECURSIVE nodes(x) AS ( SELECT 59 FROM DUAL UNION ALL SELECT aa FROM edge INNER JOIN nodes ON edge.bb=nodes.x) SELECT x FROM nodes}, [], "1-branch graph retrieval", ); # graph retrieval with 2 branches ($sql, @bind) = $sqla->with_recursive( -table => 'nodes', -columns => [qw/x/], -as_select => {-from => 'DUAL', -columns => [qw/59/], -union_all => [-from => [-join => qw/edge {bb=x} nodes/], -columns => [qw/aa/], -union_all => [-from => [-join => qw/edge {aa=x} nodes/], -columns => [qw/bb/]], ], }, )->select( -columns => 'x', -from => 'nodes', ); is_same_sql_bind( $sql, \@bind, q{WITH RECURSIVE nodes(x) AS ( SELECT 59 FROM DUAL UNION ALL SELECT aa FROM edge INNER JOIN nodes ON edge.bb=nodes.x UNION ALL SELECT bb FROM edge INNER JOIN nodes ON edge.aa=nodes.x) SELECT x FROM nodes}, [], "2-branch graph retrieval", ); # several table expressions in the same WITH statement ($sql, @bind) = $sqla->with_recursive( [ -table => 'parent_of', -columns => [qw/name parent/], -as_select => {-columns => [qw/name mom/], -from => 'family', -where => {age => {'>' => 16.1}}, -union => [-columns => [qw/name dad/], -where => {age => {'>' => 16.2}}, -from => 'family']}, ], [ -table => 'ancestor_of_alice', -columns => [qw/name/], -as_select => {-columns => [qw/parent/], -from => 'parent_of', -where => {name => 'Alice'}, -union_all => [-columns => [qw/parent/], -from => [qw/-join parent_of {name} ancestor_of_alice/]], }, ], )->select( -columns => 'family.name', -from => [qw/-join ancestor_of_alice {name} family/], -where => {died => undef}, -order_by => 'born', ); is_same_sql_bind( $sql, \@bind, q{WITH RECURSIVE parent_of(name, parent) AS (SELECT name, mom FROM family WHERE age > ? UNION SELECT name, dad FROM family WHERE age > ?), ancestor_of_alice(name) AS (SELECT parent FROM parent_of WHERE name = ? UNION ALL SELECT parent FROM parent_of INNER JOIN ancestor_of_alice USING(name)) SELECT family.name FROM ancestor_of_alice INNER JOIN family USING(name) WHERE died IS NULL ORDER BY born}, [16.1, 16.2, 'Alice'], "several CTEs in the same WITH clause", ); # auxiliary data for insert / update / delete my $sqla2 = $sqla->with_recursive( -table => 'nodes', -columns => [qw/x/], -as_select => {-from => 'DUAL', -columns => [qw/59/], -union_all => [-from => [-join => qw/edge {bb=x} nodes/], -columns => [qw/aa/], ], }, ); # insert ($sql, @bind) = $sqla2->insert( -into => "edge", -columns => ['aa'], -select => {-columns => 'x', -from => "nodes"}, ); is_same_sql_bind( $sql, \@bind, q{WITH RECURSIVE nodes(x) AS ( SELECT 59 FROM DUAL UNION ALL SELECT aa FROM edge INNER JOIN nodes ON edge.bb=nodes.x) INSERT INTO edge(aa) SELECT x FROM nodes}, [], "insert", ); # update my @subquery = $sqla->select(-columns => 'x', -from => "nodes"); ($sql, @bind) = $sqla2->update( -table => "edge", -set => {foo => "bar"}, -where => {aa => {-in => \\@subquery}} ); is_same_sql_bind( $sql, \@bind, q{WITH RECURSIVE nodes(x) AS ( SELECT 59 FROM DUAL UNION ALL SELECT aa FROM edge INNER JOIN nodes ON edge.bb=nodes.x) UPDATE edge SET foo = ? WHERE aa IN (SELECT x FROM nodes)}, ["bar"], "update", ); # delete ($sql, @bind) = $sqla2->delete( -from => "edge", -where => {aa => {-in => \\@subquery}} ); is_same_sql_bind( $sql, \@bind, q{WITH RECURSIVE nodes(x) AS ( SELECT 59 FROM DUAL UNION ALL SELECT aa FROM edge INNER JOIN nodes ON edge.bb=nodes.x) DELETE FROM edge WHERE aa IN (SELECT x FROM nodes)}, [], "delete", ); # -final_clause -- example with an Oracle CYCLE clause ($sql, @bind) = $sqla->with_recursive( -table => 'nodes', -columns => [qw/x/], -as_select => {-from => 'DUAL', -columns => [qw/59/], -union_all => [-from => [-join => qw/edge {bb=x} nodes/], -columns => [qw/aa/], ], }, -final_clause => "CYCLE x SET is_cycle TO '1' DEFAULT '0'", )->select( -columns => 'x', -from => 'nodes', ); is_same_sql_bind( $sql, \@bind, q{WITH RECURSIVE nodes(x) AS ( SELECT 59 FROM DUAL UNION ALL SELECT aa FROM edge INNER JOIN nodes ON edge.bb=nodes.x) CYCLE x SET is_cycle TO '1' DEFAULT '0' SELECT x FROM nodes}, [], "-final_clause", ); # disable WITH in subqueries -- UNION ($sql, @bind) = $sqla2->select( -columns => [qw/a b/], -from => "Foo", -union => [-columns => [qw/c d/], -from => 'Bar'] ); is_same_sql_bind( $sql, \@bind, q{WITH RECURSIVE nodes(x) AS ( SELECT 59 FROM DUAL UNION ALL SELECT aa FROM edge INNER JOIN nodes ON edge.bb=nodes.x) SELECT a, b FROM Foo UNION SELECT c, d FROM Bar}, [], "subquery - union" ); # disable WITH in subqueries -- GROUP BY ($sql, @bind) = $sqla2->select( -columns => [qw/a count(*)/], -from => "Foo", -group_by => "a", -having => {"count(*)" => {">" => 1}}, ); is_same_sql_bind( $sql, \@bind, q{WITH RECURSIVE nodes(x) AS ( SELECT 59 FROM DUAL UNION ALL SELECT aa FROM edge INNER JOIN nodes ON edge.bb=nodes.x) SELECT a, count(*) FROM Foo GROUP BY a HAVING count(*) > ?}, [1], "subquery - group by" ); done_testing(); SQL-Abstract-More-1.42/t/07-import.t000444000000000000 130714266525457 17433 0ustar00unknownunknown000000000000use strict; use warnings; use Test::More; use SQL::Abstract::Test import => [qw/is_same_sql_bind/]; delete $ENV{SQL_ABSTRACT_MORE_EXTENDS}; { my $use = eval "use SQL::Abstract::More -extends => 'SQL::Abstract'; 1"; ok $use, "use SQLAM -extends => SQLA"; } { my $use = eval "use SQL::Abstract::More -extends => 'SQL::Abstract'; 1"; ok $use, "use SQLAM -extends => SQLA -- 2nd invocation" ; } { my $use = eval "use SQL::Abstract::More; 1"; (my $err = $@) =~ s/ at .*//; ok !$use, "use SQLAM -- no -extends : denied : $err"; } { my $use = eval "use SQL::Abstract::More -extends => 'Classic'; 1"; (my $err = $@) =~ s/ at .*//; ok !$use, "use SQLAM -extends => 'Classic': $err"; } done_testing; SQL-Abstract-More-1.42/t/99_sqla_tests.t000444000000000000 230314222231123 20345 0ustar00unknownunknown000000000000# NOTE : this test was originally written to make sure that SQL::Abstract::More was # fully compliant with SQL::Abstract. However, the internal protocol for representing # bind values has changed in SQL::Abstract v2.0 -- therefore the tests no longer pass, # even if the surface behaviour is still compatible. use strict; use warnings; use Test::More; use FindBin; use TAP::Harness; plan tests => 1; SKIP: { $ENV{SQLA_SRC_DIR} or do { my $msg = 'define $ENV{SQLA_SRC_DIR} to run these tests'; diag $msg; skip $msg, 1; }; open my $fh, ">", \my $tap_output; # all regular SQL::Abstract tests will be run, but through the source filter # "UsurpSQLA" which is located in this t/lib directory. That filter replaces # SQL::Abstract by SQL::Abstract::More in the source code. my $harness = TAP::Harness->new({ lib => ["$ENV{SQLA_SRC_DIR}/lib", "$FindBin::Bin/lib", @INC], switches => ["-MUsurpSQLA"], stdout => $fh, }); my @tests = glob "$ENV{SQLA_SRC_DIR}/t/*.t $ENV{SQLA_SRC_DIR}/t/*/*.t"; diag "Running the whole SQLA test suite through SQLAM.."; my $aggr = $harness->runtests(@tests); diag $tap_output; ok $aggr->all_passed, "SQLA tests against SQLAM"; } SQL-Abstract-More-1.42/t/rt_084972.t000444000000000000 235213771712524 17151 0ustar00unknownunknown000000000000use strict; use warnings; use Test::More; use Test::Exception; use SQL::Abstract::More; use SQL::Abstract::Test import => ['eq_sql']; use List::MoreUtils qw/any/; plan tests => 2; my $sqla = SQL::Abstract::More->new; my $result = $sqla->join( 'table', { operator => '=>', condition => { '%1$s.table_id' => {-ident => '%2$s.table_id'}, '%2$s.date' => {'>' => {-ident => '%1$s.date'}}, '%2$s.event_id' => 1}}, 'table_log' ); # we don't know the order of conditions generated by SQL::Abstract; # but unfortunately, SQL::Abstract::Test is not clever enough to apply # commutativity on AND, so we have to do it by hand my @conditions = ( 'table_log.date > table.date', 'table.table_id = table_log.table_id', 'table_log.event_id = ?', ); my @possible_SQL = map {"table LEFT OUTER JOIN table_log ON " . join(' AND ', @$_) } permutations(@conditions); ok (any { eq_sql($result->{sql}, $_) } @possible_SQL); is_deeply ($result->{bind}, [1]); sub permutations { return \@_ if @_ < 2; my @result; for my $i (0 .. $#_) { my @tail = @_; my $head = splice(@tail, $i, 1); push @result, map {[$head, @$_ ]} permutations(@tail); } return @result; } SQL-Abstract-More-1.42/t/rt_086895.t000444000000000000 170612760044447 17160 0ustar00unknownunknown000000000000use strict; use warnings; use Test::More; use Test::Exception; use SQL::Abstract::More; use SQL::Abstract::Test import => ['is_same_sql_bind']; plan tests => 2; my $sqla = SQL::Abstract::More->new(); my ($sql,@bind) = $sqla->select( -from => 't2', -where => {col => {-in => \[$sqla->select( -columns => 'some_key', -from => 't1', -order_by => 'foo', )]}}, -group_by => 'bar', ); is_same_sql_bind ( $sql, \@bind, 'SELECT * FROM t2 WHERE ( col IN ( SELECT some_key FROM t1 ORDER BY foo ) ) ' . 'GROUP BY bar', [], ); ($sql,@bind) = $sqla->select( -from => 't2', -where => {col => {-in => \[$sqla->select( -columns => 'some_key', -from => 't1', -order_by => 'foo', )]}}, -group_by => 'bar', -order_by => 'buz', ); is_same_sql_bind ( $sql, \@bind, 'SELECT * FROM t2 WHERE ( col IN ( SELECT some_key FROM t1 ORDER BY foo ) ) ' . 'GROUP BY bar ORDER BY buz', [], ); SQL-Abstract-More-1.42/t/rt_099455.t000444000000000000 105312760044447 17147 0ustar00unknownunknown000000000000use strict; use warnings; use Test::More; use Test::Exception; use SQL::Abstract::More; use SQL::Abstract::Test import => ['is_same_sql_bind']; # GOAL : spaces before the column spec or after the alias name will be ignored plan tests => 1; my $sqla = SQL::Abstract::More->new(); my ($sql,@bind) = $sqla->select( -from => 'foo', -columns => q[ concat_ws( ' ', t2.first_name,t2.last_name )|assigned_by_long ], ); is_same_sql_bind ( $sql, \@bind, q[SELECT concat_ws( ' ', t2.first_name,t2.last_name ) AS assigned_by_long FROM foo], [], ); SQL-Abstract-More-1.42/t/classic000755000000000000 014553555043 16764 5ustar00unknownunknown000000000000SQL-Abstract-More-1.42/t/classic/parent_classic.t000444000000000000 114514004471712 22270 0ustar00unknownunknown000000000000use strict; use warnings; use Test::More; use FindBin; use TAP::Harness; SKIP: { eval "use SQL::Abstract::Classic; 1" or skip "SQL::Abstract::Classic is not installed on this system"; open my $fh, ">", \my $tap_output; my $harness = TAP::Harness->new({ stdout => $fh}); $ENV{SQL_ABSTRACT_MORE_EXTENDS} = 'Classic'; undef $ENV{SQLA_SRC_DIR}; diag "Running the test suite with option -extends => 'Classic'"; my @tests = glob "$FindBin::Bin/../*.t"; my $aggr = $harness->runtests(@tests); diag $tap_output; ok $aggr->all_passed, "tests against -extends => 'Classic'"; } done_testing; SQL-Abstract-More-1.42/t/lib000755000000000000 014553555043 16111 5ustar00unknownunknown000000000000SQL-Abstract-More-1.42/t/lib/UsurpSQLA.pm000444000000000000 31014222230636 20344 0ustar00unknownunknown000000000000package UsurpSQLA; # This is a source filter that replaces SQL::Abstract by # SQL::Abstract::More in the source code. use Filter::Simple sub {s/SQL::Abstract(;|->)/SQL::Abstract::More$1/g;}; 1; SQL-Abstract-More-1.42/xt000755000000000000 014553555043 15533 5ustar00unknownunknown000000000000SQL-Abstract-More-1.42/xt/pod.t000444000000000000 35012760044447 16614 0ustar00unknownunknown000000000000#!perl -T use strict; use warnings; use Test::More; # Ensure a recent version of Test::Pod my $min_tp = 1.22; eval "use Test::Pod $min_tp"; plan skip_all => "Test::Pod $min_tp required for testing POD" if $@; all_pod_files_ok();