Prepare to implement a data processing extension

Before you implement your SQL Server Reporting Services data processing extension, you should define the interfaces to implement. You might want to provide extension-specific implementations of the entire set of interfaces, or you might want to focus your implementation on a subset, such as the IDataReader and IDbCommand interfaces in which clients would interact primarily with a result set as a DataReader object and would use your SSRS data processing extension as a bridge between the result set and your data source.

You can implement data processing extensions in one of two ways:

  • Your data processing extension classes can implement the Microsoft .NET Framework data provider interfaces and optionally the extended data processing extension interfaces provided by Reporting Services.

  • Your data processing extension classes can implement the data processing extension interfaces provided by Reporting Services and optionally the extended data processing extension interfaces.

If your Reporting Services data processing extension doesn't support a particular property or method, implement the property or method as no-operation. If a client expects a particular behavior, throw a NotSupportedException exception.

Note

A no-operation implementation of a property or method only applies to the properties and methods of those interfaces that you choose to implement. Optional interfaces that you choose not to implement should be left out of your data processing extension assembly. For more information about whether an interface is required or optional, see the table later in this section.

Required extension functionality

Each Reporting Services data processing extension must provide the following functionality:

  • Open a connection to a data source.

  • Analyze a query and return a list of field names for the result set.

  • Execute a query against the data source and return a row set.

  • Pass single-valued parameters to the query.

  • Iterate through rows in the row set and retrieve data.

Each data processing extension can be extended to include the following functionality:

  • Analyze a query and return a list of parameter names used in the query.

  • Analyze a query and return the list of fields by which the query is grouped.

  • Analyze a query and return the list of fields by which the query is sorted.

  • Provide a user name and password to connect to the data source that is independent of the connection string.

  • Iterate through rows in the row set and retrieve auxiliary metadata about the data values.

  • Aggregate data at the server.

Available extension interfaces

The following table describes the available interfaces and whether implementation is required or optional.

Interface Description Implementation
IDbConnection Represents a unique session with a data source. In a client/server database system, the session might be equivalent to a network connection to the server. Required
IDbConnectionExtension Represents more connection properties that can be implemented by SSRS data processing extensions regarding security and authentication. Optional
IDbTransaction Represents a local transaction. Required
IDbTransactionExtension Represents more transaction properties that can be implemented by SSRS data processing extensions. Optional
IDbCommand Represents a query or command that is used when connected to a data source. Required
IDbCommandAnalysis Represents more command information for analyzing a query and returning a list of parameter names used in the query. Optional
IDataParameter Represents a parameter or name/value pair that is passed to a command or query. Required
IDataParameterCollection Represents a collection of all parameters relevant to a command or query. Required
IDataReader Provides a method of reading a forward-only, read-only stream of data from your data source. Required
IDataReaderExtension Provides a method of reading one or more forward-only streams of result sets, obtained by executing a command at a data source. This interface provides greater support for field aggregates. Optional
IExtension Provides the base class for a Reporting Services data processing extension. Also enables an implementer to include a localized name for the extension and to pass configuration settings from the configuration file to the extension. Required

The data processing extension interfaces are identical to a subset of the .NET Framework data provider interfaces, methods, and properties whenever possible. For more information about implementing a full .NET Framework data provider, see "Implementing a .NET Framework Data Provider" in your .NET Framework Software Development Kit (SDK) documentation.