dbix::class::storage::dbi::ado::microsoft_sql_server::cursor(3) [osx man page]

DBIx::Class::Storage::DBI::ADO::Microsoft_SQL_Server::CuUser(Contributed Perl DocumDBIx::Class::Storage::DBI::ADO::Microsoft_SQL_Server::Cursor(3)

NAME

       DBIx::Class::Storage::DBI::ADO::Microsoft_SQL_Server::Cursor - Remove trailing NULLs in binary data and normalize GUIDs for MSSQL over ADO

DESCRIPTION

       This class is for removing trailing "NULL"s from binary data and removing braces from GUIDs retrieved from Microsoft SQL Server over ADO.

       You probably don't want to be here, see DBIx::Class::Storage::DBI::ADO::Microsoft_SQL_Server for information on the Microsoft SQL Server
       driver for ADO and DBIx::Class::Storage::DBI::MSSQL for the Microsoft SQL Server driver base class.

       Unfortunately when using DBD::ADO, binary data comes back padded with trailing "NULL"s and GUIDs come back wrapped in braces, the purpose
       of this class is to remove the "NULL"s and braces.  DBIx::Class::Storage::DBI::ADO::Microsoft_SQL_Server sets cursor_class to this class by
       default. It is overridable via your connect_info.

       You can use DBIx::Class::Cursor::Cached safely with this class and not lose the binary data normalizing functionality, ::Cursor::Cached
       uses the underlying class data for the inner cursor class.

AUTHOR

       See "AUTHOR" in DBIx::Class and "CONTRIBUTORS" in DBIx::Class.

LICENSE

       You may distribute this code under the same terms as Perl itself.

perl v5.16.2							    2012-08-23	   DBIx::Class::Storage::DBI::ADO::Microsoft_SQL_Server::Cursor(3)

DBIx::Class::Storage::DBI::ADO::Microsoft_SQL_Server(3) User Contributed Perl DocumentationDBIx::Class::Storage::DBI::ADO::Microsoft_SQL_Server(3)

NAME

       DBIx::Class::Storage::DBI::ADO::Microsoft_SQL_Server - Support for Microsoft SQL Server via DBD::ADO

SYNOPSIS

       This subclass supports MSSQL server connections via DBD::ADO.

DESCRIPTION

       The MSSQL specific functionality is provided by DBIx::Class::Storage::DBI::MSSQL.

EXAMPLE DSN

	 dbi:ADO:provider=sqlncli10;server=EEEBOXSQLEXPRESS

CAVEATS

   identities
       "_identity_method" is set to @@identity, as "SCOPE_IDENTITY()" doesn't work with DBD::ADO. See "IMPLEMENTATION NOTES" in
       DBIx::Class::Storage::DBI::MSSQL for caveats regarding this.

   truncation bug
       There is a bug with MSSQL ADO providers where data gets truncated based on the size of the bind sizes in the first prepare call:

       <https://rt.cpan.org/Ticket/Display.html?id=52048>

       The "ado_size" workaround is used (see "ADO Providers" in DBD::ADO) with the approximate maximum size of the data_type of the bound column,
       or 8000 (maximum VARCHAR size) if the data_type is not available.

       Please report problems with this driver and send patches.

   LongReadLen
       "LongReadLen" is set to "LongReadLen * 2 + 1" on connection as it is necessary for some LOB types. Be aware of this if you localize this
       value on the $dbh directly.

   binary data
       Due perhaps to the ado_size workaround we use, and/or other reasons, binary data such as "varbinary" column data comes back padded with
       trailing "NULL" chars.  The Cursor class for this driver (DBIx::Class::Storage::DBI::ADO::Microsoft_SQL_Server::Cursor) removes them, of
       course if your binary data is actually "NULL" padded that may be an issue to keep in mind when using this driver.

   uniqueidentifier columns
       uniqueidentifier columns come back from ADO wrapped in braces and must be submitted to the MSSQL ADO driver wrapped in braces. We take care
       of this transparently in this driver and the associated Cursor class (DBIx::Class::Storage::DBI::ADO::Microsoft_SQL_Server::Cursor) so that
       you don't have to use braces in most cases (except in literal SQL, in those cases you will have to add the braces yourself.)

   fractional seconds
       Fractional seconds with DBIx::Class::InflateColumn::DateTime are not currently supported, datetimes are truncated at the second.

AUTHOR

       See "AUTHOR" in DBIx::Class and "CONTRIBUTORS" in DBIx::Class.

LICENSE

       You may distribute this code under the same terms as Perl itself.

perl v5.16.2							    2012-08-23		   DBIx::Class::Storage::DBI::ADO::Microsoft_SQL_Server(3)