Executar diretamente uma instrução (ODBC)

Aplica-se a: SQL Server Banco de Dados SQL do Azure Instância Gerenciada de SQL do Azure PDW (Sistema de Plataforma de Análise) do Azure Synapse Analytics

Para executar uma instrução diretamente e apenas uma vez

  1. Se a instrução tiver marcadores de parâmetro, use SQLBindParameter para associar cada parâmetro a uma variável de programa. Preencha as variáveis de programa com valores de dados e configure todos os parâmetros de dados em execução.

  2. Chame SQLExecDirect para executar a instrução.

  3. Se forem usados parâmetros de entrada de dados em execução, SQLExecDirect retornará SQL_NEED_DATA. Envie os dados em partes useo SQLParamData e SQLPutData.

Para executar uma instrução várias vezes usando a associação de parâmetros por coluna

  1. Chame SQLSetStmtAttr para definir os seguintes atributos:

    Defina SQL_ATTR_PARAMSET_SIZE como o número de conjuntos (S) de parâmetros.

    Defina SQL_ATTR_PARAM_BIND_TYPE como SQL_PARAMETER_BIND_BY_COLUMN.

    Defina o atributo SQL_ATTR_PARAMS_PROCESSED_PTR de forma que aponte para uma variável SQLUINTEGER que contém o número de parâmetros processados.

    Defina SQL_ATTR_PARAMS_STATUS_PTR de forma que aponte para uma matriz[S] de variáveis SQLUSSMALLINT que contém os indicadores de status de parâmetro.

  2. Para cada marcador de parâmetro:

    Aloque uma matriz de S buffers de parâmetro para armazenar valores de dados.

    Aloque uma matriz de S buffers de parâmetro para armazenar comprimentos de dados.

    Chame SQLBindParameter para associar as matrizes de comprimento de dados e de valor de dados de parâmetro ao parâmetro de instrução.

    Configure quaisquer parâmetros de imagem ou texto de dados em execução.

    Coloque os valores de dados S e os comprimentos de dados S nas matrizes de parâmetro associadas.

  3. Chame SQLExecDirect para executar a instrução. O driver executa a instrução de maneira eficiente S vezes, sendo uma para cada conjunto de parâmetros.

  4. Se forem usados parâmetros de entrada de dados em execução, SQLExecDirect retornará SQL_NEED_DATA. Envie os dados em partes useo SQLParamData e SQLPutData.

Para executar uma instrução várias vezes usando a associação de parâmetros por linha

  1. Aloque uma matriz[S] de estruturas, onde S é o número de conjuntos de parâmetros. A estrutura tem um elemento para cada parâmetro e cada elemento tem duas partes:

    A primeira parte é uma variável do tipo de dados apropriado que contém os dados de parâmetro.

    A segunda parte é uma variável SQLINTEGER que contém o indicador de status.

  2. Chame SQLSetStmtAttr para definir os seguintes atributos:

    Defina SQL_ATTR_PARAMSET_SIZE como o número de conjuntos (S) de parâmetros.

    Defina SQL_ATTR_PARAM_BIND_TYPE como o tamanho da estrutura alocada na Etapa 1.

    Defina o atributo SQL_ATTR_PARAMS_PROCESSED_PTR de forma que aponte para uma variável SQLUINTEGER que contém o número de parâmetros processados.

    Defina SQL_ATTR_PARAMS_STATUS_PTR de forma que aponte para uma matriz[S] de variáveis SQLUSSMALLINT que contém os indicadores de status de parâmetro.

  3. Para cada marcador de parâmetro, chame SQLBindParameter para direcionar o ponteiro de comprimento de dados e de valor de dados do parâmetro para suas variáveis no primeiro elemento da matriz de estruturas alocadas na Etapa 1. Se o parâmetro for um parâmetro de dados em execução, configure-o.

  4. Preencha a matriz de buffers de parâmetros associada com valores de dados.

  5. Chame SQLExecDirect para executar a instrução. O driver executa a instrução de maneira eficiente S vezes, sendo uma para cada conjunto de parâmetros.

  6. Se forem usados parâmetros de entrada de dados em execução, SQLExecDirect retornará SQL_NEED_DATA. Envie os dados em partes useo SQLParamData e SQLPutData.

Observação As associações por coluna e por linha geralmente são mais usadas em conjunto com SQLPrepare Function e SQLExecute do que com SQLExecDirect.

Confira também

Tópicos de instruções sobre a execução de consultas (ODBC)