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

loveR

MySQL(RMySQL)
MySQL()所属R语言包：RMySQL

                                         Instantiate a MySQL client from the current R session
                                         从目前的R会话实例化一个MySQL客户端

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

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

This function creates and initializes a MySQL client. It returns an driver object that allows you to connect to one or several MySQL servers.
这个函数创建并初始化一个MySQL客户端。它返回一个驱动程序对象，它允许您连接到一个或多个MySQL服务器。


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


MySQL(max.con = 16, fetch.default.rec = 500, force.reload = FALSE)



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

参数：max.con
maximum number of connections that are intended to have open at one time. There's no intrinic limit, since strictly speaking this limit applies  to MySQL servers, but clients can have (at least in theory)  more than this.  Typically there are at most a handful of open connections, thus the internal RMySQL code uses a very simple linear search  algorithm to manage its connection table.  
意图具有一次打开的连接的最大数目。有没有intrinic的限制，因为严格来说，此限制适用于MySQL服务器，但客户可以（至少在理论上）以上。通常是在最少数的开放式连接，从而内部RMySQL代码使用了一个非常简单的线性搜索算法来管理其连接表。


参数：fetch.default.rec
number of records to fetch at one time from the database. (The fetch method uses this number as a default.)  
在一次从数据库中提取的记录的数量。 （fetch方法使用这个数字作为默认值。）


参数：force.reload
should the client code be reloaded (reinitialize)? Setting this to TRUE allows you to change default settings.  Notice that all connections should be closed before re-loading.  
应该重新加载客户端代码（重新初始化）？设置为TRUE，允许您更改默认设置。请注意，应关闭所有连接，然后再重新加载。


Details

详细信息----------Details----------

This object is a singleton, that is, on subsequent invocations it returns the same initialized object.
此对象是单身，那就是，在随后的调用返回相同的初始化的对象。

This implementation allows you to connect to multiple host servers and run multiple connections on each server simultaneously.
该实现连接多台主机服务器，在每台服务器上同时运行多个连接。


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

An object MySQLDriver that extends  dbDriver and  dbObjectId. This object is required to create connections to one or several MySQL database engines.
的对象MySQLDriver延伸dbDriver和dbObjectId。需要该对象来创建连接到一个或多个MySQL的数据库引擎。


副作用----------Side Effects----------

The R client part of the database communication is initialized, but note that connecting to the database engine needs to be done through calls to dbConnect.
R客户端的数据库通信初始化，但需要注意的是需要连接到数据库引擎通过调用dbConnect完成。


用户身份验证----------User authentication----------

The preferred method to pass authentication parameters to the server (e.g., user, password, host) is through the MySQL personal configuration file "\$HOME/.my.cnf" (or "c:/my.cnf" under Windows). Since specifying passwords on calls to  dbConnect is a very bad idea (and so is specifying passwords through shell variables), the client code parses the configuration file "\$HOME/.my.cnf"; this file consists of zero or more sections, each starting with a  line of the form [section-name], for instance
认证参数传递到服务器上（例如，用户名，密码，主机）的首选方法是通过MySQL的个人配置文件“\$HOME/.my.cnf（或c:/my.cnfWindows下）。由于调用dbConnect是一个非常糟糕的主意（和通过shell变量指定密码），客户端代码解析配置文件“\$HOME/.my.cnf，该文件由零或指定密码节，每节开始行的形式[section-name]，例如

\$ cat \$HOME/.my.cnf<br> \# this is a comment<br> [client]<br> user = dj<br> host = localhost<br> <br> [rs-dbi]<br> database = s-data<br> <br> [lasers]<br> user = opto<br> database = opto<br> password = pure-light<br> host = merced<br> ...<br> [iptraffic]<br> host = data<br> database = iptraffic<br> <br> This file should be readeable only by you.  Inside each section, MySQL parameters may be specified one per line (e.g., user = opto).   MySQL always considers default options from  the [client] group for connecting to a server. To override or add additional options, R MySQL combines default options from the [rs-dbi] group, but you may specifiy you own group in the dbConnect call to tailor your environment. Note that  to override options, you must place your group after the [client] group in configuration file.
\ $猫\ $首页/ .my.cnf的参考\＃这是一个注释 -  [客户]参考用户= DJ参考主持人=本地<BR> <BR> [RS-DBI] BR>数据库=数据参考参考[激光器]参考用户=光电<br>数据库=光参考密码=纯光<BR>的主机MERCED <BR> ... < > [iptraffic参考主机=数据<br>数据库= iptraffic参考参考这个文件应该是只有你readeable。在每个部分中，MySQL的参数，可以指定每行（例如，user = opto）。 ，MySQL总是认为默认选项[client]组连接到服务器。要覆盖或添加额外的选项，R MySQL的结合[rs-dbi]组的默认选项，但在dbConnect打检测来定制您的环境，您可以指定要您自己的组。需要注意的是覆盖选项，你必须把你的组后[client]组配置文件中。

For instance, if you define a group, say, [iptraffic], then instead of including all these parameters in the call to dbConnect, you simply supply the name of the group, e.g., dbConnect(mgr, group = "iptraffic").
例如，如果你定义了一个组，说，[iptraffic]，然后，而不是包括所有这些参数在调用dbConnect，您只需提供的名称的group，例如， dbConnect(mgr, group = "iptraffic")。

The most important parameters are user,  password, host,  and dbname.
最重要的参数是user，password，host和dbname。


参考文献----------References----------

for more details on the R/S-Plus database interface.
http://www.mysql.com for details.

注意----------Note----------

Use the option database in place ofdbname in configuration files.
使用选项“database的地方dbname配置文件中的。


（作者）----------Author(s)----------


David A. James



参见----------See Also----------

On database managers:
在数据库管理器：

dbDriver dbUnloadDriver
dbDriverdbUnloadDriver

On connections, SQL statements and resultSets:
在连接，SQL语句和ResultSets：

dbConnect dbDisconnect dbSendQuery dbGetQuery fetch dbClearResult
dbConnectdbDisconnectdbSendQuerydbGetQueryfetchdbClearResult

On transaction management:
事务管理：

dbCommit dbRollback
dbCommitdbRollback

On meta-data:
在元数据：

summary dbGetInfo dbGetDBIVersion dbListTables dbListConnections dbListResults dbColumnInfo dbGetException dbGetStatement dbHasCompleted dbGetRowCount
summarydbGetInfodbGetDBIVersiondbListTablesdbListConnectionsdbListResultsdbColumnInfodbGetExceptiondbGetStatementdbHasCompleted dbGetRowCount


实例----------Examples----------


# create a MySQL instance and create one connection.[创建一个MySQL实例，并创建一个连接。]
> m <- dbDriver("MySQL")
<MySQLDriver4378)>

# open the connection using user, passsword, etc., as[打开的连接使用用户，passsword，等，作为]
# specified in the "[iptraffic]" section of the [“iptraffic]”一节中指定]
# configuration file \file{\$HOME/.my.cnf}[配置文件\文件{\ $ HOME / .my.cnf}]
> con <- dbConnect(m, group = "iptraffic")
> rs <- dbSendQuery(con, "select * from HTTP_ACCESS where IP_ADDRESS = '127.0.0.1'")
> df <- fetch(rs, n = 50)
> dbHasCompleted(rs)
[1] FALSE
> df2 <- fetch(rs, n = -1)
> dbHasCompleted(rs)
[1] TRUE
> dbClearResult(rs)
> dim(dbGetQuery(con, "show tables"))
[1] 74   1
> dbListTables(con)   

## End(Not run)[＃（不执行）]

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


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