NAME

Rex::Commands::DB - Simple Database Access

DESCRIPTION

This module gives you simple access to a database. Currently select, delete, insert and update is supported.

Version <= 1.0: All these functions will not be reported.

SYNOPSIS

 use Rex::Commands::DB {
                  dsn    => "DBI:mysql:database=test;host=dbhost",
                  user    => "username",
                  password => "password",
                };

 task "list", sub {
   my @data = db select => {
            fields => "*",
            from  => "table",
            where  => "enabled=1",
          };

  db insert => "table", {
           field1 => "value1",
            field2 => "value2",
            field3 => 5,
          };

  db update => "table", {
              set => {
                field1 => "newvalue",
                field2 => "newvalue2",
              },
              where => "id=5",
           };

  db delete => "table", {
            where => "id < 5",
          };

 };

EXPORTED FUNCTIONS

db

Do a database action.

 my @data = db select => {
          fields => "*",
          from  => "table",
          where  => "host='myhost'",
        };

 db insert => "table", {
          field1 => "value1",
          field2 => "value2",
          field3 => 5,
        };

 db update => "table", {
            set => {
              field1 => "newvalue",
              field2 => "newvalue2",
            },
            where => "id=5",
         };

 db delete => "table", {
          where => "id < 5",
        };