R语言 RSQLite包 sqliteSupport()函数中文帮助文档(中英文对照)

loveR

sqliteSupport(RSQLite)
sqliteSupport()所属R语言包：RSQLite

                                        Support Functions
                                         支持功能

                                         译者：生物统计家园网 机器人LoveR

描述----------Description----------

These functions are the workhorses behind the RSQLite package, but users need not invoke these directly.
这些功能的工作母机背后的RSQLite的包，但用户并不需要直接调用这些。


用法----------Usage----------


   ## SQLiteDriver-related
   sqliteInitDriver(max.con=16, fetch.default.rec = 500, force.reload=FALSE,
                    shared.cache=FALSE)
   sqliteDriverInfo(obj, what, ...)
   sqliteDescribeDriver(obj, verbose = FALSE, ...)
   sqliteCloseDriver(drv, ...)

   ## SQLiteConnection-related
   sqliteNewConnection(drv, dbname, loadable.extensions=TRUE, cache_size=NULL,
                       synchronous=0, flags = NULL, vfs = NULL)
   sqliteConnectionInfo(obj, what, ...)
   sqliteDescribeConnection(obj, verbose = FALSE, ...)
   sqliteCloseConnection(con, ...)

   ## SQLiteResult-related
   sqliteExecStatement(con, statement, bind.data=NULL)
   sqliteTransactionStatement(con, statement)
   sqliteFetch(res, n=0, ...)
   sqliteQuickSQL(con, statement, bind.data=NULL, ...)
   sqliteResultInfo(obj, what, ...)
   sqliteDescribeResult(obj, verbose = FALSE, ...)
   sqliteCloseResult(res, ...)

   ## data mappings and convenience functions
   sqliteDataType(obj, ...)
   sqliteReadTable(con, name, row.names = "row_names", check.names = TRUE, ...)
   sqliteImportFile(con, name, value, field.types, overwrite=FALSE,
      append=FALSE, header, row.names, nrows=50, sep=",", eol="\n",
      skip = 0, ...)
   sqliteWriteTable(con, name, value, row.names = TRUE,
                    overwrite = FALSE, append = FALSE,
                    field.types = NULL, ...)
   sqliteTableFields(con, name, ...)



参数----------Arguments----------

参数：max.con
positive integer specifying maximum number of open connections. The default is 10.  Note that since SQLite is embedded in R/S-Plus connections are simple, very efficient direct C calls.  
正整数，指定打开的连接的最大数量。默认值是10。需要注意的是，由于SQLite是一个嵌入式的R / S-PLUS连接很简单，非常高效的直接的C调用。


参数：fetch.default.rec
default number of rows to fetch (move to R/S-Plus).  This default is used in sqliteFetch. The default is 500.  
要抓取的行数（默认移动到R / S-PLUS）。使用预设的sqliteFetch。默认值是500。


参数：force.reload
logical indicating whether to re-initialize the driver.  This may be useful if you want to change the defaults (e.g., fetch.default.rec). Note that the driver is a singleton (subsequent inits just returned the previously initialized driver, thus this argument).  
逻辑表明是否要重新初始化驱动程序。这可能是有用的，如果你要更改的默认值（例如，fetch.default.rec）。注意：该驱动程序是一个单独的（，随后初始化设置只是返回之前初始化驱动程序，因此这种说法）。


参数：obj
any of the SQLite DBI objects (e.g., SQLiteConnection, SQLiteResult).  
任何SQLite的DBI对象（例如，SQLiteConnection，SQLiteResult）。


参数：what
character vector of metadata to extract, e.g., "version", "statement", "isSelect".  
字符向量的元数据提取，例如，“版本”，“声明”，“isSelect”。


参数：verbose
logical controlling how much information to display. Defaults to FALSE.  
逻辑控制显示多少信息。默认为FALSE的。


参数：drv
an SQLiteDriver object as produced by sqliteInit.  
SQLiteDriver对象产生的sqliteInit。


参数：con
an SQLiteConnection object as produced by sqliteNewConnection.  
SQLiteConnection对象产生的sqliteNewConnection。


参数：res
an SQLiteResult object as produced by by sqliteExecStatement.  
SQLiteResult对象产生，由sqliteExecStatement。


参数：dbname
character string with the SQLite database file name (SQLite, like Microsoft's Access, stores an entire database in one file).  
字符串的SQLite数据库文件名（如微软的Access，SQLite的，整个数据库存储在一个文件中）。


参数：loadable.extensions
logical describing whether loadable extensions will be enabled for this connection. The default is FALSE.  
逻辑描述是否可加载的扩展功能将被启用此连接。默认值是FALSE。


参数：flags
An integer that will be interpretted as a collection of flags by the SQLite API.  If NULL, the flags will default to SQLITE_RWC which will open the file in read/write mode and create the file if it does not exist.  You can use SQLITE_RW to open in read/write mode and SQLITE_RO to open in read only mode.  In both cases, an error is raised if the database file does not already exist.  See http://sqlite.org/c3ref/open.html for more details.  
一个整数，将被释为标志的集合SQLite的API。如果NULL，标志将默认SQLITE_RWC这将打开该文件，在读/写模式并创建文件，如果它不存在。您可以使用SQLITE_RW开在读/写模式和SQLITE_RO在只读模式下打开。在这两种情况下，抛出一个错误，如果数据库文件不存在的。更多详细信息，请参见http://sqlite.org/c3ref/open.html。


参数：shared.cache
logical describing whether shared-cache mode should be enabled on the SQLite driver. The default is FALSE.  
逻辑描述共享缓存模式是否应启用SQLite的驱动程序。默认值是FALSE。


参数：bind.data
a data frame which will be used to bind variables in the statement.  
的数据框将使用绑定变量在声明中。


参数：cache_size
positive integer to pass to the PRAGMA cache_size;  this changes the maximum number of disk pages that SQLite will hold in memory (SQLite's default is 2000 pages).  
正整数传递给PRAGMA cache_size;这个改变的最大数量的磁盘页，SQLite将保存在内存中（SQLite的预设值是2000页）。


参数：synchronous
values the PRAGMA synchronous flag, possible values are 0, 1, or 2 or the corresponding strings "OFF", "NORMAL", or "FULL". The RSQLite package uses a default of 0 (OFF), although SQLite's default is 2 (FULL) as of version 3.2.8. Users have reported significant speed ups using sychronous="OFF", and the SQLite documentation itself implies considerably improved performance at the very modest risk of database corruption in the unlikely case of the operating system (not the R application) crashing.  
重视PRAGMA synchronous标志，可能的值是0，1，或2或对应的字符串为“OFF”，“正常”，或“FULL”。 RSQLite包使用默认设置为0（OFF），，虽然SQLite的默认值是2（FULL）版本3.2.8。用户已经报告了显着的速度提升，使用sychronous="OFF"，和SQLite的文档本身就意味着大大提高了性能非常温和的操作系统（而不是R应用）崩溃，在这种情况不太可能发生数据库损坏的风险。


参数：vfs
The name of the SQLite virtual filesystem module to use.  If NULL, the default module will be used.  Module availability depends on your operating as summarized by the following table:   <table summary="Rd table"> <tr>  <td align="right">   module  </td><td align="left"> OSX </td><td align="left"> Unix (not OSX) </td><td align="left"> Windows</td> </tr> <tr>  <td align="right">   "unix-none"     </td><td align="left"> Y   </td><td align="left"> Y      </td><td align="left"> N</td> </tr> <tr>  <td align="right">   "unix-dotfile"  </td><td align="left"> Y   </td><td align="left"> Y      </td><td align="left"> N</td> </tr> <tr>  <td align="right">   "unix-flock"    </td><td align="left"> Y   </td><td align="left"> N      </td><td align="left"> N</td> </tr> <tr>  <td align="right">   "unix-afp"      </td><td align="left"> Y   </td><td align="left"> N      </td><td align="left"> N</td> </tr> <tr>  <td align="right">   "unix-posix"    </td><td align="left"> Y   </td><td align="left"> N      </td><td align="left"> N</td> </tr> <tr>  <td align="right"> </td> </tr>  </table>  See http://www.sqlite.org/compile.html for details.  
使用的SQLite虚拟文件系统模块的名称。如果NULL，默认的模块将使用。模块的可用性取决于您的操作总结如下表所示：<table summary="Rd table"> <TR> <td align="right">模块</ TD> <TD ALIGN="LEFT"> OSX </ TD > <td ALIGN="LEFT"> UNIX（OSX）</ TD> <TD ALIGN="LEFT">的Windows </ TD> </ TR> <TR> <td align="right">“UNIX无“</ TD> <TD ALIGN="LEFT"> Y </ TD> <TD ALIGN="LEFT"> Y </ TD> <TD ALIGN="LEFT">&#209;</ TD> </ TR> <TR > <td align="right">“UNIX dotfile”</ TD> <TD ALIGN="LEFT"> Y </ TD> <TD ALIGN="LEFT"> Y </ TD> <TD对齐=“左边“> N </ TD> </ TR> <TR> <td align="right">”UNIX的羊群“</ TD> <TD ALIGN="LEFT"> Y </ TD> <TD对齐=”左边“> N </ TD> <TD ALIGN="LEFT">&#209;</ TD> </ TR> <TR> <td align="right">”UNIX-法新社“</ TD> <TD对齐=”左边“> Y </ TD> <TD ALIGN="LEFT">&#209;</ TD> <TD ALIGN="LEFT">&#209;</ TD> </ TR> <TR> <td align="right">”UNIX是POSIX的“</ TD> <TD ALIGN="LEFT"> Y </ TD> <TD ALIGN="LEFT">&#209;</ TD> <td ALIGN="LEFT">&#209;</ TD> </ TR> <TR> <td align="right"> </ TD> </ TR> </ TABLE>有关详细信息，请参阅http://www.sqlite.org/compile.html“。


参数：force
logical indicating whether to close a connection that has open result sets.  The default is FALSE.  
逻辑表示是否要关闭的连接打开的结果集。默认的FALSE。


参数：statement
character string holding SQL statements.  
SQL语句字符串控股。


参数：n
number of rows to fetch from the given result set. A value of -1 indicates to retrieve all the rows.  The default of 0 specifies to extract whatever the fetch.default.rec was specified during driver initialization sqliteInit.  
来从给定的结果集的行数。值-1表示要检索的所有行。默认设置为0，指定要提取什么fetch.default.rec指定了驱动程序的初始化过程中sqliteInit。


参数：name
character vector of names (table names, fields, keywords).  
字符向量名（表名，字段，关键字）。


参数：value
a data.frame.  
数据框。


参数：field.types
a list specifying the mapping from R/S-Plus fields in the data.frame value to SQL data types.  The default is sapply(value,SQLDataType), see SQLiteSQLType.  
R / S-PLUS领域的valueSQL数据类型的数据框的列表指定的映射。默认为sapply(value,SQLDataType)，看到SQLiteSQLType。


参数：row.names
a logical specifying whether to prepend the value data.frame row names or not.  The default is TRUE.  
逻辑指定是否要在前面加上value数据框行的名称或没有。默认的TRUE。


参数：check.names
a logical specifying whether to convert DBMS field names into legal S names. Default is TRUE.  
逻辑指定是否要转换的DBMS场到法律的姓名名称。默认是TRUE。


参数：overwrite
logical indicating whether to replace the table name with the contents of the data.frame value. The defauls is FALSE.  
逻辑表示是否替换表name与数据框value的内容。 defauls是FALSE。


参数：append
logical indicating whether to append value to the existing table name.  
逻辑表示是否追加value到现有的表name。


参数：header
logical, does the input file have a header line?  Default is the same heuristic used by read.table, i.e., TRUE if the first line has one fewer column that the second line.  
逻辑，并输入文件有标题行吗？默认值是相同的启发式使用read.table，即TRUE，如果第一行少一个列的第二行。


参数：nrows
number of lines to rows to import using read.table from the input file to create the proper table definition. Default is 50.  
数行行导入使用read.table从输入文件创建正确的表定义的。默认值是50。


参数：sep
field separator character.
字段分隔符。


参数：eol
end-of-line separator.
结束行分隔符。


参数：skip
number of lines to skip before reading data in the input file.  
输入文件中读取数据前跳过的行数。


参数：...
placeholder for future use.  
占位符，以备将来使用。


值----------Value----------

sqliteInitDriver returns an SQLiteDriver object.
sqliteInitDriver返回SQLiteDriver对象。

sqliteDriverInfo returns a list of name-value metadata pairs.
sqliteDriverInfo返回一个列表的名称 - 值元数据对。

sqliteDescribeDriver returns NULL (displays the object's metadata).
sqliteDescribeDriver返回NULL（显示对象的元数据）。

sqliteCloseDriver returns a logical indicating whether the operation succeeded or not.
sqliteCloseDriver返回一个逻辑指示操作是否成功与否。

sqliteNewConnection returns an SQLiteConnection object.
sqliteNewConnection返回SQLiteConnection对象。

sqliteConnectionInforeturns a list of name-value metadata pairs.
sqliteConnectionInfo返回一个列表的名称 - 值元数据对。

sqliteDescribeConnection returns NULL (displays the object's metadata).
sqliteDescribeConnection返回NULL（显示对象的元数据）。

sqliteCloseConnection returns a logical indicating whether the operation succeeded or not.
sqliteCloseConnection返回一个逻辑指示操作是否成功与否。

sqliteExecStatement returns an SQLiteResult object.
sqliteExecStatement返回SQLiteResult对象。

sqliteFetch returns a data.frame.
sqliteFetch返回一个数据框。

sqliteQuickSQL returns either a data.frame if the statement is a select-like or NULL otherwise.
sqliteQuickSQL返回一个数据框，如果statement是或select，否则返回null。

sqliteDescribeResult returns NULL (displays the object's metadata).
sqliteDescribeResult返回NULL（显示对象的元数据）。

sqliteCloseResult returns a logical indicating whether the operation succeeded or not.
sqliteCloseResult返回一个逻辑指示操作是否成功与否。

sqliteReadTable  returns a data.frame with the contents of the DBMS table.
sqliteReadTable返回一个数据框的DBMS表的内容。

sqliteWriteTable  returns a logical indicating whether the operation succeeded or not.
sqliteWriteTable返回一个逻辑指示操作是否成功与否。

sqliteImportFile  returns a logical indicating whether the operation succeeded or not.
sqliteImportFile返回一个逻辑指示操作是否成功与否。

sqliteTableFields returns a character vector with the table name field names.
sqliteTableFields返回一个字符矢量表name的字段名。

sqliteDataType retuns a character string with the closest SQL data type.  Note that SQLite is typeless, so this is mostly for creating table that are compatible across RDBMS.
sqliteDataType retuns与最接近的SQL数据类型的字符串。需要注意的是SQLite是无类型的，所以这是，大多用于创建表，同时兼容于RDBMS。

sqliteResultInfo returns a list of name-value metadata pairs.
sqliteResultInfo返回一个列表的名称 - 值元数据对。


常量----------Constants----------

.SQLitePkgName (currently "RSQLite"), .SQLitePkgVersion (the R package version), .SQLitePkgRCS (the RCS revision), .SQLitecle.NA.string (character that SQLite uses to denote NULL on input), .conflicts.OK.
.SQLitePkgName（目前"RSQLite"）.SQLitePkgVersion（R程序包的版本），.SQLitePkgRCS（RCS修订版），.SQLitecle.NA.string（SQLite使用字符来表示 NULL输入），.conflicts.OK。

The following constants can be used as the value of the flags argument to sqliteNewConnection to control the mode of the databse connection:
以下常量可以用作flags参数的值sqliteNewConnection控制的数据库对连接模式：

open the database in read/write mode and create the database file if
在读/写模式下，打开数据库，创建数据库文件，如果




SQLITE_RW open the database in read/write mode.
SQLITE_RW在读/写模式打开数据库。




SQLITE_RO open the database in read only mode.
SQLITE_RO在只读模式打开数据库。

转载请注明:出自 生物统计家园网(http://www.biostatistic.net)。


注：
注1：为了方便大家学习，本文档为生物统计家园网机器人LoveR翻译而成，仅供个人R语言学习参考使用，生物统计家园保留版权。
注2：由于是机器人自动翻译，难免有不准确之处，使用时仔细对照中、英文内容进行反复理解，可以帮助R语言的学习。
注3：如遇到不准确之处，请在本贴的后面进行回帖，我们会逐渐进行修订。