R语言 ROracle包 dbConnect-methods()函数中文帮助文档(中英文对照)

loveR

dbConnect-methods(ROracle)
dbConnect-methods()所属R语言包：ROracle

                                         Create a connection object to an Oracle DBMS
                                         创建一个连接到Oracle DBMS的对象

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

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

These methods are straight-forward implementations of the corresponding generic functions.
这些方法是直进的相应的通用功能的实现。


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

参数：drv
an object of class OraDriver.  
对象类OraDriver。


参数：conn
an OraConnection object as produced by dbConnect.  
OraConnection对象产生的dbConnect。


参数：username
a character string specifying a user name.  
一个字符串指定用户名。


参数：password
a character string specifying a password.  
一个字符串指定密码。


参数：dbname
a character string specifying a connect identifier (for more informations refer to chapter 8 (Configuring Naming Methods) of Oracle Database Net Services Administrator's Guide). This is the same as part of the SQL*Plus connect string that follows the '@' sign.  If you are using Oracle Wallet to store username and password,  then this string should be the connect string used to create the  wallet mapping (for more information refer to the chapter 3  (Configuring Clients to Use the External Password Store) of Oracle Database Security Guide). Connect identifiers for an Oracle  TimesTen IMDB instance are supported via the OCI tnsnames or easy connect  naming methods. For additional information on TimesTen connections for OCI  see chapter 3 (TimesTen Support for Oracle Call Interface) of the Oracle  TimesTen In-Memory C Developer's Guide.  
一个字符串指定的连接标识符（更详细的信息，请参阅第8章（配置命名方法）的Oracle数据库网络服务管理员指南）。这是相同的SQL * Plus的连接字符串后面的“@”符号。如果您使用的是Oracle钱包来储存用户名和密码，然后该字符串应该是使用的连接字符串创建的钱包的映射（有关更多信息，请参阅第3章（配置客户端使用外部口令存储）的Oracle数据库安全指南）。连接一个Oracle的TimesTen IMDB实例的标识符支持通过OCI的TNSNAMES或轻松连接命名方法。保险业监理处对TimesTen的连接为更多的信息，请参阅第3章（TimesTen的支持Oracle调用接口）的Oracle TimesTen内存中的C语言开发的指南。


参数：prefetch
a logical value indicating TRUE or FALSE. When set to TRUE, ROracle will use OCI prefetch buffers to retrieve additional data from the server thus saving memory required in RODBI/ROOCI by allocating a single row buffer to fetch  the data from OCI. Using prefetch results in a fetch call for every row. By default, prefetch is FALSE and array fetch is used to retrive the data from server.  
一个TRUE或FALSE的逻辑值，该值指示。当设置为TRUE，ROracle的将使用OCI预取的缓冲区，以获取额外的数据从服务器，从而节省内存需要分配一个行缓冲区中获取数据OCI在RODBI / ROOCI。在提取使用预取结果的每一行调用。默认情况下，预取FALSE和数组提取使用，以检索数据从服务器。


参数：bulk_read
an integer value indicating the number of rows to fetch at a time. Default is 25L. When prefetch option is select, memory is allocated for prefetch buffers and OCI will fetch those many rows at a time. When prefetch is not used(default) memory is allocated in RODBI/ROOCI define buffers. Setting  this to a large value will result in more memory allocated based on the  number of columns in the select list and the types of columns. For a column of character, define buffers are allocated using the maximum width times the NLS maximum width. Application should adjust this value based on the  query result and a larger value will benefit queries that return a large  result. Application can tune this value to its need.  
一个整数值，表示一次获取的行数。默认为25L。当预取选项选择，内存分配预取缓冲器和保监处会取那些行一次。如果不使用预取（默认）内存是分配在RODBI / ROOCI定义缓冲区。其设置一个较大的值，将导致更多的内存分配的基础上选择列表中的列的数量和类型的列。对于列的字符，定义缓冲区分配使用的最大宽度免入息审查贷款计划的最大宽度。应用程序应该调整这个值根据查询结果和更大的值将受益查询返回的结果。应用程序可以调整此值，其需要。


参数：stmt_cache
an integer value indicating the number of statements to cache. It means  that cursors are ready to be used without the need to parse the statements  again. Default is 0L. Statement cache leads to prefetch.   
一个整数值，表示高速缓存的语句的数目。这意味着，游标是准备好被使用，而不需要再次解析的语句。默认值是0L。语句高速缓存导致预取。


参数：lob_prefetch
an integer value indicating the size of lob data that can be prefetched and cached while fetching lob data. Default is 1024L.  
一个整数值，表示LOB数据的大小，可以获取LOB数据预取和缓存，而。默认为1024L。


参数：...
any optional arguments.  
可选参数。


Details

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

This connection object is used to execute operations on database.
此Connection对象用于执行对数据库的操作。

When prefetch is set to TRUE, it allows to use OCI prefetch buffer to retrieve additional data from server.
预读设置为TRUE时，它允许使用OCI从服务器检索其他数据预取缓冲器。

bulk_read is used to set an integer value indicating the number of rows  to fetch at a time.
bulk_read用于设置一个整数的值，该值指示的行数，一次获取。

stmt_cache is used to enable/disable statement caching feature. Its value will denote statement cache size.
stmt_cache用于启用/禁用语句缓存功能。它的值表示语句高速缓存大小。

lob_prefetch indicate the size of lob data that can be prefetched and cached while fetching lob data.
lob_prefetch表示，可以获取LOB数据预取和缓存，而lob数据的大小。

This implementation disconnect connection between R and database server. It frees all resources occupied by connection object. It frees all result sets associated with this connection object.
此实现R和数据库服务器之间的连接断开。它释放所有连接对象所占用的资源。它释放此Connection对象相关联的所有结果集。


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


参数：dbConnect
An object OraConnection whose class extends DBIConnection.  This object is used to execute SQL query on database.  
对象OraConnection的类扩展DBIConnection。该对象用于执行SQL查询数据库。


参数：dbDisconnect

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

A connection between R and an Oracle  server is established.
建立R和Oracle服务器之间的连接。

free resources occupied by connection object.
自由连接对象所占用的资源。


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

http://www.oracle.com/technetwork/indexes/documentation/index.html.

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

Oracle, dbConnect, dbSendQuery, dbGetQuery, fetch, dbCommit, dbGetInfo, dbReadTable.
Oracle，dbConnect，dbSendQuery，dbGetQuery，fetch，dbCommit，dbGetInfo，dbReadTable。


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


  ## Not run: [＃不运行：]
    ## create an Oracle instance and create one connection.[＃创建一个Oracle实例，并创建一个连接。]
    drv <- dbDriver("Oracle")

    ## use username/password authentication[＃使用用户名/密码身份验证]
    con <- dbConnect(drv, username = "scott", password = "tiger")

    ## run an SQL statement by creating first a resultSet object[＃执行一个SQL语句创建第一个ResultSet对象]
    rs <- dbSendQuery(con, "select * from emp where deptno = 10")

    ## we now fetch records from the resultSet into a data.frame[＃我们现在从ResultSet中获取记录到一个数据框]
    data &lt;- fetch(rs)       ## extract all rows[＃提取所有行。]
    dim(data)
  
## End(Not run)[＃（不执行）]
  ## Not run: [＃不运行：]
    ## create an Oracle instance and create one connection.[＃创建一个Oracle实例，并创建一个连接。]
    drv <- dbDriver("Oracle")

    ## use Oracle wallet authentication[使用Oracle钱包认证]
    con <- dbConnect(drv, username ="", password="",
    dbname = "<wallet_connect_string>")

    ## run an SQL statement by creating first a resultSet object[＃执行一个SQL语句创建第一个ResultSet对象]
    rs <- dbSendQuery(con, "select * from emp where deptno = 10")

    ## we now fetch records from the resultSet into a data.frame[＃我们现在从ResultSet中获取记录到一个数据框]
    data &lt;- fetch(rs)       ## extract all rows[＃提取所有行。]
    dim(data)
  
## End(Not run)[＃（不执行）]
  ## Not run: [＃不运行：]
    ## create an Oracle instance and create one connection.[＃创建一个Oracle实例，并创建一个连接。]
    drv <- dbDriver("Oracle")

    ## connect to a TimesTen IMDB instance using the easy connect [＃连接到TimesTen IMDB实例，使用简单的连接]
    ## naming method where SampleDb is a direct driver TimesTen DSN[＃命名的方法SAMPLEDB是直接驱动TimesTen的DSN]
    con <- dbConnect(drv, username ="scott", password="tiger",
                     dbname = "localhost/SampleDb:timesten_direct")

    ## run an SQL statement by creating first a resultSet object[＃执行一个SQL语句创建第一个ResultSet对象]
    rs <- dbSendQuery(con, "select * from dual")

    ## we now fetch records from the resultSet into a data.frame[＃我们现在从ResultSet中获取记录到一个数据框]
    data &lt;- fetch(rs)       ## extract all rows[＃提取所有行。]
    dim(data)
  
## End(Not run)[＃（不执行）]

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


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