Skip to content

Releases: r-dbi/DBI

v0.7

18 Jun 22:05
Compare
Choose a tag to compare
  • Import updated specs from DBItest.
  • The default implementation of dbGetQuery() now accepts an n
    argument and forwards it to dbFetch(). No warning about pending rows
    is issued anymore (#76).
  • Require R >= 3.0.0 (for slots argument of setClass()) (#169,
    @mvkorpel).

v0.6-1

02 Apr 07:49
Compare
Choose a tag to compare
  • Fix dbReadTable() for backends that do not provide their own impl…
    …ementation (#171).

v0.6

10 Mar 08:43
Compare
Choose a tag to compare
  • Interface changes

    • Deprecated dbDriver() and dbUnloadDriver() by documentation (#21).
    • Renamed arguments to sqlInterpolate() and sqlParseVariables() to be more consistent with the rest of the interface, and added .dots argument to sqlParseVariables. DBI drivers are now expected to implement sqlParseVariables(conn, sql, ..., .dots) and sqlInterpolate(conn, sql, ...) (#147).
  • Interface enhancements

    • Removed valueClass = "logical" for those generics where the return value is meaningless, to allow backends to return invisibly (#135).
    • Avoiding using braces in the definitions of generics if possible, so that standard generics can be detected (#146).
    • Added default implementation for dbReadTable().
    • All standard generics are required to have an ellipsis (with test), for future extensibility. - Improved default implementation of dbQuoteString() and dbQuoteIdentifier() (#77).
    • Removed tryCatch() call in dbGetQuery() (#113).
  • Documentation improvements

    • Finalized first draft of DBI specification, now in a vignette.
    • Most methods now draw documentation from DBItest, only those where the behavior is not finally decided don't do this yet yet.
    • Removed max.connections requirement from documentation (#56).
    • Improved dbBind() documentation and example (#136).
    • Change omegahat.org URL to omegahat.net, the particular document still doesn't exist below the new domain.
  • Internal

    • Use roxygen2 inheritance to copy DBI specification to this package.
    • Use tic package for building documentation.
    • Use markdown in documentation.

v0.5-1

17 Sep 13:32
Compare
Choose a tag to compare
  • Documentation and example updates.

v0.5

11 Aug 19:46
Compare
Choose a tag to compare
  • Interface changes
    • dbDataType() maps character values to "TEXT" by default (#102).
    • The default implementation of dbQuoteString() doesn't call encodeString() anymore: Neither SQLite nor Postgres understand e.g. \n in a string literal, and all of SQLite, Postgres, and MySQL accept an embedded newline (#121).
  • Interface enhancements
    • New dbSendStatement() generic, forwards to dbSendQuery() by default (#20, #132).
    • New dbExecute(), calls dbSendStatement() by default (#109, @bborgesr).
    • New dbWithTransaction() that calls dbBegin() and dbCommit(), and dbRollback() on failure (#110, @bborgesr).
    • New dbBreak() function which allows aborting from within dbWithTransaction() (#115, #133).
    • Export dbFetch() and dbQuoteString() methods.
  • Documentation improvements:
    • One example per function (except functions scheduled for deprecation) (#67).
    • Consistent layout and identifier naming.
    • Better documentation of generics by adding links to the class and related generics in the "See also" section under "Other DBI... generics" (#130). S4 documentation is directed to a hidden page to unclutter documentation index (#59).
    • Fix two minor vignette typos (#124, @mdsumner).
    • Add package documentation.
    • Remove misleading parts in dbConnect() documentation (#118).
    • Remove misleading link in dbDataType() documentation.
    • Remove full stop from documentation titles.
    • New help topic "DBIspec" that contains the full DBI specification (currently work in progress) (#129).
    • HTML documentation generated by staticdocs is now uploaded to http://rstats-db.github.io/DBI for each build of the "production" branch (#131).
    • Further minor changes and fixes.
  • Internal
    • Use contains argument instead of representation() to denote base classes (#93).
    • Remove redundant declaration of transaction methods (#110, @bborgesr).

v0.4-1

08 May 10:31
Compare
Choose a tag to compare
  • The default show() implementations silently ignore all errors. Some DBI drivers (e.g., RPostgreSQL) might fail to implement dbIsValid() or the other methods used.

v0.4

02 May 20:08
Compare
Choose a tag to compare
  • New package maintainer: Kirill Müller.
  • dbGetInfo() gains a default method that extracts the information from
    dbGetStatement(), dbGetRowsAffected(), dbHasCompleted(), and
    dbGetRowCount(). This means that most drivers should no longer need to
    implement dbGetInfo() (which may be deprecated anyway at some point) (#55).
  • dbDataType() and dbQuoteString() are now properly exported.
  • The default implementation for dbDataType() (powered by dbiDataType()) now
    also supports difftime and AsIs objects and lists of raw (#70).
  • Default dbGetQuery() method now always calls dbFetch(), in a tryCatch()
    block.
  • New generic dbBind() for binding values to a parameterised query.
  • DBI gains a number of SQL generation functions. These make it easier to
    write backends by implementing common operations that are slightly
    tricky to do absolutely correctly.
    • sqlCreateTable() and sqlAppendTable() create tables from a data
      frame and insert rows into an existing table. These will power most
      implementations of dbWriteTable(). sqlAppendTable() is useful
      for databases that support parameterised queries.
    • sqlRownamesToColumn() and sqlColumnToRownames() provide a standard
      way of translating row names to and from the database.
    • sqlInterpolate() and sqlParseVariables() allows databases without
      native parameterised queries to use parameterised queries to avoid
      SQL injection attacks.
    • sqlData() is a new generic that converts a data frame into a data
      frame suitable for sending to the database. This is used to (e.g.)
      ensure all character vectors are encoded as UTF-8, or to convert
      R varible types (like factor) to types supported by the database.
    • The sqlParseVariablesImpl() is now implemented purely in R, with full
      test coverage (#83, @hannesmuehleisen).
  • dbiCheckCompliance() has been removed, the functionality is now available
    in the DBItest package (#80).
  • Added default show() methods for driver, connection and results.
  • New concrete ANSIConnection class and ANSI() function to generate a dummy
    ANSI compliant connection useful for testing.
  • Default dbQuoteString() and dbQuoteIdentifer() methods now use
    encodeString() so that special characters like \n are correctly escaped.
    dbQuoteString() converts NA to (unquoted) NULL.
  • The initial DBI proposal and DBI version 1 specification are now included as
    a vignette. These are there mostly for historical interest.
  • The new DBItest package is described in the vignette.
  • Deprecated print.list.pairs().
  • Removed unused dbi_dep().

DBI 0.3.1

24 Sep 11:34
Compare
Choose a tag to compare
  • Actually export dbIsValid() :/
  • dbGetQuery() uses dbFetch() in the default implementation.

DBI 0.3

02 Sep 21:09
Compare
Choose a tag to compare

New and enhanced generics

  • dbIsValid() returns a logical value describing whether a connection or
    result set (or other object) is still valid. (#12).
  • dbQuoteString() and dbQuoteIdentifier() to implement database specific
    quoting mechanisms.
  • dbFetch() added as alias to fetch() to provide consistent name.
    Implementers should define methods for both fetch() and dbFetch() until
    fetch() is deprecated in 2015. For now, the default method for dbFetch()
    calls fetch().
  • dbBegin() begins a transaction (#17). If not supported, DB specific
    methods should throw an error (as should dbCommit() and dbRollback()).

New default methods

  • dbGetStatement(), dbGetRowsAffected(), dbHasCompleted(), and
    dbGetRowCount() gain default methods that extract the appropriate elements
    from dbGetInfo(). This means that most drivers should no longer need to
    implement these methods (#13).
  • dbGetQuery() gains a default method for DBIConnection which uses
    dbSendQuery(), fetch() and dbClearResult().

Deprecated features

  • The following functions are soft-deprecated. They are going away,
    and developers who use the DBI should begin preparing. The formal deprecation
    process will begin in July 2015, where these function will emit warnings
    on use.
    • fetch() is replaced by dbFetch().
    • make.db.names(), isSQLKeyword() and SQLKeywords(): a black list
      based approach is fundamentally flawed; instead quote strings and
      identifiers with dbQuoteIdentifier() and dbQuoteString().
  • dbGetDBIVersion() is deprecated since it's now just a thin wrapper
    around packageVersion("DBI").
  • dbSetDataMappings() (#9) and dbCallProc() (#7) are deprecated as no
    implementations were ever provided.

Other improvements

  • dbiCheckCompliance() makes it easier for implementors to check that their
    package is in compliance with the DBI specification.
  • All examples now use the RSQLite package so that you can easily try out
    the code samples (#4).
  • dbDriver() gains a more effective search mechanism that doesn't rely on
    packages being loaded (#1).
  • DBI has been converted to use roxygen2 for documentation, and now most
    functions have their own documentation files. I would love your feedback
    on how we could make the documentation better!