bcp_readfmt

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

Odczytuje definicję formatu pliku danych z określonego pliku formatu.

Składnia

  
RETCODE bcp_readfmt (  
        HDBC hdbc,  
        LPCTSTR szFormatFile);  

Nazwy Unicode i ANSI:

• bcp_readfmtA (ANSI)
• bcp_readfmtW (Unicode)

Argumenty

hdbc
Czy obsługa połączenia ODBC z obsługą kopiowania zbiorczego.

szFormatFile
To ścieżka i nazwa pliku pliku zawierającego wartości formatu pliku danych.

Zwraca

POWODZENIE lub NIEPOWODZENIE.

Uwagi

Gdy bcp_readfmt odczytuje wartości formatu, wykonuje odpowiednie wywołania bcp_columns i bcp_colfmt. Nie ma potrzeby analizowania pliku formatu i tworzenia tych wywołań.

Aby utrwały plik formatu, wywołaj metodę bcp_writefmt. Wywołania bcp_readfmt mogą odwoływać się do zapisanych formatów. Aby uzyskać więcej informacji, zobacz bcp_init.

Alternatywnie narzędzie do kopiowania zbiorczego (bcp) może zapisywać formaty danych zdefiniowanych przez użytkownika w plikach, do których można odwoływać się bcp_readfmt. Aby uzyskać więcej informacji na temat narzędzia bcp oraz struktury plików formatu danych bcp, zobacz zbiorcze importowanie i eksportowanie danych (SQL Server).

BCPDELAYREADFMT wartość parametru eOptionbcp_control modyfikuje zachowanie bcp_readfmt.

Nuta

Plik formatu musi być generowany przez wersję 4.2 lub nowszą narzędzia bcp.

Przykład

// Variables like henv not specified.  
HDBC      hdbc;  
DBINT      nRowsProcessed;  
  
// Application initiation, get an ODBC environment handle, allocate the  
// hdbc, and so on.  
...   
  
// Enable bulk copy prior to connecting on allocated hdbc.  
SQLSetConnectAttr(hdbc, SQL_COPT_SS_BCP, (SQLPOINTER) SQL_BCP_ON,  
   SQL_IS_INTEGER);  
  
// Connect to the data source, return on error.  
if (!SQL_SUCCEEDED(SQLConnect(hdbc, _T("myDSN"), SQL_NTS,  
   _T("myUser"), SQL_NTS, _T("myPwd"), SQL_NTS)))  
   {  
   // Raise error and return.  
   return;  
   }  
  
// Initialize bulk copy.   
if (bcp_init(hdbc, _T("myTable"), _T("myData.csv"),  
   _T("myErrors"),    DB_IN) == FAIL)  
   {  
   // Raise error and return.  
   return;  
   }  
  
if (bcp_readfmt(hdbc, _T("myFmtFile.fmt")) == FAIL)  
   {  
   // Raise error and return.  
   return;  
   }  
  
if (bcp_exec(hdbc, &nRowsProcessed) == SUCCEED)  
   {  
   cout << nRowsProcessed << " rows copied to SQL Server\n";  
   }  
  
// Carry on.  

Zobacz też

funkcje kopiowania zbiorczego