Conjuntos de linhas e cursores do SQL Server (provedor OLE DB do cliente nativo)
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
O SQL Server retorna conjuntos de resultados para clientes usando dois métodos:
Conjuntos de resultados padrão que:
Minimizam sobrecarga.
Proporcionam desempenho máximo na busca de dados.
Oferecem suporte à funcionalidade de cursor apenas de encaminhamento e somente leitura.
Retornam linhas para o consumidor uma linha por vez.
Oferecem suporte a apenas uma instrução ativa por vez em uma conexão.
Após a execução de uma instrução, nenhuma outra pode ser executada na conexão até que todos os resultados sejam recuperados pelo cliente ou a instrução seja cancelada.
Oferecem suporte a todas as instruções Transact-SQL.
Cursores de servidor que:
Oferecem suporte a toda a funcionalidade de cursor.
Podem retornar blocos de linhas para o consumidor.
Oferecem suporte a várias instruções ativas em uma única conexão.
Equilibram a funcionalidade de cursor em relação ao desempenho.
O suporte à funcionalidade de cursor pode diminuir o desempenho em relação a um conjunto de resultados padrão. Isso pode ser compensado caso o consumidor possa usar a funcionalidade de cursor para recuperar um conjunto menor de linhas.
Não oferecem suporte a nenhuma instrução Transact-SQL que retorna mais do que um único conjunto de resultados.
Os consumidores podem solicitar diversos comportamentos de cursor em um conjunto de linhas definindo determinadas propriedades de conjunto de linhas. Se o consumidor não definir nenhuma dessas propriedades de conjunto de linhas ou definir todas elas com seus valores padrão, o provedor OLE DB do SQL Server Native Client implementará o conjunto de linhas usando um conjunto de resultados padrão. Se qualquer uma dessas propriedades for definida como um valor diferente do padrão, o provedor OLE DB do SQL Server Native Client implementará o conjunto de linhas usando um cursor de servidor.
As propriedades do conjunto de linhas a seguir direcionam o provedor OLE DB do SQL Server Native Client para usar cursores do SQL Server. Algumas propriedades podem ser tranquilamente combinadas com outras. Por exemplo, um conjunto de linhas que exibe as propriedades DBPROP_IRowsetScroll e DBPROP_IRowsetChange será um conjunto de linhas indicador que exibe um comportamento de atualização imediato. Outras propriedades são mutuamente excludentes. Por exemplo, um conjunto de linhas que exibe DBPROP_OTHERINSERT não pode conter indicadores.
| ID da propriedade | Valor | Comportamento do conjunto de linhas |
|---|---|---|
| DBPROP_SERVERCURSOR | VARIANT_TRUE | Não é possível atualizar os dados do SQL Server no conjunto de linhas. O conjunto de linhas é sequencial, o que oferece suporte apenas ao roll-forward e à busca. Há suporte para o posicionamento de linha relativo. O texto do comando pode conter uma cláusula ORDER BY. |
| DBPROP_CANSCROLLBACKWARDS ou DBPROP_CANFETCHBACKWARDS | VARIANT_TRUE | Não é possível atualizar os dados do SQL Server no conjunto de linhas. O conjunto de linhas oferece suporte à rolagem e à busca em qualquer direção. Há suporte para o posicionamento de linha relativo. O texto do comando pode conter uma cláusula ORDER BY. |
| DBPROP_BOOKMARKS ou DBPROP_LITERALBOOKMARKS | VARIANT_TRUE | Não é possível atualizar os dados do SQL Server no conjunto de linhas. O conjunto de linhas é sequencial, o que oferece suporte apenas ao roll-forward e à busca. Há suporte para o posicionamento de linha relativo. O texto do comando pode conter uma cláusula ORDER BY. |
| DBPROP_OWNUPDATEDELETE ou DBPROP_OWNINSERT ou DBPROP_OTHERUPDATEDELETE | VARIANT_TRUE | Não é possível atualizar os dados do SQL Server no conjunto de linhas. O conjunto de linhas oferece suporte à rolagem e à busca em qualquer direção. Há suporte para o posicionamento de linha relativo. O texto do comando pode conter uma cláusula ORDER BY. |
| DBPROP_OTHERINSERT | VARIANT_TRUE | Não é possível atualizar os dados do SQL Server no conjunto de linhas. O conjunto de linhas oferece suporte à rolagem e à busca em qualquer direção. Há suporte para o posicionamento de linha relativo. O texto do comando pode incluir uma cláusula ORDER BY caso haja um índice nas colunas referenciadas. DBPROP_OTHERINSERT não pode ser VARIANT_TRUE caso o conjunto de linhas contenha indicadores. Tentar criar um conjunto de linhas com essa propriedade de visibilidade e indicadores causa um erro. |
| DBPROP_IRowsetLocate ou DBPROP_IRowsetScroll | VARIANT_TRUE | Não é possível atualizar os dados do SQL Server no conjunto de linhas. O conjunto de linhas oferece suporte à rolagem e à busca em qualquer direção. Há suporte para indicadores e posicionamento absoluto por meio da interface IRowsetLocate no conjunto de linhas. O texto do comando pode conter uma cláusula ORDER BY. DBPROP_IRowsetLocate e DBPROP_IRowsetScroll exigem marcadores no conjunto de linhas. Tentar criar um conjunto de linhas com indicadores e DBPROP_OTHERINSERT definidos como VARIANT_TRUE causa um erro. |
| DBPROP_IRowsetChange ou DBPROP_IRowsetUpdate | VARIANT_TRUE | É possível atualizar os dados do SQL Server por meio do conjunto de linhas. O conjunto de linhas é sequencial, o que oferece suporte apenas ao roll-forward e à busca. Há suporte para o posicionamento de linha relativo. Todos os comandos que oferecem suporte a cursores atualizáveis podem oferecer suporte a essas interfaces. |
| DBPROP_IRowsetLocate ou DBPROP_IRowsetScroll e DBPROP_IRowsetChange ou DBPROP_IRowsetUpdate | VARIANT_TRUE | É possível atualizar os dados do SQL Server por meio do conjunto de linhas. O conjunto de linhas oferece suporte à rolagem e à busca em qualquer direção. Há suporte para indicadores e posicionamento absoluto por meio de IRowsetLocate no conjunto de linhas. O texto do comando pode conter uma cláusula ORDER BY. |
| DBPROP_IMMOBILEROWS | VARIANT_FALSE | Não é possível atualizar os dados do SQL Server no conjunto de linhas. O conjunto de linhas oferece suporte apenas a roll-forward. Há suporte para o posicionamento de linha relativo. O texto do comando pode incluir uma cláusula ORDER BY caso haja um índice nas colunas referenciadas. DBPROP_IMMOBILEROWS só está disponível em conjuntos de linhas capazes de mostrar linhas do SQL Server inseridas por comandos em outras sessões ou por outros usuários. Tentar abrir um conjunto de linhas com a propriedade definida como VARIANT_FALSE em qualquer conjunto de linhas em que DBPROP_OTHERINSERT não pode ser VARIANT_TRUE causa um erro. |
| DBPROP_REMOVEDELETED | VARIANT_TRUE | Não é possível atualizar os dados do SQL Server no conjunto de linhas. O conjunto de linhas oferece suporte apenas a roll-forward. Há suporte para o posicionamento de linha relativo. O texto do comando pode conter uma cláusula ORDER BY, exceto quando restrito por outra propriedade. |
Um conjunto de linhas do provedor OLE DB do SQL Server Native Client com suporte de um cursor de servidor pode ser facilmente criado em uma tabela base ou exibição do SQL Server usando o método IOpenRowset::OpenRowset . Especifique a tabela ou a exibição por nome, passando os conjuntos de propriedades do conjunto de linhas necessários no parâmetro rgPropertySets.
O texto do comando que cria um conjunto de linhas é restringido quando o consumidor exige que haja suporte ao conjunto por um cursor de servidor. Mais especificamente, o texto do comando é restringido a uma única instrução SELECT que retorna um único resultado do conjunto de linhas ou um procedimento armazenado que implementa uma única instrução SELECT que retorna um único resultado do conjunto de linhas.
Essas duas tabelas mostram os mapeamentos de várias propriedades OLE DB e os modelos de cursor. Elas também mostram as propriedades do conjunto de linhas que devem ser definidas para usar um determinado tipo de modelo de cursor.
Cada célula na tabela contém um valor da propriedade do conjunto de linhas para o modelo de cursor específico. O tipo de dados de todas as propriedades do conjunto de linhas listado anteriormente neste tópico é VT_BOOL e o valor padrão, VARIANT_FALSE. Os seguintes símbolos são usados na tabela.
F = valor padrão (VARIANT_FALSE)
T = VARIANT_TRUE
- = VARIANT_TRUE ou VARIANT_FALSE
Para usar um determinado tipo de modelo de cursor, localize a coluna correspondente ao modelo de cursor e encontre todas as propriedades do conjunto de linhas com o valor 'T' na coluna. Defina essas propriedades do conjunto de linhas como VARIANT_TRUE para usar o modelo de cursor específico. As propriedades do conjunto de linhas com '-' como um valor podem ser definidas como VARIANT_TRUE ou VARIANT_FALSE.
| Propriedades do conjunto de linhas/modelos de cursor | Padrão result set (RO) |
Rápido avanço rápido (RO) |
Estático (RO) |
Keyset por conjunto de chaves (RO) |
|---|---|---|---|---|
| DBPROP_SERVERCURSOR | F | T | T | T |
| DBPROP_DEFERRED | F | F | - | - |
| DBPROP_IrowsetChange | F | F | F | F |
| DBPROP_IrowsetLocate | F | F | - | - |
| DBPROP_IrowsetScroll | F | F | - | - |
| DBPROP_IrowsetUpdate | F | F | F | F |
| DBPROP_BOOKMARKS | F | F | - | - |
| DBPROP_CANFETCHBACKWARDS | F | F | - | - |
| DBPROP_CANSRCOLLBACKWARDS | F | F | - | - |
| DBPROP_CANHOLDROWS | F | F | - | - |
| DBPROP_LITERALBOOKMARKS | F | F | - | - |
| DBPROP_OTHERINSERT | F | T | F | F |
| DBPROP_OTHERUPDATEDELETE | F | T | F | T |
| DBPROP_OWNINSERT | F | T | F | T |
| DBPROP_OWNUPDATEDELETE | F | T | F | T |
| DBPROP_QUICKSTART | F | F | - | - |
| DBPROP_REMOVEDELETED | F | F | F | - |
| DBPROP_IrowsetResynch | F | F | F | - |
| DBPROP_CHANGEINSERTEDROWS | F | F | F | F |
| DBPROP_SERVERDATAONINSERT | F | F | F | - |
| DBPROP_UNIQUEROWS | - | F | F | F |
| DBPROP_IMMOBILEROWS | - | - | - | T |
| Propriedades/modelos de cursor do conjunto de linhas | Dinâmico (RO) | Conjunto de chaves (R/W) | Dinâmico (R/W) |
|---|---|---|---|
| DBPROP_SERVERCURSOR | T | T | T |
| DBPROP_DEFERRED | - | - | - |
| DBPROP_IrowsetChange | F | - | - |
| DBPROP_IrowsetLocate | F | - | F |
| DBPROP_IrowsetScroll | F | - | F |
| DBPROP_IrowsetUpdate | F | - | - |
| DBPROP_BOOKMARKS | F | - | F |
| DBPROP_CANFETCHBACKWARDS | - | - | - |
| DBPROP_CANSRCOLLBACKWARDS | - | - | - |
| DBPROP_CANHOLDROWS | F | - | F |
| DBPROP_LITERALBOOKMARKS | F | - | F |
| DBPROP_OTHERINSERT | T | F | T |
| DBPROP_OTHERUPDATEDELETE | T | T | T |
| DBPROP_OWNINSERT | T | T | T |
| DBPROP_OWNUPDATEDELETE | T | T | T |
| DBPROP_QUICKSTART | - | - | - |
| DBPROP_REMOVEDELETED | T | - | T |
| DBPROP_IrowsetResynch | - | - | - |
| DBPROP_CHANGEINSERTEDROWS | F | - | F |
| DBPROP_SERVERDATAONINSERT | F | - | F |
| DBPROP_UNIQUEROWS | F | F | F |
| DBPROP_IMMOBILEROWS | F | T | F |
Para um determinado conjunto de propriedades de conjunto de linhas, o modelo de cursor selecionado é determinado da forma a seguir.
Na coleção especificada de propriedades do conjunto de linhas, obtenha um subconjunto das propriedades listadas nas tabelas anteriores. Divida essas propriedades em dois subgrupos de acordo com o valor do sinalizador obrigatório (T, F) ou opcional (-) de cada propriedade do conjunto de linhas. Para cada modelo de cursor, inicie na primeira tabela e mova da esquerda para a direita. Compare os valores das propriedades nos dois subgrupos com os valores das propriedades correspondentes nessa coluna. O modelo de cursor que não tem nenhuma incompatibilidade com as propriedades exigidas e o menor número de incompatibilidades com as propriedades opcionais é selecionado. Caso haja mais de um modelo de cursor, é escolhido o mais à esquerda.
Tamanho do bloco de cursor do SQL Server
Quando um cursor do SQL Server dá suporte a um conjunto de linhas do provedor OLE DB do SQL Server Native Client, o número de elementos no parâmetro de matriz de identificador de linha dos métodos IRowset::GetNextRows ou IRowsetLocate ::GetRowsAt define o tamanho do bloco do cursor. As linhas apontadas pelos identificadores na matriz são os membros do bloco de cursor.
Para conjuntos de linhas que dão suporte a indicadores, os identificadores de linha recuperados usando o método IRowsetLocate::GetRowsByBookmark definem os membros do bloco de cursor.
Independentemente do método usado para preencher o conjunto de linhas e formar o bloco de cursor do SQL Server, o bloco permanece ativo até que o próximo método de busca de linhas seja executado no conjunto.