-- connect to a SQLite database
   -- no user/password needed (if they are supplied they will just be *ignored*)
   -- will create the DB file if it does not exist
   -- NOTE: SQLite has no concept of user accounts, and relies on the file system for security
   --       It is possible to recompile MySQL to include user account security, see
   --       http://www.sqlite.org/src/doc/trunk/ext/userauth/user-auth.txt
   conn = db.connect{
      api = db.SQLITE,
      name = 'test',
      live = true
   }
      
   -- connect to a MySQL database
   -- requires user and password (both can be empty string if anonymous logon is enabled)
   -- NOTE: MySQL has the option for an "anonymous" login (analogous to anonymous FTP), 
   --       which uses blank/empty user and password as logon credentials. Be aware that this
   --       option is not always available as it may be disabled by the system administrator.
   conn = db.connect{
      api = db.MY_SQL,
      name = 'test',
      user = 'MyUser',
      password = 'SecretPassword',
      live = true
   }
   
   -- connect to a Microsoft SQL Server database
   -- requires user and password (when both are empty Windows integrated security is used)
   -- NOTE: You can use the "Guest" user account (disabled by default) to grant "anonymous"
   --       access in SQL Server. Alternatively for integrated security you could grant 
   --       access to the "Everyone" group (all users including Guest), or the 
   --       "Authenticated Users" group (all users excluding Guest). Speak to your system
   --       administrator for more information.
   conn = db.connect{
      api = db.SQL_SERVER,
      name = 'Test',
      user = 'MyUser',
      password = 'SecretPassword',
      live = true
   }
   
   -- connect to an Oracle database with OCI
   -- requires user and password (password can be blank)
   -- NOTE: Oracle has a ANONYMOUS user (disabled by default) that can be used for HTTP
   --       access. Alternatively you could create user like "Guest" (or other name)
   --       with a blank password. You can also use external authentication to enable 
   --       Windows integrated security - which means you could use the "Everyone" or 
   --       "Authenticated Users' group (exactly like you can for SQL Server above).
   --       Speak to your system administrator for more information
   conn = db.connect{
      api = db.ORACLE_OCI,
      name = 'Test',
      user = 'MyUser',
      password = 'SecretPassword',
      live = true
   }

   -- connect to an Oracle database with ODBC
   -- requires user and password (password can be blank)
   -- NOTE: Oracle has a ANONYMOUS user (disabled by default) that can be used for HTTP
   --       access. Alternatively you could create user like "Guest" (or other name)
   --       with a blank password. You can also use external authentication to enable 
   --       Windows integrated security - which means you could use the "Everyone" or 
   --       "Authenticated Users' group (exactly like you can for SQL Server above).
   --       Speak to your system administrator for more information
   conn = db.connect{
      api = db.ORACLE_ODBC,
      name = 'Test',
      user = 'MyUser',
      password = 'SecretPassword',
      live = true
   }