Processando resultados (provedor OLE DB do cliente nativo)

  • Artigo

Aplica-se a: SQL Server Banco de Dados SQL do Azure Instância Gerenciada de SQL do Azure PDW (Sistema de Plataforma de Análise) do Azure Synapse Analytics

Caso um objeto de conjunto de linhas seja produzido pela execução de um comando ou pela geração direta de um objeto de conjunto de linhas no provedor, o consumidor precisa recuperar e acessar dados no conjunto de linhas.

Os conjuntos de linhas são os objetos centrais que permitem que o provedor OLE DB do SQL Server Native Client exponha dados em formato tabular. Conceitualmente, um conjunto de linhas é um conjunto de linhas em que cada linha tem dados de coluna. Um objeto de conjunto de linhas expõe interfaces como IRowset (contém métodos para buscar linhas no conjunto sequencialmente), IAccessor (permite a definição de um grupo de associações de coluna que descrevem a forma como dados tabulares são associados a variáveis de programa do consumidor), IColumnsInfo (fornece informações sobre colunas no conjunto de linhas) e IRowsetInfo (fornece informações sobre o conjunto de linhas).

Um consumidor pode chamar o método IRowset::GetData para recuperar uma linha de dados do conjunto de linhas em um buffer. Antes de GetData ser chamado, o consumidor descreve o buffer usando um conjunto de estruturas DBBINDING. Cada associação descreve como uma coluna em um conjunto de linhas é armazenada em um buffer de consumidor e contém o seguinte:

  • Ordinal da coluna (ou parâmetro) a que a associação se aplica.

  • Informações sobre a associação (por exemplo, valor de dados, comprimento dos dados e o status da associação).

  • Informações sobre o que é deslocado no buffer para cada uma das partes.

  • Comprimento e tipo dos valores de dados como se apresentam no buffer de consumidor.

Ao obter os dados, o provedor usa informações de cada associação para determinar onde e como recuperar dados do buffer de consumidor. Ao definir dados no buffer de consumidor, o provedor usa informações de cada associação para determinar onde e como retornar dados no buffer.

Depois que as estruturas DBBINDING são especificadas, um acessador é criado (IAccessor::CreateAccessor). Um acessador é uma coleção de associações, sendo usado para obter ou definir os dados no buffer de consumidor.

Confira também

Criando um aplicativo provedor OLE DB do SQL Server Native Client
Tópicos de instruções do OLE DB