lib/SQL/Abstract/Manual/Examples.pod

   1 =head1 NAME
   2
   3 SQL::Abstract::Manual::Specification
   4
   5 =head1 DESCRIPTION
   6
   7 These are the examples for the AST
   8
   9 =head1 EXAMPLES
  10
  11 The following are example SQL statements and the AST that would represent each
  12 one. The SQL used is from the MySQL dialect.
  13
  14 =over 4
  15
  16 =item * SELECT 1
  17
  18   {
  19       type => 'select',
  20       ast_version => 0.0001,
  21       select => [
  22           {
  23               type    => 'Value',
  24               subtype => 'Number',
  25               value   => 1,
  26           },
  27       ],
  28   }
  29
  30 =item * SELECT NOW() AS time FROM dual AS duality
  31
  32   {
  33       type => 'select',
  34       ast_version => 0.0001,
  35       select => [
  36           {
  37               type  => 'Alias',
  38               value => {
  39                   type     => 'Function',
  40                   function => 'NOW',
  41               },
  42               as => {
  43                   type => 'Identifier',
  44                   element1 => 'time',
  45               },
  46           },
  47       ],
  48       tables => {
  49           type => 'Alias',
  50           value => {
  51               type => 'Identifier',
  52               element1 => 'dual',
  53           },
  54           as => {
  55               type => 'Identifier',
  56               element1 => 'duality',
  57           },
  58       },
  59   }
  60
  61 =item * SELECT 1 FROM foo LEFT OUTER JOIN bar ON ( foo.col1 = bar.col2 )
  62
  63   {
  64       type => 'select',
  65       ast_version => 0.0001,
  66       select => [
  67           {
  68               type     => 'Value',
  69               subtype => 'Number',
  70               value   => 1,
  71           },
  72       ],
  73       tables => {
  74           type => 'Operator',
  75           op   => 'LEFT OUTER',
  76           args => [
  77               {
  78                   type => 'Identifier',
  79                   element1 => 'foo',
  80               },
  81               {
  82                   type => 'Identifier',
  83                   element1 => 'bar',
  84               },
  85           ],
  86           on => {
  87               type => 'Operator',
  88               op   => '=',
  89               args => [
  90                   {
  91                       type     => 'Identifier',
  92                       element1 => 'foo',
  93                       element2 => 'col1',
  94                   },
  95                   {
  96                       type     => 'Identifier',
  97                       element1 => 'bar',
  98                       element2 => 'col2',
  99                   },
 100               ],
 101           },
 102       },
 103   }
 104
 105 =item SELECT * FROM foo WHERE name = 'John'
 106
 107   {
 108       type => 'select',
 109       ast_version => 0.0001,
 110       select => [
 111           {
 112               type     => 'Identifier',
 113               element1 => '*',
 114           },
 115       ],
 116       tables => {
 117           type => 'Identifier',
 118           element1 => 'foo',
 119       },
 120       where => {
 121           type => 'Operator',
 122           op   => '=',
 123           args => [
 124               {
 125                   type     => 'Identifier',
 126                   element1 => 'name',
 127               },
 128               {
 129                   type     => 'Value',
 130                   subtype  => 'String',
 131                   element1 => 'John',
 132               },
 133           ],
 134       },
 135   }
 136
 137 =item SELECT COUNT(*) FROM foo WHERE name = 'John' AND ( title = 'Mr' OR abbrev = 'Dr' )
 138
 139   {
 140       type => 'select',
 141       ast_version => 0.0001,
 142       select => [
 143           {
 144               type => 'Operator',
 145               op   => 'COUNT',
 146               args => [
 147                   {
 148                       type     => 'Identifier',
 149                       element1 => '*',
 150                   },
 151               ],
 152           },
 153       ],
 154       tables => {
 155           type => 'Identifier',
 156           element1 => 'foo',
 157       },
 158       where => {
 159           type => 'Operator',
 160           op   => 'AND',
 161           args => [
 162               {
 163                   type => 'Operator',
 164                   op   => '=',
 165                   args => [
 166                       {
 167                           type     => 'Identifier',
 168                           element1 => 'name',
 169                       },
 170                       {
 171                           type     => 'Value',
 172                           subtype  => 'String',
 173                           element1 => 'John',
 174                       },
 175                   ],
 176               },
 177               {
 178                   type => 'Operator',
 179                   op   => 'OR',
 180                   args => [
 181                       {
 182                           type => 'Operator',
 183                           op   => '=',
 184                           args => [
 185                               {
 186                                   type     => 'Identifier',
 187                                   element1 => 'title',
 188                               },
 189                               {
 190                                   type     => 'Value',
 191                                   subtype  => 'String',
 192                                   element1 => 'Mr',
 193                               },
 194                           ],
 195                       },
 196                       {
 197                           type => 'Operator',
 198                           op   => '=',
 199                           args => [
 200                               {
 201                                   type     => 'Identifier',
 202                                   element1 => 'abbrev',
 203                               },
 204                               {
 205                                   type     => 'Value',
 206                                   subtype  => 'String',
 207                                   element1 => 'Dr',
 208                               },
 209                           ],
 210                       },
 211                   ],
 212               },
 213           ],
 214       },
 215   }
 216
 217 =item SELECT COUNT(DISTINCT(*)) FROM foo WHERE ( name = 'John' AND title = 'Mr' ) OR abbrev = 'Dr'
 218
 219   {
 220       type => 'select',
 221       ast_version => 0.0001,
 222       select => [
 223         {
 224               type => 'Operator',
 225               op   => 'COUNT',
 226               args => [
 227                   {
 228                       type => 'Operator',
 229                       op   => 'DISTINCT',
 230                       args => [
 231                           {
 232                               type     => 'Identifier',
 233                               element1 => '*',
 234                           },
 235                       ],
 236                   },
 237               ],
 238           },
 239       ],
 240       tables => {
 241           type => 'Identifier',
 242           element1 => 'foo',
 243       },
 244       where => {
 245           type => 'Operator',
 246           op   => 'OR',
 247           args => [
 248               {
 249                   type => 'Operator',
 250                   op   => 'AND',
 251                   args => [
 252                       {
 253                           type => 'Operator',
 254                           op   => '=',
 255                           args => [
 256                               {
 257                                   type     => 'Identifier',
 258                                   element1 => 'name',
 259                               },
 260                               {
 261                                   type     => 'Value',
 262                                   subtype  => 'String',
 263                                   element1 => 'John',
 264                               },
 265                           ],
 266                       },
 267                       {
 268                           type => 'Operator',
 269                           op   => '=',
 270                           args => [
 271                               {
 272                                   type     => 'Identifier',
 273                                   element1 => 'title',
 274                               },
 275                               {
 276                                   type     => 'Value',
 277                                   subtype  => 'String',
 278                                   element1 => 'Mr',
 279                               },
 280                           ],
 281                       },
 282                   ],
 283               },
 284               {
 285                   type => 'Operator',
 286                   op   => '=',
 287                   args => [
 288                       {
 289                           type     => 'Identifier',
 290                           element1 => 'abbrev',
 291                       },
 292                       {
 293                           type     => 'Value',
 294                           subtype  => 'String',
 295                           element1 => 'Dr',
 296                       },
 297                   ],
 298               },
 299           ],
 300       },
 301   }
 302
 303 =item * SELECT foo, bar baz FROM foo ORDER BY bar, baz DESC GROUP BY 1,3,2
 304
 305   {
 306       type => 'select',
 307       ast_version => 0.0001,
 308       select => [
 309           {
 310               type => 'Identifier',
 311               element1 => 'foo',
 312           },
 313           {
 314               type => 'Identifier',
 315               elements => 'bar',
 316           },
 317           {
 318               type => 'Identifier',
 319               element1 => 'baz',
 320           },
 321       ],
 322       tables => {
 323           type => 'Identifier',
 324           element1 => 'foo',
 325       },
 326       orderby => [
 327           {
 328               type  => 'OrderbyComponent',
 329               value => {
 330                   type => 'Identifier',
 331                   element1 => 'bar',
 332               },
 333               dir => 'ASC',
 334           },
 335           {
 336               type  => 'OrderbyComponent',
 337               value => {
 338                   type => 'Identifier',
 339                   element1 => 'baz',
 340               },
 341               dir => 'DESC',
 342           },
 343       ],
 344       groupby => [
 345           {
 346               type  => 'GroupbyComponent',
 347               value => {
 348                   type => 'Value',
 349                   subtype => 'Number',
 350                   value => 1,
 351               },
 352           },
 353           {
 354               type  => 'GroupbyComponent',
 355               value => {
 356                   type => 'Value',
 357                   subtype => 'Number',
 358                   value => 3,
 359               },
 360           },
 361           {
 362               type  => 'GroupbyComponent',
 363               value => {
 364                   type => 'Value',
 365                   subtype => 'Number',
 366                   value => 2,
 367               },
 368           },
 369       ],
 370   }
 371
 372 =item * UPDATE foo SET col1 = 1
 373
 374   {
 375       type => 'update',
 376       ast_version => 0.0001,
 377       tables => {
 378           type => 'Identifier',
 379           element1 => 'foo',
 380       },
 381       set => [
 382           [
 383               {
 384                   type => 'Identifier,
 385                   element1 => 'col1',
 386               },
 387           ],
 388           [
 389               {
 390                   type => 'Value',
 391                   subtype => 'Number',
 392                   value => 1,
 393               },
 394           ],
 395       ],
 396   }
 397
 398 =item * INSERT INTO foo ( col1, col2 ) VALUES ( 1, 3 )
 399
 400   {
 401       type => 'insert',
 402       ast_version => 0.0001,
 403       tables => {
 404           type => 'Identifier',
 405           element1 => 'foo',
 406       },
 407       set => [
 408           [
 409               {
 410                   type => 'Identifier,
 411                   element1 => 'col1',
 412               },
 413               {
 414                   type => 'Identifier,
 415                   element1 => 'col2',
 416               },
 417           ],
 418           [
 419               {
 420                   type => 'Value',
 421                   subtype => 'Number',
 422                   value => '1',
 423               },
 424               {
 425                   type => 'Value',
 426                   subtype => 'Number',
 427                   value => '3',
 428               },
 429           ],
 430       ],
 431   }
 432
 433 =item * DELETE FROM foo WHERE col1 = 10
 434
 435   {
 436       type => 'delete',
 437       ast_version => 0.0001,
 438       tables => {
 439           type => 'Identifier',
 440           element1 => 'foo',
 441       },
 442       where => {
 443           type => 'Operator',
 444           op   => '=',
 445           args => [
 446               {
 447                   type     => 'Identifier',
 448                   element1 => 'col1',
 449               },
 450               {
 451                   type     => 'Value',
 452                   subtype  => 'Number',
 453                   value => 10,
 454               },
 455           ],
 456       },
 457   }
 458
 459 =item * SELECT * FROM ( SELECT 1 ) AS foo
 460
 461   {
 462       type => 'select',
 463       ast_version => 0.0001,
 464       select => [
 465           {
 466               type => 'Identifier',
 467               element1 => '*',
 468           },
 469       ],
 470       tables => {
 471           type => 'Identifier',
 472           element1 => 'foo',
 473           value => {
 474               type => 'select',
 475               ast_version => 0.0001,
 476               select => [
 477                   {
 478                       type    => 'Value',
 479                       subtype => 'Number',
 480                       value   => 1,
 481                   },
 482               ],
 483           },
 484           as => {
 485               type => 'Identifier',
 486               element1 => 'foo',
 487           },
 488       },
 489   }
 490
 491 =back
 492
 493 =head1 AUTHORS
 494
 495 robkinyon: Rob Kinyon C<< <rkinyon@cpan.org> >>
 496
 497 =head1 LICENSE
 498
 499 You may distribute this code under the same terms as Perl itself.
 500
 501 =cut