Cópia em massa de variáveis do programa

Você pode fazer cópias em massa diretamente de variáveis de programa. Depois de alocar variáveis para manter os dados de uma linha e chamar bcp_init para começar a cópia em massa, chame bcp_bind para cada coluna, a fim de especificar o local e o formato da variável de programa a ser associada à coluna. Encha cada variável de dados e chame bcp_sendrow para enviar uma linha de dados ao servidor. Repita o processo de encher as variáveis e chamar bcp_sendrow até que todas as linhas tenham sido enviadas para o servidor. Em seguida, chame bcp_done para especificar que a operação foi concluída.

O parâmetro bcp_bindpData contém o endereço da variável associada à coluna. Os dados de cada coluna podem ser armazenados de uma destas duas formas:

• Aloque uma variável para manter os dados.

• Aloque uma variável de indicador seguida imediatamente pela variável de dados.

A variável de indicador indica o comprimento dos dados para colunas de comprimento variável e também indica valores NULL se a coluna permitir NULLs. Se somente uma variável de dados for usada, então o endereço desta variável será armazenado no parâmetro bcp_bindpData. Se uma variável de indicador for usada, então o endereço da variável do indicador será armazenado no parâmetro bcp_bindpData. As funções de cópia em massa calculam o local da variável de dados adicionando os parâmetros bcp_bindcbIndicator e pData.

bcp_bind dá suporte a três métodos para lidar com dados de comprimento de variável:

• Use cbData somente com uma variável de dados. Coloque o comprimento dos dados em cbData. Sempre que o comprimento dos dados que serão copiados em massa for alterado, chame de bcp_collen para redefinir cbData. Se um dos outros dois métodos estiver sendo usado, especifique SQL_VARLEN_DATA para cbData. Se todos os valores de dados que são fornecidos para uma coluna forem o NULL, especifique SQL_NULL_DATA para cbData.

• Use variáveis de indicador. Como cada valor de dados novo é movido na variável de dados, armazene o comprimento do valor na variável de indicador. Se um dos outros dois métodos estiver sendo usado, especifique 0 para cbIndicator.

• Use ponteiros de terminador. Carregue o parâmetro bcp_bindpTerm com o endereço do padrão de bits que finaliza os dados. Se um dos outros dois métodos estiver sendo usado, especifique NULL para pTerm.

Os três métodos podem ser usados na mesma chamada do bcp_bind, caso em que a especificação que resulte na menor quantidade de cópia de dados é usada.

O parâmetro de tipobcp_bind usa identificadores de tipo de dados DB-Library, e não identificadores de tipo de dados ODBC. Os identificadores de tipo de dados DB-Library são definidos em sqlncli.h para uso com a função ODBC bcp_bind.

As funções de cópia em massa não têm suporte para todos os tipos de dados do ODBC C. Por exemplo, as funções de cópia em massa não dão suporte à estrutura ODBC SQL_C_TYPE_TIMESTAMP, portanto use SQLBindCol ou SQLGetData para converter dados do ODBC SQL_TYPE_TIMESTAMP a uma variável SQL_C_CHAR. Se então você usar bcp_bind com um tipo de parâmetro SQLCHARACTER para associar a variável a uma coluna SQL Serverdatetime, as funções de cópia em massa converterão a cláusula de escape do carimbo de data e hora na variável do caractere para o formato de data e hora adequado.

A tabela seguinte lista os tipos de dados indicados para usar mapeando de um tipo de dados do ODBC SQL para um tipo de dados do SQL Server.

SQL Server não tem assinado tinyint, smallint sem assinatura ou tipos de dados de int sem assinatura. Para impedir a perda de valores de dados ao migrar estes tipos de dados, crie a tabela SQL Server com o próximo tipo de dados de inteiro maior. Para impedir que os usuários adicionem posteriormente valores fora da faixa permitida pelo tipo de dados original, aplique uma regra à coluna SQL Server a fim de restringir os valores permitidos para a faixa com suporte do tipo de dados na fonte original:

CREATE TABLE Sample_Ints(STinyIntCol   SMALLINT,
USmallIntCol INT)
GO
CREATE RULE STinyInt_Rule
AS 
@range >= -128 AND @range <= 127
GO
CREATE RULE USmallInt_Rule
AS 
@range >= 0 AND @range <= 65535
GO
sp_bindrule STinyInt_Rule, 'Sample_Ints.STinyIntCol'
GO
sp_bindrule USmallInt_Rule, 'Sample_Ints.USmallIntCol'
GO

O SQL Server não dá suporte a tipos de dados de intervalo diretamente. Porém, um aplicativo pode armazenar seqüências de escape de intervalo como cadeias de caracteres em uma coluna de caractere do SQL Server. O aplicativo pode lê-los para uso posterior, mas eles não podem ser usados em instruções do Transact-SQL.

As funções de cópia em massa podem ser usadas para carregar dados que tenham sido lidos de uma fonte de dados ODBC rapidamente no SQL Server. Use SQLBindCol para associar as colunas de um conjunto de resultados a variáveis do programa e, em seguida, use bcp_bind para associar as mesmas variáveis do programa a uma operação de cópia em massa. A chamada para SQLFetchScroll ou SQLFetch busca uma linha de dados da fonte de dados ODBC nas variáveis do programa e a chamada para bcp_sendrow executa cópias em massa das variáveis do programa para SQL Server.

Um aplicativo pode usar a função bcp_colptr sempre que precisar alterar o endereço da variável de dados especificado no parâmetro bcp_bindpData. Um aplicativo pode usar a função bcp_collen sempre que precisa alterar o comprimento de dados especificado originalmente no parâmetro bcp_bindcbData.

Você não pode ler dados de SQL Server em variáveis de programa que usam cópia em massa; não há nada como uma função "bcp_readrow". Você só pode enviar dados do aplicativo para o servidor.