Commit | Line | Data |
1ff9018c |
1 | package SQL::Abstract::ExtraClauses; |
2 | |
df5d0507 |
3 | use Moo; |
4 | |
5 | has sqla => ( |
6 | is => 'ro', init_arg => undef, |
7 | handles => [ qw( |
8480fb63 |
8 | expand_expr render_aqt join_query_parts |
df5d0507 |
9 | ) ], |
10 | ); |
1ff9018c |
11 | |
df5d0507 |
12 | sub cb { |
c671eba6 |
13 | my ($self, $method, @args) = @_; |
14 | return sub { |
15 | local $self->{sqla} = shift; |
16 | $self->$method(@args, @_) |
17 | }; |
df5d0507 |
18 | } |
19 | |
ec49a2e1 |
20 | sub register { |
d37f2f17 |
21 | my ($self, @pairs) = @_; |
ec49a2e1 |
22 | my $sqla = $self->sqla; |
d37f2f17 |
23 | while (my ($method, $cases) = splice(@pairs, 0, 2)) { |
24 | my @cases = @$cases; |
25 | while (my ($name, $case) = splice(@cases, 0, 2)) { |
26 | $sqla->$method($name, $self->cb($case)); |
27 | } |
ec49a2e1 |
28 | } |
29 | return $self; |
30 | } |
31 | |
df5d0507 |
32 | sub apply_to { |
33 | my ($self, $sqla) = @_; |
34 | $self = $self->new unless ref($self); |
ec49a2e1 |
35 | local $self->{sqla} = $sqla; |
36 | $self->register_extensions($sqla); |
37 | } |
38 | |
39 | sub register_extensions { |
40 | my ($self, $sqla) = @_; |
f1c52c0c |
41 | |
ad078c71 |
42 | my @clauses = $sqla->clauses_of('select'); |
2b0b3d43 |
43 | my @before_setop; |
44 | CLAUSE: foreach my $idx (0..$#clauses) { |
45 | if ($clauses[$idx] eq 'order_by') { |
46 | @before_setop = @clauses[0..$idx-1]; |
47 | splice(@clauses, $idx, 0, qw(setop group_by having)); |
48 | last CLAUSE; |
49 | } |
50 | } |
f1c52c0c |
51 | |
2b0b3d43 |
52 | die "Huh?" unless @before_setop; |
4be5ded3 |
53 | $sqla->clauses_of(select => @clauses); |
58ebc7fa |
54 | |
ad078c71 |
55 | $sqla->clauses_of(update => sub { |
ee706e89 |
56 | my ($self, @clauses) = @_; |
57 | splice(@clauses, 2, 0, 'from'); |
58 | @clauses; |
59 | }); |
60 | |
ad078c71 |
61 | $sqla->clauses_of(delete => sub { |
ee706e89 |
62 | my ($self, @clauses) = @_; |
63 | splice(@clauses, 1, 0, 'using'); |
64 | @clauses; |
65 | }); |
66 | |
4be5ded3 |
67 | $self->register( |
f1c52c0c |
68 | (map +( |
69 | "${_}er" => [ |
70 | do { |
71 | my $x = $_; |
72 | (map +($_ => "_${x}_${_}"), qw(join from_list alias)) |
73 | } |
74 | ] |
75 | ), qw(expand render)), |
76 | binop_expander => [ as => '_expand_op_as' ], |
77 | renderer => [ as => '_render_as' ], |
78 | expander => [ cast => '_expand_cast' ], |
4be5ded3 |
79 | clause_expanders => [ |
f1c52c0c |
80 | "select.from", '_expand_from_list', |
81 | 'select.group_by' |
8480fb63 |
82 | => sub { $_[0]->expand_expr({ -list => $_[2] }, -ident) }, |
f1c52c0c |
83 | 'select.having' |
84 | => sub { $_[0]->expand_expr($_[2]) }, |
4be5ded3 |
85 | 'update.from' => '_expand_from_list', |
f1c52c0c |
86 | "update.target", '_expand_update_clause_target', |
87 | "update.update", '_expand_update_clause_target', |
4be5ded3 |
88 | 'delete.using' => '_expand_from_list', |
89 | 'insert.rowvalues' => sub { |
90 | +(from => $_[0]->expand_expr({ -values => $_[2] })); |
91 | }, |
92 | 'insert.select' => sub { |
93 | +(from => $_[0]->expand_expr({ -select => $_[2] })); |
94 | }, |
95 | ], |
58ebc7fa |
96 | ); |
26994fdd |
97 | |
2b0b3d43 |
98 | # set ops |
ad078c71 |
99 | $sqla->wrap_expander(select => sub { |
c671eba6 |
100 | $self->cb('_expand_select', $_[0], \@before_setop); |
3f9899e5 |
101 | }); |
2b0b3d43 |
102 | |
4be5ded3 |
103 | $self->register( |
104 | clause_renderer => [ |
105 | 'select.setop' => sub { $_[0]->render_aqt($_[2]) } |
106 | ], |
de3eeaea |
107 | expander => [ |
108 | map +($_ => '_expand_setop', "${_}_all" => '_expand_setop'), qw(union intersect except) ], |
4be5ded3 |
109 | renderer => [ map +($_ => '_render_setop'), qw(union intersect except) ], |
e2db8228 |
110 | ); |
2b0b3d43 |
111 | |
41086177 |
112 | my $setop_expander = $self->cb('_expand_clause_setop'); |
f61bfd7b |
113 | |
ad078c71 |
114 | $sqla->clause_expanders( |
f61bfd7b |
115 | map +($_ => $setop_expander), |
116 | map "select.${_}", |
117 | map +($_, "${_}_all", "${_}_distinct"), |
118 | qw(union intersect except) |
119 | ); |
d175037f |
120 | |
4be5ded3 |
121 | foreach my $stmt (qw(select insert update delete)) { |
ad078c71 |
122 | $sqla->clauses_of($stmt => 'with', $sqla->clauses_of($stmt)); |
4be5ded3 |
123 | $self->register( |
124 | clause_expanders => [ |
125 | "${stmt}.with" => '_expand_with', |
126 | "${stmt}.with_recursive" => '_expand_with', |
127 | ], |
128 | clause_renderer => [ "${stmt}.with" => '_render_with' ], |
129 | ); |
a97ecd95 |
130 | } |
2f4717ad |
131 | |
ad078c71 |
132 | return $sqla; |
1ff9018c |
133 | } |
134 | |
c671eba6 |
135 | sub _expand_select { |
093442c8 |
136 | my ($self, $orig, $before_setop, @args) = @_; |
137 | my $exp = $self->sqla->$orig(@args); |
c671eba6 |
138 | return $exp unless my $setop = (my $sel = $exp->{-select})->{setop}; |
139 | if (my @keys = grep $sel->{$_}, @$before_setop) { |
140 | my %inner; @inner{@keys} = delete @{$sel}{@keys}; |
141 | unshift @{(values(%$setop))[0]{queries}}, |
142 | { -select => \%inner }; |
143 | } |
144 | return $exp; |
145 | } |
146 | |
7741b7ad |
147 | sub _expand_from_list { |
148 | my ($self, undef, $args) = @_; |
149 | if (ref($args) eq 'HASH') { |
38e67490 |
150 | return $args if $args->{-from_list}; |
7741b7ad |
151 | return { -from_list => [ $self->expand_expr($args) ] }; |
152 | } |
153 | my @list; |
86a6ebf4 |
154 | my @args = ref($args) eq 'ARRAY' ? @$args : ($args); |
7741b7ad |
155 | while (my $entry = shift @args) { |
b99e9a14 |
156 | if (!ref($entry) and $entry =~ /^-(.*)/) { |
157 | if ($1 eq 'as') { |
158 | $list[-1] = $self->expand_expr({ -as => [ |
159 | $list[-1], map +(ref($_) eq 'ARRAY' ? @$_ : $_), shift(@args) |
160 | ]}); |
161 | next; |
162 | } |
7741b7ad |
163 | $entry = { $entry => shift @args }; |
164 | } |
165 | my $aqt = $self->expand_expr($entry, -ident); |
166 | if ($aqt->{-join} and not $aqt->{-join}{from}) { |
167 | $aqt->{-join}{from} = pop @list; |
168 | } |
169 | push @list, $aqt; |
170 | } |
09742461 |
171 | return $list[0] if @list == 1; |
7741b7ad |
172 | return { -from_list => \@list }; |
173 | } |
174 | |
175 | sub _expand_join { |
176 | my ($self, undef, $args) = @_; |
177 | my %proto = ( |
178 | ref($args) eq 'HASH' |
179 | ? %$args |
d36cb439 |
180 | : (to => @$args) |
7741b7ad |
181 | ); |
b99e9a14 |
182 | if (my $as = delete $proto{as}) { |
ca97398a |
183 | $proto{to} = $self->expand_expr( |
184 | { -as => [ { -from_list => $proto{to} }, $as ] } |
185 | ); |
b99e9a14 |
186 | } |
e0eb8d26 |
187 | if (defined($proto{using}) and ref(my $using = $proto{using}) ne 'HASH') { |
13c99dad |
188 | $proto{using} = [ |
e0eb8d26 |
189 | map [ $self->expand_expr($_, -ident) ], |
190 | ref($using) eq 'ARRAY' ? @$using: $using |
13c99dad |
191 | ]; |
e0eb8d26 |
192 | } |
ca97398a |
193 | my %ret = ( |
194 | type => delete $proto{type}, |
195 | to => $self->expand_expr({ -from_list => delete $proto{to} }, -ident) |
ca97398a |
196 | ); |
197 | %ret = (%ret, |
198 | map +($_ => $self->expand_expr($proto{$_}, -ident)), |
199 | sort keys %proto |
200 | ); |
7741b7ad |
201 | return +{ -join => \%ret }; |
202 | } |
203 | |
204 | sub _render_from_list { |
a01911a2 |
205 | my ($self, undef, $list) = @_; |
a1f8b6ef |
206 | return $self->join_query_parts(', ', @$list); |
7741b7ad |
207 | } |
208 | |
209 | sub _render_join { |
a01911a2 |
210 | my ($self, undef, $args) = @_; |
7741b7ad |
211 | |
212 | my @parts = ( |
412f9efe |
213 | $args->{from}, |
1601bb47 |
214 | { -keyword => join '_', ($args->{type}||()), 'join' }, |
ca97398a |
215 | (map +($_->{-ident} || $_->{-as} |
216 | ? $_ |
217 | : ('(', $self->render_aqt($_, 1), ')')), |
09742461 |
218 | map +(@{$_->{-from_list}||[]} == 1 ? $_->{-from_list}[0] : $_), |
219 | $args->{to} |
ca97398a |
220 | ), |
7741b7ad |
221 | ($args->{on} ? ( |
1601bb47 |
222 | { -keyword => 'on' }, |
412f9efe |
223 | $args->{on}, |
7741b7ad |
224 | ) : ()), |
225 | ($args->{using} ? ( |
1601bb47 |
226 | { -keyword => 'using' }, |
13c99dad |
227 | '(', $args->{using}, ')', |
7741b7ad |
228 | ) : ()), |
229 | ); |
0236f122 |
230 | return $self->join_query_parts(' ', @parts); |
7741b7ad |
231 | } |
232 | |
b99e9a14 |
233 | sub _expand_op_as { |
234 | my ($self, undef, $vv, $k) = @_; |
984db0d7 |
235 | my @vv = (ref($vv) eq 'ARRAY' ? @$vv : $vv); |
984db0d7 |
236 | my $ik = $self->expand_expr($k, -ident); |
4979c509 |
237 | return +{ -as => [ $ik, $self->expand_expr($vv[0], -ident) ] } |
984db0d7 |
238 | if @vv == 1 and ref($vv[0]) eq 'HASH'; |
239 | |
240 | my @as = map $self->expand_expr($_, -ident), @vv; |
4979c509 |
241 | return { -as => [ $ik, $self->expand_expr({ -alias => \@as }) ] }; |
b99e9a14 |
242 | } |
243 | |
244 | sub _render_as { |
a01911a2 |
245 | my ($self, undef, $args) = @_; |
984db0d7 |
246 | my ($thing, $alias) = @$args; |
0236f122 |
247 | return $self->join_query_parts( |
ac7992be |
248 | ' ', |
984db0d7 |
249 | $thing, |
1601bb47 |
250 | { -keyword => 'as' }, |
984db0d7 |
251 | $alias, |
1ba47f38 |
252 | ); |
253 | } |
254 | |
255 | sub _render_alias { |
984db0d7 |
256 | my ($self, undef, $args) = @_; |
1ba47f38 |
257 | my ($as, @cols) = @$args; |
258 | return (@cols |
0236f122 |
259 | ? $self->join_query_parts('', |
a1f8b6ef |
260 | $as, |
3f312d2e |
261 | '(', |
262 | $self->join_query_parts( |
263 | ', ', |
264 | @cols |
265 | ), |
266 | ')', |
1ba47f38 |
267 | ) |
268 | : $self->render_aqt($as) |
b99e9a14 |
269 | ); |
270 | } |
271 | |
f9f1fdcd |
272 | sub _expand_update_clause_target { |
fe8b493f |
273 | my ($self, undef, $target) = @_; |
f9f1fdcd |
274 | +(target => $self->_expand_from_list(undef, $target)); |
275 | } |
276 | |
2f4717ad |
277 | sub _expand_cast { |
278 | my ($self, undef, $thing) = @_; |
279 | return { -func => [ cast => $thing ] } if ref($thing) eq 'HASH'; |
280 | my ($cast, $to) = @{$thing}; |
281 | +{ -func => [ cast => { -as => [ |
282 | $self->expand_expr($cast), |
283 | $self->expand_expr($to, -ident), |
284 | ] } ] }; |
285 | } |
286 | |
287 | sub _expand_alias { |
288 | my ($self, undef, $args) = @_; |
289 | if (ref($args) eq 'HASH' and my $alias = $args->{-alias}) { |
290 | $args = $alias; |
291 | } |
4979c509 |
292 | my @parts = map $self->expand_expr($_, -ident), |
293 | ref($args) eq 'ARRAY' ? @{$args} : $args; |
294 | return $parts[0] if @parts == 1; |
295 | return { -alias => \@parts }; |
2f4717ad |
296 | } |
297 | |
298 | sub _expand_with { |
299 | my ($self, $name, $with) = @_; |
300 | my (undef, $type) = split '_', $name; |
301 | if (ref($with) eq 'HASH') { |
302 | return +{ |
303 | %$with, |
304 | queries => [ |
305 | map +[ |
306 | $self->expand_expr({ -alias => $_->[0] }, -ident), |
307 | $self->expand_expr($_->[1]), |
308 | ], @{$with->{queries}} |
309 | ] |
310 | } |
311 | } |
312 | my @with = @$with; |
313 | my @exp; |
314 | while (my ($alias, $query) = splice @with, 0, 2) { |
315 | push @exp, [ |
316 | $self->expand_expr({ -alias => $alias }, -ident), |
317 | $self->expand_expr($query) |
318 | ]; |
319 | } |
320 | return +(with => { ($type ? (type => $type) : ()), queries => \@exp }); |
321 | } |
322 | |
323 | sub _render_with { |
324 | my ($self, undef, $with) = @_; |
325 | my $q_part = $self->join_query_parts(', ', |
326 | map { |
327 | my ($alias, $query) = @$_; |
328 | $self->join_query_parts(' ', |
329 | $alias, |
1601bb47 |
330 | { -keyword => 'as' }, |
2f4717ad |
331 | $query, |
332 | ) |
333 | } @{$with->{queries}} |
334 | ); |
335 | return $self->join_query_parts(' ', |
1601bb47 |
336 | { -keyword => join '_', 'with', ($with->{type}||'') }, |
2f4717ad |
337 | $q_part, |
338 | ); |
339 | } |
340 | |
51046d0e |
341 | sub _expand_setop { |
342 | my ($self, $setop, $args) = @_; |
de3eeaea |
343 | my $is_all = $setop =~ s/_all$//; |
51046d0e |
344 | +{ "-${setop}" => { |
de3eeaea |
345 | ($is_all ? (type => 'all') : ()), |
346 | (ref($args) eq 'ARRAY' |
347 | ? (queries => [ map $self->expand_expr($_), @$args ]) |
348 | : ( |
349 | %$args, |
350 | queries => [ map $self->expand_expr($_), @{$args->{queries}} ] |
351 | ) |
352 | ), |
51046d0e |
353 | } }; |
354 | } |
355 | |
b5f4a869 |
356 | sub _render_setop { |
357 | my ($self, $setop, $args) = @_; |
358 | $self->join_query_parts( |
1601bb47 |
359 | { -keyword => ' '.join('_', $setop, ($args->{type}||())).' ' }, |
b5f4a869 |
360 | @{$args->{queries}} |
361 | ); |
362 | } |
363 | |
41086177 |
364 | sub _expand_clause_setop { |
365 | my ($self, $setop, $args) = @_; |
366 | my ($op, $type) = split '_', $setop; |
367 | +(setop => $self->expand_expr({ |
368 | "-${op}" => { |
369 | ($type ? (type => $type) : ()), |
370 | queries => (ref($args) eq 'ARRAY' ? $args : [ $args ]) |
371 | } |
372 | })); |
373 | } |
374 | |
1ff9018c |
375 | 1; |
3001f097 |
376 | |
583c7957 |
377 | __END__ |
378 | |
3001f097 |
379 | =head1 NAME |
380 | |
381 | SQL::Abstract::ExtraClauses - new/experimental additions to L<SQL::Abstract> |
382 | |
383 | =head1 SYNOPSIS |
384 | |
385 | my $sqla = SQL::Abstract->new; |
386 | SQL::Abstract::ExtraClauses->apply_to($sqla); |
387 | |
6aac9987 |
388 | =head1 WARNING |
389 | |
390 | This module is basically a nursery for things that seem like a good idea |
391 | to live in until we figure out if we were right about that. |
392 | |
3001f097 |
393 | =head1 METHODS |
394 | |
395 | =head2 apply_to |
396 | |
397 | Applies the plugin to an L<SQL::Abstract> object. |
398 | |
f1c52c0c |
399 | =head2 register_extensions |
400 | |
401 | Registers the extensions described below |
402 | |
3001f097 |
403 | =head2 cb |
404 | |
405 | For plugin authors, creates a callback to call a method on the plugin. |
406 | |
f1c52c0c |
407 | =head2 register |
408 | |
409 | For plugin authors, registers callbacks more easily. |
410 | |
3001f097 |
411 | =head2 sqla |
412 | |
413 | Available only during plugin callback executions, contains the currently |
414 | active L<SQL::Abstract> object. |
415 | |
583c7957 |
416 | =head1 NODE TYPES |
417 | |
418 | =head2 alias |
419 | |
420 | Represents a table alias. Expands name and column names with ident as default. |
421 | |
422 | # expr |
423 | { -alias => [ 't', 'x', 'y', 'z' ] } |
424 | |
425 | # aqt |
426 | { -alias => [ |
427 | { -ident => [ 't' ] }, { -ident => [ 'x' ] }, |
428 | { -ident => [ 'y' ] }, { -ident => [ 'z' ] }, |
429 | ] } |
430 | |
431 | # query |
432 | t(x, y, z) |
433 | [] |
434 | |
435 | =head2 as |
436 | |
437 | Represents an sql AS. LHS is expanded with ident as default, RHS is treated |
438 | as a list of arguments for the alias node. |
439 | |
440 | # expr |
441 | { foo => { -as => 'bar' } } |
442 | |
443 | # aqt |
4979c509 |
444 | { -as => [ { -ident => [ 'foo' ] }, { -ident => [ 'bar' ] } ] } |
583c7957 |
445 | |
446 | # query |
447 | foo AS bar |
448 | [] |
449 | |
450 | # expr |
451 | { -as => [ { -select => { _ => 'blah' } }, 't', 'blah' ] } |
452 | |
453 | # aqt |
454 | { -as => [ |
455 | { -select => |
456 | { select => { -op => [ ',', { -ident => [ 'blah' ] } ] } } |
457 | }, |
458 | { -alias => [ { -ident => [ 't' ] }, { -ident => [ 'blah' ] } ] }, |
459 | ] } |
460 | |
461 | # query |
462 | (SELECT blah) AS t(blah) |
463 | [] |
464 | |
465 | =head2 cast |
466 | |
467 | # expr |
468 | { -cast => [ { -ident => 'birthday' }, 'date' ] } |
469 | |
470 | # aqt |
471 | { -func => [ |
472 | 'cast', { |
473 | -as => [ { -ident => [ 'birthday' ] }, { -ident => [ 'date' ] } ] |
474 | }, |
475 | ] } |
476 | |
477 | # query |
478 | CAST(birthday AS date) |
479 | [] |
480 | |
d36cb439 |
481 | =head2 join |
482 | |
483 | If given an arrayref, pretends it was given a hashref with the first |
484 | element of the arrayref as the value for 'to' and the remaining pairs copied. |
485 | |
486 | Given a hashref, the 'as' key is if presented expanded to wrap the 'to'. |
487 | |
488 | If present the 'using' key is expanded as a list of idents. |
489 | |
490 | Known keys are: 'from' (the left hand side), 'type' ('left', 'right', or |
491 | nothing), 'to' (the right hand side), 'on' and 'using'. |
492 | |
493 | # expr |
494 | { -join => { |
495 | from => 'lft', |
496 | on => { 'lft.bloo' => { '>' => 'rgt.blee' } }, |
497 | to => 'rgt', |
498 | type => 'left', |
499 | } } |
500 | |
501 | # aqt |
502 | { -join => { |
503 | from => { -ident => [ 'lft' ] }, |
504 | on => { -op => [ |
505 | '>', { -ident => [ 'lft', 'bloo' ] }, |
506 | { -ident => [ 'rgt', 'blee' ] }, |
507 | ] }, |
508 | to => { -ident => [ 'rgt' ] }, |
509 | type => 'left', |
510 | } } |
511 | |
512 | # query |
513 | lft LEFT JOIN rgt ON lft.bloo > rgt.blee |
514 | [] |
515 | |
516 | =head2 from_list |
517 | |
518 | List of components of the FROM clause; -foo type elements indicate a pair |
519 | with the next element; this is easiest if I show you: |
520 | |
521 | # expr |
522 | { -from_list => [ |
523 | 't1', -as => 'table_one', -join => |
524 | [ 't2', 'on', { 'table_one.x' => 't2.x' } ], |
525 | ] } |
526 | |
527 | # aqt |
09742461 |
528 | { -join => { |
4979c509 |
529 | from => |
530 | { |
531 | -as => [ { -ident => [ 't1' ] }, { -ident => [ 'table_one' ] } ] |
532 | }, |
09742461 |
533 | on => { -op => [ |
534 | '=', { -ident => [ 'table_one', 'x' ] }, |
535 | { -ident => [ 't2', 'x' ] }, |
536 | ] }, |
537 | to => { -ident => [ 't2' ] }, |
538 | type => undef, |
539 | } } |
d36cb439 |
540 | |
541 | # query |
542 | t1 AS table_one JOIN t2 ON table_one.x = t2.x |
543 | [] |
544 | |
545 | Or with using: |
546 | |
547 | # expr |
548 | { -from_list => |
549 | [ 't1', -as => 'table_one', -join => [ 't2', 'using', [ 'x' ] ] ] |
550 | } |
551 | |
552 | # aqt |
09742461 |
553 | { -join => { |
4979c509 |
554 | from => |
555 | { |
556 | -as => [ { -ident => [ 't1' ] }, { -ident => [ 'table_one' ] } ] |
557 | }, |
09742461 |
558 | to => { -ident => [ 't2' ] }, |
559 | type => undef, |
560 | using => |
561 | { -op => [ 'or', { -op => [ 'or', { -ident => [ 'x' ] } ] } ] }, |
562 | } } |
d36cb439 |
563 | |
564 | # query |
565 | t1 AS table_one JOIN t2 USING ( x ) |
566 | [] |
567 | |
568 | With oddities: |
569 | |
570 | # expr |
571 | { -from_list => [ |
ca97398a |
572 | 'x', -join => |
573 | [ [ 'y', -join => [ 'z', 'type', 'left' ] ], 'type', 'left' ], |
d36cb439 |
574 | ] } |
575 | |
576 | # aqt |
09742461 |
577 | { -join => { |
578 | from => { -ident => [ 'x' ] }, |
579 | to => { -join => { |
580 | from => { -ident => [ 'y' ] }, |
581 | to => { -ident => [ 'z' ] }, |
d36cb439 |
582 | type => 'left', |
09742461 |
583 | } }, |
584 | type => 'left', |
585 | } } |
d36cb439 |
586 | |
587 | # query |
588 | x LEFT JOIN ( y LEFT JOIN z ) |
589 | [] |
590 | |
de3eeaea |
591 | =head2 setops |
592 | |
593 | Expanders are provided for union, union_all, intersect, intersect_all, |
594 | except and except_all, and each takes an arrayref of queries: |
595 | |
596 | # expr |
597 | { -union => [ |
598 | { -select => { _ => { -value => 1 } } }, |
599 | { -select => { _ => { -value => 2 } } }, |
600 | ] } |
601 | |
602 | # aqt |
603 | { -union => { queries => [ |
604 | { -select => |
605 | { select => { -op => [ ',', { -bind => [ undef, 1 ] } ] } } |
606 | }, |
607 | { -select => |
608 | { select => { -op => [ ',', { -bind => [ undef, 2 ] } ] } } |
609 | }, |
610 | ] } } |
611 | |
612 | # query |
613 | (SELECT ?) UNION (SELECT ?) |
614 | [ 1, 2 ] |
615 | |
616 | # expr |
617 | { -union_all => [ |
618 | { -select => { _ => { -value => 1 } } }, |
619 | { -select => { _ => { -value => 2 } } }, |
620 | { -select => { _ => { -value => 1 } } }, |
621 | ] } |
622 | |
623 | # aqt |
624 | { -union => { |
625 | queries => [ |
626 | { -select => |
627 | { select => { -op => [ ',', { -bind => [ undef, 1 ] } ] } } |
628 | }, |
629 | { -select => |
630 | { select => { -op => [ ',', { -bind => [ undef, 2 ] } ] } } |
631 | }, |
632 | { -select => |
633 | { select => { -op => [ ',', { -bind => [ undef, 1 ] } ] } } |
634 | }, |
635 | ], |
636 | type => 'all', |
637 | } } |
638 | |
639 | # query |
640 | (SELECT ?) UNION ALL (SELECT ?) UNION ALL (SELECT ?) |
641 | [ 1, 2, 1 ] |
642 | |
6aac9987 |
643 | =head1 STATEMENT EXTENSIONS |
644 | |
645 | =head2 group by clause for select |
646 | |
647 | Expanded as a list with an ident default: |
648 | |
649 | # expr |
650 | { -select => { group_by => [ 'foo', 'bar' ] } } |
651 | |
652 | # aqt |
653 | { -select => { group_by => |
654 | { |
655 | -op => [ ',', { -ident => [ 'foo' ] }, { -ident => [ 'bar' ] } ] |
656 | } |
657 | } } |
658 | |
659 | # query |
660 | GROUP BY foo, bar |
661 | [] |
662 | |
663 | =head2 having clause for select |
664 | |
665 | Basic expr, just like where, given having is pretty much post-group-by |
666 | where clause: |
667 | |
668 | # expr |
669 | { -select => |
670 | { having => { '>' => [ { -count => { -ident => 'foo' } }, 3 ] } } |
671 | } |
672 | |
673 | # aqt |
674 | { -select => { having => { -op => [ |
675 | '>', { -func => [ 'count', { -ident => [ 'foo' ] } ] }, |
676 | { -bind => [ undef, 3 ] }, |
677 | ] } } } |
678 | |
679 | # query |
680 | HAVING COUNT(foo) > ? |
681 | [ 3 ] |
682 | |
de3eeaea |
683 | =head2 setop clauses |
684 | |
685 | If a select query contains a clause matching any of the setop node types, |
686 | clauses that appear before the setop would in the resulting query are |
687 | gathered together and moved into an inner select node: |
688 | |
689 | # expr |
690 | { -select => { |
691 | _ => '*', |
692 | from => 'foo', |
693 | order_by => 'baz', |
694 | union => |
695 | { |
696 | -select => { _ => '*', from => 'bar', where => { thing => 1 } } |
697 | }, |
698 | where => { thing => 1 }, |
699 | } } |
700 | |
701 | # aqt |
702 | { -select => { |
703 | order_by => { -op => [ ',', { -ident => [ 'baz' ] } ] }, |
704 | setop => { -union => { queries => [ |
705 | { -select => { |
706 | from => { -ident => [ 'foo' ] }, |
707 | select => { -op => [ ',', { -ident => [ '*' ] } ] }, |
708 | where => { -op => [ |
709 | '=', { -ident => [ 'thing' ] }, |
710 | { -bind => [ 'thing', 1 ] }, |
711 | ] }, |
712 | } }, ] }, |
713 | { -select => { |
714 | from => { -ident => [ 'bar' ] }, |
715 | select => { -op => [ ',', { -ident => [ '*' ] } ] }, |
716 | where => { -op => [ |
717 | '=', { -ident => [ 'thing' ] }, |
718 | { -bind => [ 'thing', 1 ] }, |
719 | } }, |
720 | ] } }, |
721 | } } |
722 | |
723 | # query |
724 | (SELECT * FROM foo WHERE thing = ?) UNION ( |
725 | SELECT * FROM bar WHERE thing = ? |
726 | ) |
727 | ORDER BY baz |
728 | [ 1, 1 ] |
729 | |
49dba492 |
730 | =head2 update from clause |
731 | |
732 | Some databases allow an additional FROM clause to reference other tables |
733 | for the data to update; this clause is expanded as a normal from list, check |
734 | your database for what is and isn't allowed in practice. |
735 | |
736 | # expr |
737 | { -update => { |
738 | _ => 'employees', |
739 | from => 'accounts', |
740 | set => { sales_count => { sales_count => { '+' => \1 } } }, |
741 | where => { |
742 | 'accounts.name' => { '=' => \"'Acme Corporation'" }, |
743 | 'employees.id' => { -ident => 'accounts.sales_person' }, |
744 | }, |
745 | } } |
746 | |
747 | # aqt |
748 | { -update => { |
749 | from => { -ident => [ 'accounts' ] }, |
750 | set => { -op => [ |
751 | ',', { -op => [ |
752 | '=', { -ident => [ 'sales_count' ] }, { -op => [ |
753 | '+', { -ident => [ 'sales_count' ] }, |
754 | { -literal => [ 1 ] }, |
755 | ] }, |
756 | ] }, |
757 | ] }, |
758 | target => { -ident => [ 'employees' ] }, |
759 | where => { -op => [ |
760 | 'and', { -op => [ |
761 | '=', { -ident => [ 'accounts', 'name' ] }, |
762 | { -literal => [ "'Acme Corporation'" ] }, |
763 | ] }, { -op => [ |
764 | '=', { -ident => [ 'employees', 'id' ] }, |
765 | { -ident => [ 'accounts', 'sales_person' ] }, |
766 | ] }, |
767 | ] }, |
768 | } } |
769 | |
770 | # query |
771 | UPDATE employees SET sales_count = sales_count + 1 FROM accounts |
772 | WHERE ( |
773 | accounts.name = 'Acme Corporation' |
774 | AND employees.id = accounts.sales_person |
775 | ) |
776 | |
777 | [] |
778 | |
779 | [] |
780 | |
781 | =head2 delete using clause |
782 | |
783 | Some databases allow an additional USING clause to reference other tables |
784 | for the data to update; this clause is expanded as a normal from list, check |
785 | your database for what is and isn't allowed in practice. |
786 | |
787 | # expr |
788 | { -delete => { |
789 | from => 'x', |
790 | using => 'y', |
791 | where => { 'x.id' => { -ident => 'y.x_id' } }, |
792 | } } |
793 | |
794 | # aqt |
795 | { -delete => { |
796 | target => { -op => [ ',', { -ident => [ 'x' ] } ] }, |
797 | using => { -ident => [ 'y' ] }, |
798 | where => { -op => [ |
799 | '=', { -ident => [ 'x', 'id' ] }, |
800 | { -ident => [ 'y', 'x_id' ] }, |
801 | ] }, |
802 | } } |
803 | |
804 | # query |
805 | DELETE FROM x USING y WHERE x.id = y.x_id |
806 | [] |
807 | |
3001f097 |
808 | =cut |