Resultados de Processamento - Resultados de Processo

Aplica-se a:SQL ServerBase de Dados SQL do AzureInstância Gerida do Azure SQLAzure Synapse Analytics

O processamento dos resultados numa aplicação ODBC envolve primeiro determinar as características do conjunto de resultados, depois recuperar os dados para variáveis de programa utilizando SQLBindCol ou SQLGetData.

Para processar resultados

1. Recuperar informações do conjunto de resultados.

2. Se forem usadas colunas limitadas, para cada coluna à qual queres ligar, chama o SQLBindCol para ligar um buffer de programa à coluna.

3. Para cada linha do conjunto de resultados:

   • Liga para o SQLFetch para obter a próxima linha.

   • Se forem usadas colunas limitadas, utilize os dados atualmente disponíveis nos buffers de colunas limitadas.

   • Se forem usadas colunas não vinculadas, chame SQLGetData uma ou mais vezes para obter os dados das colunas não vinculadas após a última coluna limitada. As chamadas ao SQLGetData devem ser feitas por ordem crescente de número de colunas.

   • Chame SQLGetData várias vezes para obter dados de uma coluna de texto ou imagem.

4. Quando o SQLFetch sinaliza o fim do conjunto de resultados ao devolver SQL_NO_DATA, chame o SQLMoreResults para determinar se existe outro conjunto de resultados disponível.

   • Se devolver SQL_SUCCESS, outro conjunto de resultados está disponível.

   • Se devolver SQL_NO_DATA, não há mais conjuntos de resultados disponíveis.

   • Se devolver SQL_SUCCESS_WITH_INFO ou SQL_ERROR, chame SQLGetDiagRec para determinar se a saída de uma instrução PRINT ou RAISERROR está disponível.

     Se os parâmetros da instrução limitada forem usados para parâmetros de saída ou para o valor de retorno de um procedimento armazenado, use os dados agora disponíveis nos buffers de parâmetros limitados. Além disso, quando são usados parâmetros limitados, cada chamada ao SQLExecute ou SQLExecDirect terá executado a instrução SQL S vezes, onde S é o número de elementos no array de parâmetros limitados. Isto significa que haverá S conjuntos de resultados para processar, onde cada conjunto de resultados compreende todos os conjuntos de resultados, parâmetros de saída e códigos de retorno, normalmente devolvidos por uma única execução da instrução SQL.

   Note

   Quando um conjunto de resultados contém linhas de cálculo, cada linha de cálculo fica disponível como um conjunto de resultados separado. Estes conjuntos de resultados de cálculo estão intercalados dentro das linhas normais e dividem as linhas normais em múltiplos conjuntos de resultados.

5. Opcionalmente, chame SQLFreeStmt com SQL_UNBIND para libertar quaisquer buffers de coluna vinculados.

6. Se houver outro conjunto de resultados disponível, avance para o Passo 1.

Conteúdo relacionado

• Processamento de Resultados - Recuperar Informação do Conjunto de Resultados