IBCPSession (Native Client OLE DB Provider)

Dotyczy:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)

Ważna

SQL Server Native Client (często skracany jako SNAC) został usunięty z SQL Server 2022 (16.x) i SQL Server Management Studio 19 (SSMS). Zarówno dostawca OLE DB klienta natywnego programu SQL Server (SQLNCLI lub SQLNCLI11), jak i starszy dostawca MICROSOFT OLE DB dla programu SQL Server (SQLOLEDB) nie są zalecane w przypadku nowego programowania. Przełącz się na nowy sterownik Microsoft OLE DB (MSOLEDBSQL) dla programu SQL Server na przyszłość.

Interfejs IBCPSession udostępnia wsparcie dla operacji kopiowania masowego na podstawie plików SQL Server. Interfejs IBCPSession jest udostępniony w dostawcy natywnej klientowej bazy danych OLE DB SQL Server na tym samym poziomie co sesje. W dostawcy SQL Server Native Client OLE DB obiekty źródła danych to fabryki obiektów sesji, a operacje kopiowania masowego są określone w właściwości połączenia SSPROP_ENABLEBULKCOPY. Dodatkowo własność SSPROP_ENABLEFASTLOAD powinna być ustawiona na true.

Wywołanie metody IDBCreateSession::CreateSession skutkuje utworzeniem obiektu BulkCopySession . Wszystkie metody kopiowania masowego oparte na plikach, udostępnione przez obiekt IBCPSession, są następnie wywoływalne z niemal identycznymi sygnaturami na interfejsie IBCPSession tego obiektu IBCPSession.

Uwaga / Notatka

Dostawca natywnej klientowej bazy danych SQL Server obsługuje operacje kopiowania masowego oparte na pamięci za pośrednictwem interfejsu IRowsetFastLoad.

Więcej informacji o wykorzystaniu dostawcy bazy danych SQL Server Native Client OLE DB do operacji kopiowania masowego można znaleźć w artykule Wykonywanie operacji kopiowania masowego.

Przykładowy sposób korzystania z interfejsu IBCPSession można znaleźć w IBCPSession::BCPDone (OLE DB).

W tej Sekcji

Metoda Description
IBCPSession::BCPColFmt (OLE DB) Tworzy powiązanie między zmiennymi programowymi a kolumnami SQL Server.
IBCPSession::BCPColumns (OLE DB) Ustala liczbę pól, które mają być przypisane do kolumn w tabeli SQL Server.
IBCPSession::BCPControl (OLE DB) Ustawia opcje operacji kopiowania masowego.
IBCPSession::BCPDone (OLE DB) Potwierdza pozostałe wiersze do wysłania do SQL Server.
IBCPSession::BCPExec (OLE DB) Wykonuje operację kopiowania masowego.
IBCPSession::BCPInit (OLE DB) Inicjalizuje strukturę kopiowania masowego, wykonuje sprawdzanie błędów, weryfikuje, czy dane i nazwy plików formatu są poprawne, a następnie je otwiera.
IBCPSession::BCPReadFmt (OLE DB) Odczytuje informacje o formacie dla każdej kolumny z pliku formatu.
IBCPSession::BCPWriteFmt (OLE DB) Zapisuje informacje o formacie dla każdej kolumny do pliku formatującego.