Construindo instruções SQL para cursores

Aplica-se a: SQL Server Banco de Dados SQL do Azure Instância Gerenciada de SQL do Azure Azure Synapse Analytics Analytics Platform System (PDW)

O driver ODBC do SQL Server Native Client usa cursores de servidor para implementar a funcionalidade de cursor definida na especificação ODBC. Um aplicativo ODBC controla o comportamento do cursor usando SQLSetStmtAttr para definir diferentes atributos de instrução. Estes são os atributos e seus padrões.

Quando essas opções são definidas como seus padrões no momento em que uma instrução SQL é executada, o driver ODBC do SQL Server Native Client não usa um cursor de servidor para implementar o conjunto de resultados; em vez disso, ele usa um conjunto de resultados padrão. Se qualquer uma dessas opções for alterada de seus padrões no momento em que uma instrução SQL for executada, o driver ODBC do SQL Server Native Client tentará usar um cursor de servidor para implementar o conjunto de resultados.

Os conjuntos de resultados padrão dão suporte a todas as instruções Transact-SQL. Não há nenhuma restrição quanto aos tipos de instruções SQL que podem ser executados ao usar um conjunto de resultados padrão.

Os cursores de servidor não oferecem suporte a todas as instruções Transact-SQL. Os cursores de servidor não oferecem suporte a nenhuma instrução SQL que gera vários conjuntos de resultados.

Os seguintes tipos de instruções não oferecem suporte por meio de cursores de servidor:

• Lotes de estoque

  Instruções SQL criadas a partir de duas ou mais instruções SQL SELECT individuais, por exemplo:

  SELECT * FROM Authors; SELECT * FROM Titles  
  

• Procedimentos armazenados com várias instruções SELECT

  As instruções SQL que executam um procedimento armazenado contendo mais de uma instrução SELECT. Isso inclui instruções SELECT que preenchem parâmetros ou variáveis.

• Palavras-chave

  Instruções SQL que contêm as palavras-chave FOR BROWSE ou INTO.

No SQL Server, se uma instrução SQL que corresponda a qualquer uma dessas condições for executada com um cursor de servidor, o cursor do servidor será convertido implicitamente em um conjunto de resultados padrão. Depois que SQLExecDirect ou SQLExecute retornar SQL_SUCCESS_WITH_INFO, os atributos do cursor serão definidos de volta para suas configurações padrão.

As instruções SQL que não se enquadram nas categorias acima podem ser executadas com qualquer configuração de atributo da instrução; elas funcionam igualmente bem com um conjunto de resultados padrão ou um cursor de servidor.

Errors

No SQL Server 7.0 e posterior, uma tentativa de executar uma instrução que produz vários conjuntos de resultados gera SQL_SUCCESS_WITH INFO e a seguinte mensagem:

SqlState: 01S02"  
pfNative: 0  
szErrorMsgString: "[Microsoft][SQL Server Native Client][SQL Server]  
               Cursor type changed."  

Os aplicativos ODBC que recebem essa mensagem podem chamar SQLGetStmtAttr para determinar as configurações atuais do cursor.

Uma tentativa de executar um procedimento com várias instruções SELECT durante o uso de cursores de servidor gera o seguinte erro:

SqlState: 42000  
pfNative: 16937  
szErrorMsgString: [Microsoft][SQL Server Native Client][SQL Server]  
               A server cursor is not allowed on a stored procedure  
               with more than one SELECT statement in it. Use a  
               default result set or client cursor.  

Uma tentativa de executar um lote com várias instruções SELECT durante o uso de cursores de servidor gera o seguinte erro:

SqlState: 42000  
pfNative: 16938  
szErrorMsgString: [Microsoft][SQL Server Native Client][SQL Server]  
               sp_cursoropen. The statement parameter can only  
               be a single SELECT statement or a single stored   
               procedure.  

Aplicativos ODBC que recebem esses erros devem restaurar todos padrões dos atributos de instrução de cursor antes de tentar executá-la.

Confira também

Executando consultas (ODBC)