Variáveis de aplicativo

As linguagens de programação de aplicativo, como C, C++, Basic e Java, usam variáveis para manter dados. As variáveis são áreas de armazenamento que podem manter um valor de dados. Cada variável de aplicativo possui um tamanho e tipo de dados. As variáveis numéricas também têm precisão, isto é, número de dígitos que a variável pode manter; e escala, ou seja, número de dígitos situados à direita da vírgula decimal.

Para que um aplicativo possa trabalhar com os dados retornados de instruções do Transact-SQL, o aplicativo deve ter um mecanismo para mover os dados Transact-SQL para as variáveis de aplicativo. As APIs de banco de dados dão suporte ao conceito de associação de coluna, parâmetro, código de retorno ou marcador de parâmetro de um conjunto de resultados em uma instrução do Transact-SQL para uma variável de aplicativo.

Para recuperar os dados em um conjunto de resultados, o aplicativo utiliza um processo semelhante a este:

  1. Executa uma instrução do Transact-SQL.

  2. Chama uma função de API de banco de dados para descobrir o número de colunas que constam do conjunto de resultados.#

  3. Para cada coluna do conjunto de resultados, o aplicativo:

    • Chama uma função de API de banco de dados que retorna atributos, tamanho de tipo de dados e assim por diante, da coluna.

    • Aloca uma variável de aplicativo com atributos compatíveis com os atributos da coluna.

    • Chama uma função de API de banco de dados para associar, ou mapear, a coluna do conjunto de resultados à variável de aplicativo.

  4. Usa funções de API de banco de dados para buscar as linhas do conjunto de resultados, uma por vez. Em cada busca, os valores de cada coluna de conjunto de resultados são postos na variável de aplicativo associada à coluna.

Os aplicativos podem variar esse processo. Por exemplo, se o aplicativo estiver executando uma instrução codificada do Transact-SQL com relação a uma tabela conhecida, os atributos das colunas do conjunto de resultados serão conhecidos com antecedência, e o aplicativo não precisará chamar a API de banco de dados para obter os atributos.

Se o aplicativo associar uma coluna de conjunto de resultados a uma variável de aplicativo cujo tipo de dados seja diferente do tipo do objeto de banco de dados associado, então o provedor OLE DB do driver ODBC precisará converter os dados. Por exemplo, se um aplicativo associar uma coluna Dinheiro a uma matriz de caracteres, o provedor OLE DB ou driver ODBC precisarão converter os dados de Dinheiro em cadeia de caracteres. A documentação do Microsoft OLE DB Provider for SQL Server e do driver ODBC SQL Server define as conversões de tipo de dados para as quais há suporte.

Para obter mais informações sobre como recuperar parâmetros e códigos de retorno em aplicativos, consulte Marcadores de parâmetro (Mecanismo de Banco de Dados).