The CData ADO.NET Provider for IBM Cloud Data Engine implements two ADO.NET interfaces you can use to retrieve data from IBM Cloud Data Engine: IBMCloudSQLQueryDataAdapter and IBMCloudSQLQueryDataReader objects. Whereas IBMCloudSQLQueryDataAdapter objects retrieve a single result set of all the data that matches a query, IBMCloudSQLQueryDataReader objects fetch data in subset increments as needed.

Using the IBMCloudSQLQueryDataAdapter

Use the adapter's Fill method to retrieve data from the data source. An empty DataTable instance is passed as an argument to the Fill method. When the method returns, the DataTable instance is populated with the queried data. Note that the IBMCloudSQLQueryDataAdapter is slower than the IBMCloudSQLQueryDataReader because the Fill method needs to retrieve all data from the data source before returning.

The following example selects the Id and Status columns of the Jobs table:

C#

string connectionString = "Api Key=MyAPIKey;";

using (IBMCloudSQLQueryConnection connection = new IBMCloudSQLQueryConnection(connectionString)) {
  IBMCloudSQLQueryDataAdapter dataAdapter = new IBMCloudSQLQueryDataAdapter(
  "SELECT Id, Status FROM [CloudObjectStorage_1].[SampleBucket_1].Jobs", connection);

  DataTable table = new DataTable();
  dataAdapter.Fill(table);

  Console.WriteLine("Contents of Jobs.");

  foreach (DataRow row in table.Rows) {
    Console.WriteLine("{0}: {1}", row["Id"], row["Status"]);
  }
}

VB.NET

Dim connectionString As String = "Api Key=MyAPIKey;"

Using connection As New IBMCloudSQLQueryConnection(connectionString)
  Dim dataAdapter As New IBMCloudSQLQueryDataAdapter("SELECT Id, Status FROM [CloudObjectStorage_1].[SampleBucket_1].Jobs", connection)

  Dim table As New DataTable()
  dataAdapter.Fill(table)

  Console.WriteLine("Contents of Jobs.")

  For Each row As DataRow In table.Rows
    Console.WriteLine("{0}: {1}", row("Id"), row("Status"))
  Next
End Using