Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
Van toepassing op:SQL Server
Azure SQL Database
Azure SQL Managed Instance
Azure Synapse Analytics
Je kunt direct bulk kopiëren van programmavariabelen. Na het toewijzen van variabelen om de gegevens voor een rij vast te houden en bcp_init aan te roepen om de bulkkopie te starten, roep bcp_bind voor elke kolom aan om de locatie en het formaat van de programmavariabele die aan de kolom gekoppeld moet worden aan te geven. Vul elke variabele met data en roep bcp_sendrow aan om één rij data naar de server te sturen. Herhaal het proces van het invullen van de variabelen en het aanroepen van bcp_sendrow totdat alle rijen naar de server zijn gestuurd, en roep dan bcp_done aan om aan te geven dat de bewerking voltooid is.
De parameter bcp_bindpData bevat het adres van de variabele die aan de kolom wordt gebonden. De gegevens voor elke kolom kunnen op twee manieren worden opgeslagen:
Wijs één variabele toe om de data vast te houden.
Wijs een indicatorvariabele toe, gevolgd direct door de datavariabele.
De indicatorvariabele geeft de lengte van de data aan voor kolommen met variabele lengte, en geeft ook NULL-waarden aan als de kolom NULLs toestaat. Als slechts een datavariabele wordt gebruikt, wordt het adres van deze variabele opgeslagen in de bcp_bindpData-parameter . Als een indicatorvariabele wordt gebruikt, wordt het adres van de indicatorvariabele opgeslagen in de bcp_bindpData-parameter . De bulkkopieerfuncties berekenen de locatie van de datavariabele door de parameters bcp_bindcbIndicator en pData toe te voegen.
bcp_bind ondersteunt drie methoden voor het omgaan met data van variabele lengte:
Gebruik cbData met alleen een datavariabele. Plaats de lengte van de data in cbData. Elke keer dat de lengte van de te kopiëren data verandert, roep bcp_collen aan om cbData te resetten. Als een van de andere twee methoden wordt gebruikt, specificeer dan SQL_VARLEN_DATA voor cbData. Als alle datawaarden die voor een kolom worden aangegeven NULL zijn, specificeer dan SQL_NULL_DATA voor cbData.
Gebruik indicatorvariabelen. Naarmate elke nieuwe datawaarde in de datavariabele wordt geplaatst, sla je de lengte van de waarde op in de indicatorvariabele. Als een van de andere twee methoden wordt gebruikt, specificeer 0 voor cbIndicator.
Gebruik terminator-pointers. Laad de parameter bcp_bindpTerm met het adres van het bitpatroon dat de data beëindigt. Als een van de andere twee methoden wordt gebruikt, specificeer dan NULL voor pTerm.
Al deze drie methoden kunnen op dezelfde bcp_bind aanroep worden gebruikt, waarbij de specificatie wordt gebruikt die resulteert in de kleinste hoeveelheid data die wordt gekopieerd.
De parameter bcp_bindtype gebruikt DB-Library datatype-identificaties, niet ODBC-datatype-identificaties. DB-Library datatype-identificaties zijn gedefinieerd in sqlncli.h voor gebruik met de ODBC bcp_bind-functie .
Bulk-kopieerfuncties ondersteunen niet alle ODBC C-datatypes. Zo ondersteunen de bulk-kopieerfuncties de ODBC SQL_C_TYPE_TIMESTAMP-structuur niet, dus gebruik SQLBindCol of SQLGetData om ODBC SQL_TYPE_TIMESTAMP data om te zetten naar een SQL_C_CHAR variabele. Als je vervolgens bcp_bind gebruikt met een typeparameter SQLCHARACTER om de variabele aan een SQL Server datetime-kolom te binden, zetten de bulk-kopieerfuncties de timestamp escape clausule in de tekenvariabele om naar het juiste datetime-formaat.
De volgende tabel geeft een overzicht van de aanbevolen datatypen om te gebruiken bij het mappen van een ODBC SQL-datatype naar een SQL Server-datatype.
| ODBC SQLdata-type | ODBC C datatype | bcp_bind typeparameter | SQL Server-gegevenstype |
|---|---|---|---|
| SQL_CHAR | SQL_C_CHAR | SQLCHARACTER |
character char |
| SQL_VARCHAR | SQL_C_CHAR | SQLCHARACTER |
varchar teken varieert Variatie van de char sysname |
| SQL_LONGVARCHAR | SQL_C_CHAR | SQLCHARACTER | tekst |
| SQL_WCHAR | SQL_C_WCHAR | SQLNCHAR | nchar |
| SQL_WVARCHAR | SQL_C_WCHAR | SQLNVARCHAR | nvarchar |
| SQL_WLONGVARCHAR | SQL_C_WCHAR | SQLNTEXT | ntext |
| SQL_DECIMAL | SQL_C_CHAR | SQLCHARACTER |
decimal dec money smallmoney |
| SQL_NUMERIC | SQL_C_NUMERIC | SQLNUMERICN | numeric |
| SQL_BIT | SQL_C_BIT | SQLBIT | bit |
| SQL_TINYINT (ondertekend) | SQL_C_SSHORT | SQLINT2 | smallint |
| SQL_TINYINT (niet ondertekend) | SQL_C_UTINYINT | SQLINT1 | tinyint |
| SQL_SMALL_INT (ondertekend) | SQL_C_SSHORT | SQLINT2 | smallint |
| SQL_SMALL_INT (niet ondertekend) | SQL_C_SLONG | SQLINT4 |
int geheel getal |
| SQL_INTEGER (ondertekend) | SQL_C_SLONG | SQLINT4 |
int geheel getal |
| SQL_INTEGER (niet ondertekend) | SQL_C_CHAR | SQLCHARACTER |
decimal dec |
| SQL_BIGINT (ondertekend en ongetekend) | SQL_C_CHAR | SQLCHARACTER | bigint |
| SQL_REAL | SQL_C_FLOAT | SQLFLT4 | real |
| SQL_FLOAT | SQL_C_DOUBLE | SQLFLT8 | float |
| SQL_DOUBLE | SQL_C_DOUBLE | SQLFLT8 | float |
| SQL_BINARY | SQL_C_BINARY | SQLBINARY |
binary timestamp |
| SQL_VARBINARY | SQL_C_BINARY | SQLBINARY |
varbinary binaire variatie |
| SQL_LONGVARBINARY | SQL_C_BINARY | SQLBINARY | image |
| SQL_TYPE_DATE | SQL_C_CHAR | SQLCHARACTER |
datetime smalldatetime |
| SQL_TYPE_TIME | SQL_C_CHAR | SQLCHARACTER |
datetime smalldatetime |
| SQL_TYPE_TIMESTAMP | SQL_C_CHAR | SQLCHARACTER |
datetime smalldatetime |
| SQL_GUID | SQL_C_GUID | SQLUNIQUEID | uniqueidentifier |
| SQL_INTERVAL_ | SQL_C_CHAR | SQLCHARACTER | char |
SQL Server heeft geen gesigneerde tinyint, niet-ondertekende smallint of ongetekende int-datatypen. Om verlies van datawaarden bij het migreren van deze datatypes te voorkomen, maak je de SQL Server-tabel aan met het op één na grootste gehele datatype. Om te voorkomen dat gebruikers later waarden buiten het bereik toevoegen dat door het oorspronkelijke datatype is toegestaan, pas je een regel toe op de kolom SQL Server om de toegestane waarden te beperken tot het bereik dat door het datatype in de oorspronkelijke bron wordt ondersteund:
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 ondersteunt intervaldatatypes niet direct. Een applicatie kan echter interval-escape-sequenties opslaan als tekenreeksen in een SQL Server-tekenkolom. De applicatie kan ze lezen voor later gebruik, maar ze kunnen niet in Transact-SQL statements worden gebruikt.
De bulkkopieerfuncties kunnen worden gebruikt om snel data te laden in SQL Server die is gelezen uit een ODBC-databron. Gebruik SQLBindCol om de kolommen van een resultaatset te binden aan programmavariabelen, en gebruik vervolgens bcp_bind om dezelfde programmavariabelen aan een bulk-kopieeroperatie te binden. Het aanroepen van SQLFetchScroll of SQLFetch haalt vervolgens een reeks gegevens uit de ODBC-databron op in de programmavariabelen, en roept bcp_sendrow bulk de data van de programmavariabelen aan naar SQL Server .
Een applicatie kan de bcp_colptr functie gebruiken wanneer het adres van de oorspronkelijk in de bcp_bindpData-parameter gespecificeerde datavariabele moet worden gewijzigd. Een applicatie kan de bcp_collen-functie gebruiken wanneer het de oorspronkelijk gespecificeerde gegevenslengte in de bcp_bindcbData-parameter moet wijzigen.
Je kunt data niet van SQL Server in programmavariabelen lezen met bulkkopie; er is niets zoals een "bcp_readrow"-functie. Je kunt alleen data van de applicatie naar de server sturen.