https://github.com/songmu/p5-sql-maker-plugin-joinselect

https://github.com/songmu/p5-sql-maker-plugin-joinselect

Last synced: 2 days ago
JSON representation

• Host: GitHub
• URL: https://github.com/songmu/p5-sql-maker-plugin-joinselect
• Owner: Songmu
• License: other
• Created: 2013-06-24T06:30:29.000Z (over 11 years ago)
• Default Branch: master
• Last Pushed: 2013-07-09T03:23:14.000Z (over 11 years ago)
• Last Synced: 2024-10-11T21:09:34.048Z (27 days ago)
• Language: Perl
• Size: 137 KB
• Stars: 0
• Watchers: 3
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: Changes
  • License: LICENSE

Awesome Lists containing this project

README

        
# NAME

SQL::Maker::Plugin::JoinSelect - Plugin of SQL::Maker for making SQL contained \`JOIN\`

# SYNOPSIS

    use SQL::Maker;

    SQL::Maker->load_plugin('JoinSelect');

    my $builder = SQL::Maker->new(driver => 'SQLite', new_line => ' ');

    my ($sql, @binds) = $builder->join_select(

        user => [

            item => 'user.id = item.user_id',

        ],

        ['*'],

        {

            'user.id' => 1,

        },

    );

    print $sql; #=> 'SELECT * FROM "user" INNER JOIN "item" ON user.id = item.user_id WHERE ("user"."id" = ?)';

# DESCRIPTION

SQL::Maker::Plugin::JoinSelect is Plugin of SQL::Maker for making SQL contained \`JOIN\`.

# INTERFACE

## Method

### `($sql, @binds) = $sql_maker->join_select($table, $join_conds, \@fields, \%where, \%opt)`

`$table`, `\@fields`, `\%where` and `\%opt` are same as arguments of `$sql_maker->select`.

`$join_conds` is an ArrayRef containing sequenced pair of `$table` and `$join_cond` as follows.

    [

        'user_item' => {'user.id' => 'user_item.user_id'},

        'item'      => 'user_item.item_id => item.id',

        ...

    ]

Each `$join_cond` can be ArrayRef, HashRef and String same as condition argument of [SQL::Maker::Select](http://search.cpan.org/perldoc?SQL::Maker::Select)'s `add_join` method.

Join type is 'inner' by default. If you want to specify join type, you can use ArrayRef like follows.

    [

        'item' => ['outer' => {'user.id' => 'item.user_id'}],

    ]

# LICENSE

Copyright (C) Masayuki Matsuki.

This library is free software; you can redistribute it and/or modify

it under the same terms as Perl itself.

# AUTHOR

Masayuki Matsuki