Cursores
As operações em um ato de banco de dados relacional em um conjunto completo de linhas. Por exemplo, o conjunto de linhas retornado por uma instrução SELECT consiste de todas as linhas que satisfazem as condições na cláusula WHERE da instrução. Este conjunto completo de linhas retornado pela instrução é conhecido como conjunto de resultados. Aplicativos, especialmente aplicativos online interativos, não podem sempre trabalhar efetivamente com todo o conjunto de resultados como uma unidade. Esses aplicativos precisam de um mecanismo para trabalhar com uma linha ou um bloco pequeno de linhas de cada vez. Os cursores são uma extensão dos conjuntos de resultados que proveem esse mecanismo.
Os cursores estendem o resultado de processamento por:
Permitirem o posicionamento em linhas específicas do conjunto de resultados.
Recuperarem uma linha ou bloco de linhas de posições atuais em um conjunto de resultados.
Oferecerem suporte às modificações de dados nas linhas da posição atual no conjunto de resultados.
Oferecerem suporte a diferentes níveis de visibilidade às mudanças feitas por outros usuários ao banco de dados que são apresentados no conjunto de resultados.
Fornecer instruções Transact-SQL em scripts, procedimentos armazenados e dispara o acesso aos dados em um conjunto de resultados.
Conceitos
Implementações de cursor
SQL Server dá suporte a três implementações de cursor.
cursores Transact-SQL
São baseados na sintaxe DECLARE CURSOR e são usados principalmente em scripts Transact-SQL, procedimentos armazenados e gatilhos. Os cursores Transact-SQL são implementados no servidor e são gerenciados por instruções Transact-SQL enviadas do cliente para o servidor. Eles também podem ser contidos em lotes, procedimentos armazenados ou gatilhos.
Cursores de servidor de API (interface de programação de aplicativo)
Dão suporte a funções de cursor API no OLE DB e ODBC. Cursores de servidor API são implementados no servidor. Sempre que um aplicativo cliente chama uma função de cursor da API, o provedor OLE DB ou do SQL Server Native Client ou o driver ODBC transmite a solicitação ao servidor para ação contra o cursor de servidor API.
Cursores do cliente
São implementados internamente pelo SQL Server Native Client driver ODBC e pela DLL que implementa a API do ADO. Cursores do cliente são implementados fazendo o cache de todas as linhas do conjunto de resultados no cliente. Sempre que um aplicativo cliente chama uma função de cursor API, o driver ODBC do SQL Server Native Client ou a DLL ADO executa a operação de cursor nas linhas do conjunto de resultados em cache no cliente.
Tipos de cursores
Somente avanço
Um cursor de somente avanço não dá suporte a rolagem; ele suporta apenas a busca das linhas em série do início ao término do cursor. As linhas não são recuperadas do banco de dados até que sejam buscadas. Os efeitos de todas as instruções INSERT, UPDATE e DELETE feitas pelo usuário atual ou confirmadas por outros usuários que afetam as linhas no conjunto de resultados são visíveis como as linhas buscadas pelo cursor.
Como o cursor não podem ser revertido, a maioria das alterações feitas nas linhas no banco de dados depois que a linha foi buscada não são visíveis pelo cursor. Nos casos em que um valor usado para determinar o local da linha dentro do conjunto de resultados é modificado, como a atualização de uma coluna coberta por um índice clusterizado, o valor modificado é visível pelo cursor.
Embora os modelos de cursor de API do banco de dados considerem um cursor de somente avanço um tipo distinto de cursor, o SQL Server não faz isso. SQL Server considera tanto somente de avanço quanto rolagem como opções que podem ser aplicadas a cursores estáticos, controlados por conjuntos de chaves e dinâmicos. Os cursores Transact-SQL dão suporte a cursores estáticos, controlados por conjunto de chaves e dinâmicos somente encaminhamento. Os modelos de cursor de API de banco de dados assumem que os cursores estáticos, controlados por conjunto de chaves e dinâmicos são sempre roláveis. Quando um atributo ou propriedade de cursor de API de banco de dados é definido como somente de avanço, o SQL Server o implementa como um cursor dinâmico somente de avanço.
Estático
O conjunto completo de resultados de um cursor estático é criado em tempdb quando o cursor está aberto. Um cursor estático sempre exibe o conjunto de resultados como ele estava quando o cursor estava aberto. Os cursores estáticos detectam poucas ou nenhuma alteração, porém consomem relativamente poucos recursos durante a rolagem.
O cursor não reflete qualquer mudança feita no banco de dados que afeta a associação do conjunto de resultados ou as alterações feitas nos valores nas colunas das linhas que compõem o conjunto de resultados. Um cursor estático não exibe novas linhas inseridas no banco de dados após o cursor ter sido aberto, mesmo se elas corresponderem aos critérios de pesquisa da instrução SELECT do cursor. Se as filas que constituem o conjunto de resultados forem atualizadas por outros usuários, os novos valores de dados não serão exibidos no cursor estático. O cursor estático exibe linhas excluídas do banco de dados após o cursor ter sido aberto. Nenhuma operação UPDATE, INSERT ou DELETE são refletidas em um cursor estático (a menos que o cursor esteja fechado e reaberto), nem mesmo alterações feitas usando a mesma conexão que abriu o cursor.
SQL Server cursores estáticos são sempre somente leitura.
Como o conjunto de resultados de um cursor estático é armazenado em uma tabela de trabalho no tempdb, o tamanho das linhas no conjunto de resultados não pode exceder o tamanho máximo da linha de uma tabela de SQL Server.
O Transact-SQL usa o termo que não diferencia cursores estáticos. Algum banco de dados APIs os identificam como cursores de instantâneo.
Keyset
A associação e a ordem de linhas em um cursor controlado por conjunto de chaves são fixadas quando o cursor é aberto. Os cursores controlados por conjuntos de chaves são controlados por um conjunto exclusivo de identificadores, as chaves, conhecido como conjunto de chaves. As chaves são criadas a partir de um conjunto de colunas, que identificam exclusivamente as linhas no conjunto de resultados. O conjunto de chaves é o conjunto dos valores de chaves de todas as linhas qualificadas para a instrução SELECT no momento em que o cursor foi aberto. O conjunto de chaves para um cursor controlado por conjunto de chaves é criado no tempdb quando o cursor é aberto.
Dinâmico
Os cursores dinâmicos são o oposto dos cursores estáticos. Cursores dinâmicos refletem todas as alterações feitas nas linhas de seu conjunto de resultados ao rolar pelo cursor. Os valores de dados, a ordem e a associação das linhas do conjunto de resultados podem ser alterados em cada busca. Todas as instruções UPDATE, INSERT e DELETE feitas por todos os usuários são visíveis pelo cursor. Atualizações ficarão visíveis imediatamente se forem feitas por meio do cursor usando uma função de API, como SQLSetPos ou a cláusula Transact-SQL WHERE CURRENT OF. As atualizações feitas fora do cursor não são visíveis até serem confirmadas, a menos que o nível de isolamento da transação do cursor esteja definido para ler não confirmadas. Planos de cursor dinâmicos nunca usam índices espaciais.
Solicitando um cursor
SQL Server dá suporte a dois métodos de solicitação de cursor:
Transact-SQL
A linguagem Transact-SQL dá suporte a uma sintaxe para usar cursores modelados após a sintaxe do cursor ISO.
Funções de cursor de interface de programação de aplicativo (API) de banco de dados
SQL Server dá suporte à funcionalidade do cursor dessas APIs de banco de dados:
ADO (Microsoft ActiveX Data Object)
OLE DB
ODBC (Open Database Connectivity)
Um aplicativo não deve nunca misturar estes dois métodos de solicitar um cursor. Um aplicativo que usou a API para especificar comportamentos de cursor não deve executar uma instrução DECLARE CURSOR transact-SQL para também solicitar um cursor Transact-SQL. Um aplicativo deve apenas executar DECLARE CURSOR se ele tiver retornado todos os atributos API do cursor de volta ao seu padrão.
Se nem um cursor Transact-SQL nem API tiver sido solicitado, SQL Server o padrão será retornar um conjunto de resultados completo, conhecido como um conjunto de resultados padrão, para o aplicativo.
Processo do cursor
Cursores transact-SQL e cursores de API têm sintaxe diferente, mas o processo geral a seguir é usado com todos os cursores SQL Server:
Associe um cursor ao conjunto de resultados de uma instrução Transact-SQL e defina características do cursor, como se as linhas no cursor podem ser atualizadas.
Execute a instrução Transact-SQL para preencher o cursor.
Recupere as linhas no cursor que você quer visualizar. A operação para recuperar uma linha ou um bloco de linhas de um cursor é denominada busca. Executar uma série de buscas para recuperar linhas em direção para frente ou para trás é chamado rolagem.
Opcionalmente, execute operações de modificação (atualização ou exclusão) na fila da posição atual no cursor.
Feche o cursor.
Conteúdo relacionado
Comportamentos de cursorComo os cursores são implementados
Consulte Também
DECLARE CURSOR (Transact-SQL)
cursores (Transact-SQL)
funções de cursor (Transact-SQL)
procedimentos armazenados de cursor (Transact-SQL)