postgresqlSupport(RPostgreSQL)
postgresqlSupport()所属R语言包：RPostgreSQL
Support Functions
支持功能
译者：生物统计家园网 机器人LoveR
描述----------Description----------
These functions are the workhorse behind the RPostgreSQL package, but users need not invoke these directly. For details see PostgreSQL.
这些功能的主力背后的RPostgreSQL包，但用户不必直接调用这些。有关详细信息，请参阅PostgreSQL。
用法----------Usage----------
## PostgreSQLDriver-related
postgresqlInitDriver(max.con=16, fetch.default.rec = 500, force.reload=FALSE)
postgresqlDriverInfo(obj, what, ...)
postgresqlDescribeDriver(obj, verbose = FALSE, ...)
postgresqlCloseDriver(drv, ...)
## PostgreSQLConnection-related
postgresqlNewConnection(drv,user,password,host,dbname,port,tty,options)
postgresqlCloneConnection(con, ...)
postgresqlConnectionInfo(obj, what, ...)
postgresqlDescribeConnection(obj, verbose = FALSE, ...)
postgresqlCloseConnection(con, ...)
## PostgreSQLResult-related
postgresqlExecStatement(con, statement)
postgresqlFetch(res, n=0, ...)
postgresqlQuickSQL(con, statement)
postgresqlResultInfo(obj, what, ...)
postgresqlDescribeResult(obj, verbose = FALSE, ...)
postgresqlCloseResult(res, ...)
postgresqlDescribeFields(res, ...)
## data mappings, convenience functions, and extensions
postgresqlDataType(obj, ...)
postgresqlReadTable(con, name, row.names = "row.names", check.names = TRUE, ...)
postgresqlWriteTable(con, name, value, field.types, row.names = TRUE,
overwrite=FALSE, append=FALSE, ..., allow.keywords = FALSE)
postgresqlpqExec(con, statement)
postgresqlCopyIn(con, filename)
postgresqlgetResult(con)
postgresqlEscapeStrings(con, preescapedstring)
postgresqlQuoteId(identifiers)
postgresqlTableRef(identifiers)
postgresqlImportFile(con, name, value, field.types, overwrite=FALSE,
append=FALSE, header, row.names, nrows=50, sep=",", eol="\n",
skip = 0, quote="\"", ...)
## Transaction Management
postgresqlTransactionStatement(con, statement)
参数----------Arguments----------
参数：max.con
positive integer specifying maximum number of open connections. The current default of 10 is hardcoded in the C code.
正整数，指定打开的连接的最大数量。目前在C代码中硬编码的默认值为10。
参数：fetch.default.rec
default number of rows to fetch (move to R/S-Plus). This default is used in postgresqlFetch. The default is 500.
要抓取的行数（默认移动到R / S-PLUS）。使用预设的postgresqlFetch。默认值是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 PostgreSQL DBI objects (e.g., PostgreSQLConnection, PostgreSQLResult).
任何PostgreSQL的DBI对象（例如，PostgreSQLConnection，PostgreSQLResult）。
参数：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 PostgreSQLDriver object as produced by postgresqlInitDriver.
PostgreSQLDriver对象产生的postgresqlInitDriver。
参数：con
an PostgreSQLConnection object as produced by postgresqlNewConnection and postgresqlCloneConnection.
PostgreSQLConnection对象的产生postgresqlNewConnection和postgresqlCloneConnection。
参数：res
an PostgreSQLResult object as produced by by postgresqlExecStatement and postgresqlgetResult.
PostgreSQLResult对象作为所产生的postgresqlExecStatement和postgresqlgetResult。
参数：user
a character string with the PostgreSQL's user name.
一个字符串与PostgreSQL的用户名。
参数：password
character string with the PostgreSQL's password.
PostgreSQL的密码的字符串。
参数：dbname
character string with the PostgreSQL database name.
与PostgreSQL数据库名称的字符串。
参数：host
character string with the name (or IP address) of the machine hosting the database. Default is "", which is interpreted as localhost by the PostgreSQL's API.
与主机的数据库的名称（或IP地址）的字符串。默认是""PostgreSQL的API，它被解释为localhost。
参数：port
(optional) positive integer specifying the TCP port number that the PostgreSQL server is listening to. Consult the PostgreSQL documentation for details.
（可选）的正整数，指定的TCP端口号，，PostgreSQL服务器监听到。请参考PostgreSQL文件的详细信息。
参数：tty
Ignored (formerly, this specified where to send server debug output)
忽略（以前，这个指定的发送服务器的调试输出）
参数：options
Command-line options to be sent to the server
被发送到服务器的命令行选项
参数：force
logical indicating whether to close a connection that has open result sets. The default is FALSE.
逻辑表示是否要关闭的连接打开的结果集。默认的FALSE。
参数：statement
character string holding one (and only one) SQL statement.
字符的字符串（只有一个）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 postgresqlInit.
来从给定的结果集的行数。值-1表示要检索的所有行。默认设置为0，指定要提取什么fetch.default.rec指定了驱动程序的初始化过程中postgresqlInit。
参数：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 PostgreSQLSQLType.
R / S-PLUS领域的valueSQL数据类型的数据框的列表指定的映射。默认为sapply(value,SQLDataType)，看到PostgreSQLSQLType。
参数：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，如果第一行少一个列的第二行。
参数：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。
参数：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.
输入文件中读取数据前跳过的行数。
参数：quote
the quote character used in the input file (defaults to \".
在报价中使用的字符输入文件（默认为\"。
参数：allow.keywords
logical indicating whether column names that happen to be PostgreSQL keywords be used as column names in the resulting relation (table) being written. Defaults to FALSE, forcing postgresqlWriteTable to modify column names to make them legal PostgreSQL identifiers.
逻辑恰好是PostgreSQL的关键字是否列名作为列名的关系（表）被写入。默认为FALSE，迫使postgresqlWriteTable修改列名使他们法律PostgreSQL的标识。
参数：preescapedstring
character string to be escaped
被转义字符串
参数：identifiers
one or more character strings to be used as identfier in SQL statement
要用作identfier在SQL语句的一个或多个字符串
参数：filename
character string indicating the file which contains the data to be copied to the PostgreSQL backend
字符串表示的文件，其中包含的数据将被复制到PostgreSQL后端的
参数：...
placeholder for future use.
占位符，以备将来使用。
值----------Value----------
postgresqlInitDriver returns an PostgreSQLDriver object.
postgresqlInitDriver返回PostgreSQLDriver对象。
postgresqlDriverInfo returns a list of name-value metadata pairs.
postgresqlDriverInfo返回一个列表的名称 - 值元数据对。
postgresqlDescribeDriver returns NULL (displays the object's metadata).
postgresqlDescribeDriver返回NULL（显示对象的元数据）。
postgresqlCloseDriver returns a logical indicating whether the operation succeeded or not.
postgresqlCloseDriver返回一个逻辑指示操作是否成功与否。
postgresqlNewConnection returns an PostgreSQLConnection object.
postgresqlNewConnection返回PostgreSQLConnection对象。
postgresqlCloneConnection returns an PostgreSQLConnection object.
postgresqlCloneConnection返回PostgreSQLConnection对象。
postgresqlConnectionInforeturns a list of name-value metadata pairs.
postgresqlConnectionInfo返回一个列表的名称 - 值元数据对。
postgresqlDescribeConnection returns NULL (displays the object's metadata).
postgresqlDescribeConnection返回NULL（显示对象的元数据）。
postgresqlCloseConnection returns a logical indicating whether the operation succeeded or not.
postgresqlCloseConnection返回一个逻辑指示操作是否成功与否。
postgresqlExecStatement returns an PostgreSQLResult object.
postgresqlExecStatement返回PostgreSQLResult对象。
postgresqlFetch returns a data.frame.
postgresqlFetch返回一个数据框。
postgresqlQuickSQL returns either a data.frame if the statement is a select-like or NULL otherwise.
postgresqlQuickSQL返回一个数据框，如果statement是或select，否则返回null。
postgresqlDescribeResult returns NULL (displays the object's metadata).
postgresqlDescribeResult返回NULL（显示对象的元数据）。
postgresqlCloseResult returns a logical indicating whether the operation succeeded or not.
postgresqlCloseResult返回一个逻辑指示操作是否成功与否。
postgresqlDescribeFields returns a data.frame with one row per field with columns name, Sclass, type, len, precision, scale, and nullOK which fully describe each field in a result set. Except for Sclass (which shows the mapping of the field type into an R/S-Plus class) all the information pertains to PostgreSQL's data storage attributes.
postgresqlDescribeFields返回一个数据框，每一个行字段，列name，Sclass，type，len，precision，<X >和scale，“这充分说明中的每个字段的结果集。除nullOK（显示映射到R / S-PLUS类）的所有信息适用于PostgreSQL的数据存储属性的字段类型。
postgresqlReadTable returns a data.frame with the contents of the DBMS table.
postgresqlReadTable返回一个数据框的DBMS表的内容。
postgresqlWriteTable returns a logical indicating whether the operation succeeded or not.
postgresqlWriteTable返回一个逻辑指示操作是否成功与否。
postgresqlpqExec returns NUL (executes the statement but does not try to get result. This is called internally from postgresqlWriteTable before postgresqlCopyInDataframe
postgresqlpqExec返回NUL（执行该语句，但不会尝试得到的结果。这就是所谓的从内部postgresqlWriteTable前postgresqlCopyInDataframe
postgresqlCopyIn returns NULL (copies the content of the file through the socket connection to postgresql backend. This should be used just after COPY tablename FROM STDIN query. This is not used now.)
postgresqlCopyIn返回NULL（通过socket连接的文件的内容复制到PostgreSQL后端，这应该是之后使用COPY从标准输入查询表名，这是现在不用了。）
postgresqlCopyInDataframe returns NULL (copies the content of the dataframe through the socket connection to postgresql backend. Strings are encoded as UTF-8 for transfer. The client_encoding should be set to UTF-8. This should be used just after COPY tablename FROM STDIN query.)
postgresqlCopyInDataframe回报NULL（通过socket连接数据框的内容复制到PostgreSQL后端的字符串编码为UTF-8转移。客户端应设置为UTF-8。应使用复制后的表名FROM STDIN查询。）
postgresqlgetResult returns an PostgreSQLResult object. This is called after completion of execution of postgresqlpqExec.
postgresqlgetResult返回PostgreSQLResult对象。这就是所谓的完成后执行postgresqlpqExec的。
postgresqlEscapeStrings returns a character string which is escaped properly so that it can be surrounded with a single quote and used as literal in SQL. The escape procedure is dependent on the character encoding of the connection.
postgresqlEscapeStrings这是正确转义，以便它可以用单引号包围，并作为文字在SQL返回一个字符串。在逃生的过程是依赖于连接的字符编码。
postgresqlQuoteId returns a character string which is quoted as identifier. Returns vector on vector arguemnt.
postgresqlQuoteId返回一个字符串作为标识符被引用。返回矢量的矢量arguemnt。
postgresqlTableRef returns a character string which is quoted as identifier. Reterns a charcter string concatenated with "." so that "dbname"."schemaname"."tablename" reference is created upon c("dbname", "schemaname", "tablename") arguemnt.
postgresqlTableRef返回一个字符串作为标识符被引用。 Reterns一个字符内的字符串连接在一起的“。”，“dbname”的。“SCHEMANAME”，“表名”引用时创建C（“dbname”的中，“SCHEMANAME”，“表名”）arguemnt。
postgresqlDataType retuns a character string with the closest
postgresqlDataType retuns与最接近的一个字符串
postgresqlResultInfo returns a list of name-value metadata pairs.
postgresqlResultInfo返回一个列表的名称 - 值元数据对。
postgresqlTransactionStatement returns a logical indicating whether the operation succeeded or not.
postgresqlTransactionStatement返回一个逻辑指示操作是否成功与否。
常量----------Constants----------
.PostgreSQLPkgName (currently "RPostgreSQL"), .PostgreSQLPkgVersion (the R package version), .PostgreSQLPkgRCS (the RCS revision), .PostgreSQL.NA.string (character that PostgreSQL uses to denote NULL on input), .PostgreSQLSQLKeywords (a lot!) .conflicts.OK.
.PostgreSQLPkgName（目前"RPostgreSQL"）.PostgreSQLPkgVersion（R程序包的版本），.PostgreSQLPkgRCS（RCS修订版），.PostgreSQL.NA.string（字符PostgreSQL用于表示 NULL输入），.PostgreSQLSQLKeywords（很多！）.conflicts.OK。
转载请注明:出自 生物统计家园网(http://www.biostatistic.net)。
注：
注1：为了方便大家学习，本文档为生物统计家园网机器人LoveR翻译而成，仅供个人R语言学习参考使用，生物统计家园保留版权。
注2：由于是机器人自动翻译，难免有不准确之处，使用时仔细对照中、英文内容进行反复理解，可以帮助R语言的学习。
注3：如遇到不准确之处，请在本贴的后面进行回帖，我们会逐渐进行修订。
|
发表于 2012-9-28 20:10:36
