The CData ADO.NET Provider for Tableau CRM Analytics implements two ADO.NET interfaces you can use to retrieve data from Tableau CRM: TableauCRMDataAdapter and TableauCRMDataReader objects. Whereas TableauCRMDataAdapter objects retrieve a single result set of all the data that matches a query, TableauCRMDataReader objects fetch data in subset increments as needed.

Using the TableauCRMDataReader

The TableauCRMDataReader retrieves data faster than the TableauCRMDataAdapter because it can retrieve data in pages. As you read data from the TableauCRMDataReader, it periodically requests the next page of results from the data source, if required. This causes results to be returned at a faster rate. The following example selects all the columns from the Dataset_Opportunity table:

C#

string connectionString = "InitiateOAuth=GETANDREFRESH;OAuthClientId=MyConsumerKey;OAuthClientSecret=MyConsumerSecret;CallbackURL=http://localhost:portNumber";

using (TableauCRMConnection connection = new TableauCRMConnection(connectionString)) {
  TableauCRMCommand cmd = new TableauCRMCommand("SELECT * FROM Dataset_Opportunity", connection);
  
  TableauCRMDataReader rdr = cmd.ExecuteReader();

  while (rdr.Read()) {
    Console.WriteLine(String.Format("\t{0} --> \t\t{1}", rdr["Name"], rdr["CloseDate"]));
  }
}

VB.NET

Dim connectionString As String = "InitiateOAuth=GETANDREFRESH;OAuthClientId=MyConsumerKey;OAuthClientSecret=MyConsumerSecret;CallbackURL=http://localhost:portNumber"

Using connection As New TableauCRMConnection(connectionString)
  Dim cmd As New TableauCRMCommand("SELECT * FROM Dataset_Opportunity", connection)

  Dim rdr As TableauCRMDataReader = cmd.ExecuteReader()

  While rdr.Read()
    Console.WriteLine([String].Format(vbTab & "{0} --> " & vbTab & vbTab & "{1}", rdr("Name"), rdr("CloseDate")))
  End While
End Using