MINI MINI MANI MO

%
% Copyright (c) 2012, 2016, Oracle and/or its affiliates. All rights reserved.
%
\name{ore.connect}
\alias{ore.is.connected}
\alias{ore.connect}
\alias{ore.disconnect}
\title{
Oracle R Enterprise 접속 함수
}
\description{
Oracle R Enterprise 서버의 접속을 설정하거나
  종료합니다.
}
\usage{
  ore.is.connected(type = c("ORACLE", "HIVE"))
  ore.connect(user = "", sid = "", host = "localhost", password = "",
              port = NULL, service_name = NULL, conn_string = NULL,
              all = FALSE, type = c("ORACLE", "HIVE"),
              tzone = Sys.getenv("TZ"), schema = NULL, ...)
  ore.disconnect()
}
\arguments{
  \item{user}{
\code{type = "ORACLE"} 인수(기본값)를 사용할 경우, Oracle Database
    사용자 이름을 지정하는 문자열입니다.
}
  \item{sid}{
\code{type = "ORACLE"} 인수(기본값)를 사용할 경우, Oracle
    Database SID 또는 Oracle Wallet 접속
    문자열을 지정하는 문자열입니다.
}
  \item{host}{
\code{type = "ORACLE"} 인수(기본값)를 사용할 경우, Oracle Database의
    호스트 이름에 대한 문자열입니다.
}
  \item{password}{
\code{type = "ORACLE"} 인수(기본값)를 사용할 경우, Oracle Database
    사용자 비밀번호를 지정하는 문자열입니다.
}
  \item{port}{
\code{type = "ORACLE"} 인수(기본값)를 사용할 경우, Oracle Database
    포트를 지정하는 숫자입니다(일반적으로 1521).
}
  \item{service_name}{
\code{type = "ORACLE"} 인수(기본값)를 사용할 경우, Oracle Database의
    접속 식별자에 사용할 서비스 이름을
    지정하는 문자열입니다.
}
  \item{conn_string}{
\code{type = "ORACLE"} 인수(기본값)를 사용할 경우, Oracle Database에
    접속하는 데 사용되는 접속 문자열을 지정하는
    문자열입니다. 일반적으로 Oracle Wallet의 데이터베이스
    접속에 사용됩니다.
}
  \item{all}{
기본 인수를 사용하여 \code{\link{ore.sync}} 및 \code{\link{ore.attach}} 함수를
    호출할지 여부를 나타내는 논리 값입니다.
    이렇게 하면 Oracle R Enterprise 접속을 위해
    스키마의 모든 테이블 및 뷰가 동기화되고 연결됩니다.
    \code{\link{ore.sync}}에 대한 실행 시간은 표시 가능한
    테이블 및 뷰의 개수에 따라 비례적으로 증가합니다.
}
  \item{type}{
데이터베이스 유형을 지정하는 문자열로
    \code{"ORACLE"}(기본값) 또는 \code{"HIVE"}입니다.
}
  \item{tzone}{
\R 세션과 데이터베이스 세션 모두에 대한 세션 시간대를 지정하는
    문자열입니다. \code{tzone}의 기본값은 시스템 환경 변수 \code{TZ}의
    값입니다. \code{tzone}의 값이 \code{NA}이거나
    빈 문자열인 경우 \code{UTC}이(가)가 \R 세션과
    데이터베이스 세션 모두에 사용됩니다.
}
  \item{schema}{
스키마를 지정하는 문자열입니다.
}
  \item{...}{
다음과 같은 서로 다른 모드에서 Hiveserver2를 사용하는 경우
    Hive 접속에 대한 추가 매개변수
    \itemize{
      \item{Kerberos 인증을 사용하는 HiveServer2:}{
        \code{principal} 매개변수를 사용하여 HiveServer2가 실행 중인
        호스트에 대한 Kerberos 서버 주체를 지정합니다.
      }
      \item{SSL을 사용하는 Hiveserver2:}{
        이 모드에서는 \code{ssl="true"}, \code{sslTrustStore}과(와) 같은 매개변수를 
         사용하여 클라이언트의 보안 저장소 파일에 대한 
        경로를 지정하고 \code{trustStorePassword} 매개변수를 사용하여 
        신뢰 저장소에 대한 비밀번호를 지정합니다.
      }
      \item{HiveServer2의 다른 구성:}{
        HiveServer2가 실행 중일 수 있는 구성 조합은 많습니다.
        해당 모드에서 접속해야 하는 다양한 모드 및 매개변수에 대한 
        내용은 Hive 설명서를 확인하십시오.
      }
    }
}
}



\details{
\code{ore.connect} 및 \code{ore.disconnect} 함수는 부수적 효과, 즉
  Oracle R Enterprise 서버의 접속을 설정 또는 종료하기 위해
  호출됩니다. \code{ore.connect} 함수 호출은 Oracle R Enterprise 기능에 대한
  다른 모든 호출 이전에 호출되어야 합니다(\code{ore.is.connected} 제외).
  활성 Oracle R Enterprise 접속은 하나만
  존재할 수 있습니다. Oracle R Enterprise 세션은 선택적으로
  \code{ore.disconnect} 함수 호출로 끝날 수 있습니다. \R 세션이 끝나면
  Oracle R Enterprise 세션이 암시적으로 종료됩니다.
  \code{ore.connect} 함수를 실행하는 동안 \R 세션 시간대와 데이터베이스 세션 시간대가
  모두 설정됩니다. 세션 시간대는 \code{tzone} 인수의 값으로
  설정됩니다. 여기서 기본값은 시스템 환경 변수 \code{TZ}과(와)
  같습니다. \code{TZ}와 \code{tzone}이(가) 모두 지정되지
  않은 경우 세션 시간대가 \code{UTC}(으)로
  설정됩니다.
  Oracle Wallet을 사용하여 사용자 이름 및 비밀번호를 저장하는 경우
  \code{conn_string} 인수를 사용하여 전자 지갑 매핑에 사용되는 접속 문자열을
  전달합니다. 자세한 내용은 Oracle Database Security Guide의 3장
  "Configuring Clients to Use the External Password Store"를
  참조하십시오. 또한 \code{service_name} 인수를 사용하여
  서비스 이름 정보를 전달할 수 있습니다. 서비스 이름에 대한 자세한 내용은
  Oracle Database Net Services Administrator's Guide의 2장을
  참조하십시오.
  활성 Oracle R Enterprise 접속이 존재할 때
  \code{ore.connect}을(를) 호출하면 새 세션이 시작되기 전에 활성 세션이
  접속 해제됩니다.
}
\value{
\code{ore.is.connected} 함수의 경우 활성 Oracle R Enterprise
  접속이 존재하는지 여부를 나타내는 논리 값입니다.
  그렇지 않으면 보이지 않는 \code{NULL} 값입니다.
}
\references{
  \href{http://www.oracle.com/technetwork/database/database-technologies/r/r-enterprise/documentation/index.html}{Oracle R Enterprise}
}
\author{
  Oracle \email{oracle-r-enterprise@oracle.com}
}
\seealso{
  \code{\link{ore.attach}},
  \code{\link{ore.exists}},
  \code{\link{ore.get}},
  \code{\link{ore.ls}},
  \code{\link{ore.rm}},
  \code{\link{ore.sync}}
}
\examples{
\dontrun{
  # pass the username password during connect
  if (!is.ore.connected())
    ore.connect("rquser", "orcl", "localhost", "rquser")
  ore.ls()
  ore.disconnect()

  # pass the connect string for wallet mode
  if (!is.ore.connected())
    ore.connect(conn_string = "<wallet_connect_string>")
  ore.ls()
  ore.disconnect()
}}
\keyword{database}
\keyword{ORE}