bcp_readfmt
van toepassing op:
SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)
Hiermee leest u een definitie van de bestandsindeling van het opgegeven indelingsbestand.
Syntaxis
RETCODE bcp_readfmt (
HDBC hdbc,
LPCTSTR szFormatFile);
Unicode- en ANSI-namen:
- bcp_readfmtA (ANSI)
- bcp_readfmtW (Unicode)
Argumenten
hdbc-
Is de ODBC-verbindingshandgreep waarvoor bulksgewijs kopiëren is ingeschakeld.
szFormatFile-
Is het pad en de bestandsnaam van het bestand met de indelingswaarden voor het gegevensbestand.
Retourneert
SLAGEN OF MISLUKKEN.
Opmerkingen
Nadat bcp_readfmt de notatiewaarden heeft gelezen, worden de juiste aanroepen naar bcp_columns en bcp_colfmtuitgevoerd. U hoeft geen indelingsbestand te parseren en deze aanroepen uit te voeren.
Als u een indelingsbestand wilt behouden, roept u bcp_writefmtaan. Aanroepen naar bcp_readfmt kunnen verwijzen naar opgeslagen indelingen. Zie bcp_initvoor meer informatie.
Het hulpprogramma voor bulksgewijs kopiëren (bcp) kan ook door de gebruiker gedefinieerde gegevensindelingen opslaan in bestanden waarnaar kan worden verwezen door bcp_readfmt. Zie voor meer informatie over het hulpprogramma bcp en de structuur van bcp gegevensbestanden bulksgewijs importeren en exporteren van gegevens (SQL Server).
De BCPDELAYREADFMT- waarde van de parameter eOption van bcp_control wijzigt het gedrag van bcp_readfmt.
Notitie
Het indelingsbestand moet worden geproduceerd door versie 4.2 of hoger van het bcp-hulpprogramma.
Voorbeeld
// 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.