Construindo instruções SQL para cursores

Aplica-se a:SQL ServerBanco de Dados SQL do AzureInstância Gerenciada de SQL do AzureAzure Synapse AnalyticsPDW (Analytics Platform System)

O SQL Server Native Client driver ODBC 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 atributos de instrução diferentes. Estes são os atributos e seus padrões.

Atributo	Padrão
SQL_ATTR_CONCURRENCY	SQL_CONCUR_READ_ONLY
SQL_ATTR_CURSOR_TYPE	SQL_CURSOR_FORWARD_ONLY
SQL_ATTR_CURSOR_SCROLLABLE	SQL_NONSCROLLABLE
SQL_ATTR_CURSOR_SENSITIVITY	SQL_UNSPECIFIED
SQL_ATTR_ROW_ARRAY_SIZE	1

Quando essas opções são definidas como seus padrões no momento em que uma instrução SQL é executada, o driver ODBC 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 SQL Server Native Client driver ODBC 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 dão 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

  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.

Em SQL Server, se uma instrução SQL que corresponde 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 de 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.

Consulte Também

Executando consultas (ODBC)