Compartilhar via


Execução preparada

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)

A API ODBC define a execução preparada como uma maneira de reduzir a sobrecarga de análise e compilação associada à execução repetida de uma instrução Transact-SQL. O aplicativo cria uma cadeia de caracteres contendo uma instrução SQL e a executa em dois estágios. Ele chama a função SQLPrepare uma vez para que a instrução seja analisada e compilada em um plano de execução pelo Mecanismo de Banco de Dados. Em seguida, ele chama SQLExecute para cada execução do plano de execução preparado. Dessa forma, a sobrecarga de análise e compilação é salva em cada execução. A execução preparada geralmente é usada através de aplicativos para executar a mesma instrução SQL com parâmetros várias vezes.

Para a maioria dos bancos de dados, a execução preparada é mais rápida que a direta para instruções executadas mais de três ou quatro vezes primariamente, pois a instrução é compilada somente uma vez, enquanto instruções executadas diretamente são compiladas sempre que ocorrem. A execução preparada também pode fornecer uma redução no tráfego de rede, pois o driver pode enviar um identificador do plano de execução e os valores de parâmetro, em vez de toda uma instrução SQL, para a fonte de dados sempre que a instrução for executada.

O SQL Server reduz a diferença de desempenho entre a execução direta e a preparada por meio de algoritmos aprimorados para detectar e reutilizar planos de execução do SQLExecDirect. Isso torna alguns dos benefícios de desempenho da execução preparada disponíveis para instruções executadas diretamente. Para obter mais informações, consulte Execução direta.

O SQL Server também fornece suporte nativo para execução preparada. Um plano de execução é criado no SQLPrepare e executado posteriormente quando o SQLExecute é chamado. Como o SQL Server não é necessário para criar procedimentos armazenados temporários no SQLPrepare, não há sobrecarga extra nas tabelas do sistema em tempdb.

Por motivos de desempenho, a preparação da instrução é adiada até que SQLExecute seja chamado ou uma operação de metapropriedade (como SQLDescribeCol ou SQLDescribeParam no ODBC) seja executada. Esse é o comportamento padrão. Não são conhecidos erros na instrução que está sendo preparada até que ela seja executada ou uma operação de metapropriedade seja executada. Definir o atributo de instrução específica do driver ODBC do SQL Server Native Client SQL_SOPT_SS_DEFER_PREPARE como SQL_DP_OFF pode desativar esse comportamento padrão.

No caso de preparação adiada, chamar SQLDescribeCol ou SQLDescribeParam antes de chamar SQLExecute gera uma viagem de ida e volta extra para o servidor. Em SQLDescribeCol, o driver remove a cláusula WHERE da consulta e a envia ao servidor com SET FMTONLY ON para obter a descrição das colunas no primeiro conjunto de resultados retornado pela consulta. Em SQLDescribeParam, o driver chama o servidor para obter uma descrição das expressões ou colunas referenciadas por quaisquer marcadores de parâmetro na consulta. Esse método também tem algumas restrições, como não poder resolver parâmetros em subconsultas.

O uso excessivo do SQLPrepare com o driver ODBC do SQL Server Native Client degrada o desempenho, especialmente quando conectado a versões anteriores do SQL Server. A execução preparada não deve ser usada para instruções executadas uma única vez. A execução preparada é mais lenta que a direta para uma única execução de instrução, pois ela requer uma viagem de ida e volta extra do cliente ao servidor. Em versões anteriores do SQL Server, ele também gera um procedimento armazenado temporário.

As instruções preparadas não podem ser usadas para criar objetos temporários no SQL Server.

Alguns aplicativos ODBC anteriores usavam SQLPrepare sempre que SQLBindParameter era usado. SQLBindParameter não requer o uso de SQLPrepare, ele pode ser usado com SQLExecDirect. Por exemplo, use SQLExecDirect com SQLBindParameter para recuperar o código de retorno ou os parâmetros de saída de um procedimento armazenado que é executado apenas uma vez. Não use SQLPrepare com SQLBindParameter , a menos que a mesma instrução seja executada várias vezes.

Confira também

Executnado instruções (ODBC)