A wrapper for a system call to the bcp utility which bulk inserts to SQL Server.
bcpImport(
x,
server,
database,
table,
driver = "SQL Server",
maxerrors = 10,
batchsize = 1000,
packetsize = 4096,
regional = FALSE,
trustedconnection = TRUE,
username,
password,
fieldterminator = "\t",
rowterminator = ifelse(.Platform$OS.type == "windows", "\r\n", "\n"),
overwrite = FALSE,
spatialtype = c("geometry", "geography"),
...
)
dataframe object or path to file
the instance of SQL Server to which to connect
specifies the database to connect to
Name of the source table when exporting from SQL Server. For specifying the
schema in the table name see DBI::SQL
or DBI::Id
.
name of driver for ODBC connection
maximum number of errors allowed
number of rows to write at a time; 10,000 to 50,000 is a starting recommendation
size of packets to be sent
Specifies that currency, date, and time data is bulk copied into SQL Server using the regional format defined for the locale setting of the client computer
use integrated security, username and password are not required
login ID
password for login ID
character separator for columns
character separator for rows--new lines
Whether to overwrite the table if it exists
spatial data type for schema https://docs.microsoft.com/en-us/sql/relational-databases/spatial/spatial-data-types-overview,
ignored if x
is not an 'sf' object
arguments to pass to system2
Output from system2
. See ...
to redirect output.
If x is a dataframe object, data.table::fwrite
is used to write the
in memory object to disk in a temporary file that is deleted when the
function exits. The fieldterminator
and rowterminator
are
ignored in this case.
If overwrite
is TRUE
, any existing table of the same name
will be deleted and the schema is inferred from DBI::dbCreateTable
. To
use a customized schema, create the schema before calling the function and
use overwrite=FALSE
.
If x is a sf object, the geometry column is converted to binary and written to the database before conversion to geometry/geometry data type. The EPSG code is automatically read from the sf object and used as the SRID.
To override the default path to the bcp command line utility, set the
bcputility.bcp.path
option.