bcp_writefmt

Berlaku untuk: SQL Server (semua versi yang didukung) Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW)

Membuat file format yang berisi deskripsi format file data salinan massal saat ini.

Sintaks

  
RETCODE bcp_writefmt (  
        HDBC hdbc,  
        LPCTSTR szFormatFile);  

Argumen

hdbc
Adalah handel koneksi ODBC yang mendukung penyalinan massal.

szFormatFile
Adalah jalur dan nama file file pengguna untuk menerima nilai format untuk file data.

Mengembalikan

BERHASIL atau GAGAL.

Keterangan

File format menentukan format data file data yang dibuat oleh salinan massal. Panggilan ke bcp_columns dan bcp_colfmt menentukan format file data. bcp_writefmt menyimpan definisi ini dalam file yang dirujuk oleh szFormatFile. Untuk informasi selengkapnya, lihat bcp_init.

Untuk informasi selengkapnya tentang struktur file format data bcp, lihat Mengimpor dan Mengekspor Data Massal dengan Menggunakan Utilitas bcp (SQL Server).

Untuk memuat file format yang disimpan, gunakan bcp_readfmt.

Catatan

File format yang dihasilkan oleh bcp_writefmt hanya didukung oleh versi utilitas bcp yang didistribusikan dengan SQL Server versi 7.0 dan yang lebih baru.

Contoh

// 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_OUT) == FAIL)  
   {  
   // Raise error and return.  
   return;  
   }  
  
if (bcp_columns(hdbc, 3) == FAIL)  
   {  
   // Raise error and return.  
   return;  
   }  
  
bcp_colfmt(hdbc, 1, SQLCHARACTER, 0, SQL_VARLEN_DATA, '\t', 1, 1);  
bcp_colfmt(hdbc, 2, SQLCHARACTER, 0, SQL_VARLEN_DATA, '\t', 1, 2);  
bcp_colfmt(hdbc, 3, SQLCHARACTER, 0, SQL_VARLEN_DATA, '\t', 1, 3);  
  
if (bcp_writefmt(hdbc, _T("myFmtFile.fmt")) == FAIL)  
   {  
   // Raise error and return.  
   return;  
   }  
  
if (bcp_exec(hdbc, &nRowsProcessed) == SUCCEED)  
   {  
   printf_s("%ld rows copied from SQL Server\n", nRowsProcessed);  
   }  
  
// Carry on.  

Lihat juga

Fungsi Salin Massal