Kopiowanie masowe ze zmiennych programu

Dotyczy:sql ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse Analytics

Możesz kopiować masowo bezpośrednio ze zmiennych programu. Po przydzieleniu zmiennych do przechowywania danych dla wiersza i wywołaniu bcp_init w celu rozpoczęcia kopii zbiorczej, wywołaj bcp_bind dla każdej kolumny, aby określić lokalizację i format zmiennej programowej, która ma być powiązana z kolumną. Wypełnij każdą zmienną danymi, a następnie wywołaj bcp_sendrow , aby wysłać jeden wiersz danych do serwera. Powtarzaj proces wypełniania zmiennych i wywoływania bcp_sendrow , aż wszystkie wiersze zostaną wysłane na serwer, a następnie wywołaj bcp_done , aby określić, że operacja jest zakończona.

Parametr pData bcp_bind zawiera adres zmiennej powiązanej z kolumną. Dane dla każdej kolumny można przechowywać na jeden z dwóch sposobów:

• Przydziel jedną zmienną do przechowywania danych.

• Przydziel zmienną wskaźnikową, a następnie natychmiast zmienną danych.

Zmienna wskaźnikowa wskazuje długość danych dla kolumn o zmiennej długości, a także wartości NULL, jeśli kolumna dopuszcza NULL. Jeśli używana jest tylko zmienna danych, adres tej zmiennej jest przechowywany w parametrze bcp_bindpData . Jeśli użyta jest zmienna wskaźnikowa, adres zmiennej wskaźnikowej jest przechowywany w parametrze bcp_bind pData. Funkcje kopiowania zbiorczego obliczają lokalizację zmiennej danych, dodając parametry bcp_bindcbIndicator i pData .

bcp_bind obsługuje trzy metody pracy z danymi o zmiennej długości:

• Używaj cbData tylko z zmienną danych. Umieść długość danych w cbData. Za każdym razem, gdy zmienia się długość danych kopiowanych masowo, wywołaj bcp_collen , aby zresetować cbData. Jeśli używana jest jedna z pozostałych dwóch metod, określ SQL_VARLEN_DATA dla cbData. Jeśli wszystkie wartości danych dla kolumny są NULL, określ SQL_NULL_DATA dla cbData.

• Używaj zmiennych wskaźnikowych. Gdy każda nowa wartość danych jest przenoszona do zmiennej danych, przechowuj długość tej wartości w zmiennej wskaźnikowej. Jeśli używana jest jedna z pozostałych dwóch metod, należy określić 0 dla cbIndicator.

• Używaj wskaźników terminatora. Załaduj parametr pTerm bcp_bind adresem wzorca bitowego, który kończy dane. Jeśli używana jest jedna z pozostałych dwóch metod, określ NULL dla pTerm.

Wszystkie trzy metody mogą być używane w tym samym bcp_bind wywołaniu, w takim przypadku stosuje się specyfikację skutkującą najmniejszą kopią danych.

Parametr typubcp_bind wykorzystuje DB-Library identyfikatorów typów danych, a nie identyfikatorów typów danych ODBC. DB-Library identyfikatory typów danych są zdefiniowane w sqlncli.h do użycia z funkcją ODBC bcp_bind .

Funkcje kopiowania masowego nie obsługują wszystkich typów danych ODBC C. Na przykład funkcje kopiowania masowego nie obsługują struktury SQL_C_TYPE_TIMESTAMP ODBC, więc użyj SQLBindCol lub SQLGetData do konwersji danych ODBC SQL_TYPE_TIMESTAMP na zmienną SQL_C_CHAR. Jeśli następnie użyjesz bcp_bind z parametrem typu SQLCHARACTER, aby przypisać zmienną do kolumny SQL Server datetime, funkcje kopiowania masowego przekształcają klauzulę timestamp escape zmiennej znaku do właściwego formatu datetime.

Poniższa tabela przedstawia zalecane typy danych do wykorzystania przy mapowaniu z typu danych SQL ODBC na typ danych SQL Server.

SQL Server nie posiada typów danych z podpisem tinyint, niepodpisanym smallint ani unsigned int. Aby zapobiec utracie wartości danych podczas migracji tych typów, utwórz tabelę SQL Server z następnym co do wielkości typem danych całkowitoliczbowych. Aby zapobiec późniejszemu dodawaniu wartości poza zakresem dozwolonym przez oryginalny typ danych, zastosuj regułę do kolumny SQL Server, która ogranicza dopuszczalne wartości do zakresu obsługiwanego przez typ danych w oryginalnym źródle:

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  

SQL Server nie obsługuje bezpośrednio typów danych interwałowych. Aplikacja może jednak przechowywać sekwencje przejścia interwałowego jako ciągi znaków w kolumnie znaków SQL Server. Aplikacja może je odczytać do późniejszego użytku, ale nie mogą być używane w Transact-SQL instrukcjach.

Funkcje kopiowania masowego mogą być używane do szybkiego ładowania danych do SQL Server, które zostały odczytane ze źródła danych ODBC. Użyj SQLBindCol , aby powiązać kolumny zbioru wyników ze zmiennymi programu, a następnie użyj bcp_bind do powiązania tych samych zmiennych programu z operacją kopiowania zbiorowego. Wywołanie SQLFetchScroll lub SQLFetch pobiera rząd danych ze źródła danych ODBC do zmiennych programowych i wywołuje bcp_sendrow masowo kopiuje dane ze zmiennych programu do SQL Server .

Aplikacja może używać funkcji bcp_colptr w dowolnym momencie, gdy musi zmienić adres zmiennej danych pierwotnie określoną w parametrze bcp_bindpData . Aplikacja może używać funkcji bcp_collen w dowolnym momencie, gdy musi zmienić pierwotnie określoną długość danych w parametrze bcp_bindcbData .

Nie można odczytać danych z SQL Server do zmiennych programu za pomocą kopii masowej; nie ma nic podobnego do funkcji "bcp_readrow". Możesz przesyłać tylko dane z aplikacji na serwer.

Treści powiązane

• Wykonywanie operacji kopiowania zbiorczego (ODBC)