일반 JDBC 드라이버에 대한 접속 및 데이터 소스 생성

이 워크플로우에서는 Essbase 서버에 업로드한 드라이버를 사용하여 Essbase가 JDBC 데이터 소스에 접속할 수 있도록 합니다.

Essbase 배치 관리자인 경우 Essbase 서버 시스템에 업로드한 선호 드라이버를 사용하도록 Essbase를 구성할 수 있습니다. 오라클은 Oracle 드라이버를 사용하여 Essbase JDBC 접속을 테스트했습니다. 다른 공급업체의 JDBC 드라이버를 사용하려면 드라이버 설명서에서 JDBC 데이터 소스의 URL 및 인증서 지정에 대한 요구사항을 확인하십시오. 성능 관련 단계는 공급업체 JDBC 설명서를 참조하십시오.

주:

Essbase와 함께 사용한 JDBC 드라이버가 결과 집합을 처리하는 동안 사용된 메모리를 제어하기 위해 setFetchSize 메소드를 허용하는지 확인하십시오. 데이터 로드 및 차원 빌드 프로세스의 최적 성능을 위해 Essbase는 네트워크 호출당 1000개 레코드를 인출합니다.

일반 JDBC 드라이버를 사용하도록 Essbase를 구성하려면 다음과 같이 하십시오.

SSH를 사용하여 Essbase 서버 시스템에 접속합니다.
서버 인스턴스의 <Essbase 제품 홈>에 drivers 디렉토리를 수동으로 생성합니다.

경로는 대소문자를 구분하므로 drivers가 모두 소문자인지 확인합니다.
공급업체 사이트에서 사용할 JDBC 드라이버 JAR를 다운로드합니다.

Essbase에서 지원되는 Oracle Database JDBC 드라이버는 ojdbc8.jar입니다.

Autonomous Data Warehouse를 사용하는 경우 Oracle JDBC Thin 드라이버와 동반 JAR가 포함된 전체 아카이브(ojdbc8-full.tar.gz)를 다운로드해야 합니다.
JDBC 드라이버 jar를 Essbase 인스턴스의 drivers 디렉토리에 업로드합니다.

각 데이터베이스 드라이버의 한가지 버전만 drivers 디렉토리에 업로드하십시오. 예를 들어, sqljdbc41.jar 및 sqljdbc42.jar를 모두 업로드하지 마십시오. 그렇지 않으면 Essbase는 오래된 버전(CLASSPATH에 먼저 나타나는 버전)을 사용합니다.

Autonomous Data Warehouse를 사용하는 경우 아카이브(ojdbc8-full.tar.gz)를 추출하고 모든 콘텐츠를 drivers 디렉토리(하위 폴더 아님)로 직접 이동합니다.
JDBC 드라이버에 대한 접속을 생성합니다.
1. Essbase 웹 인터페이스에서 소스를 누르고 접속을 누릅니다.
  
  또는 글로벌이 아닌 애플리케이션 레벨에서 접속 및 데이터 소스를 정의하려면 [소스] 페이지가 아닌 [애플리케이션] 페이지에서 시작하고, 애플리케이션 이름을 누르고, 소스를 누릅니다.
2. 접속 생성을 누르고 JDBC를 선택합니다.
  
  JDBC 드라이버를 찾기 위해 Essbase는 drivers 폴더를 찾습니다. jar 파일을 찾을 수 없으면 접속을 테스트할 때 Essbase는 클래스를 찾을 수 없음(또는 드라이버 로드 실패) 오류를 반환합니다.
3. 접속 생성 화면에서
  1. JDBC 접속의 이름을 제공합니다. 예: Oracle JDBC.
  2. URL 필드에서 JDBC 접속 문자열을 제공합니다. 예: jdbc:oracle:thin:@myserver.example.com:1521/orclpdb.example.com. JDBC 제공자로부터 JDBC 접속 문자열을 얻습니다.
    
    위의 구문 형식은 Oracle Database에만 적용됩니다. 다른 제공자와 작업하는 경우 일반 JDBC 드라이버에 대한 추가 접속 예제을(를) 참조하십시오.
  3. [사용자] 및 [비밀번호] 필드에 대해 데이터베이스 액세스 권한이 부여된 사용자의 인증서를 입력합니다.
  4. [드라이버] 필드에서 JDBC 드라이버의 전체 클래스 이름을 제공합니다. 예: oracle.jdbc.driver.OracleDriver.
  Oracle 드라이버에 대해 다음 구문 지침을 사용하여 URL을 지정합니다.
  - Oracle Database가 리스너에 등록된 경우 짧은 구문 jdbc:oracle:thin:@<host>:<port>/<servicename>을 사용하여 URL에 SID 대신 서비스 이름을 사용할 수 있습니다. 예:
```
jdbc:oracle:thin:@myserver.example.com:1521/orclpdb.example.com
```
  - 다음 예제는 긴 구문으로 서비스 이름을 사용합니다.
```
jdbc:oracle:thin:@(DESCRIPTION=(ADDRESS=(host=myserver.example.com)(protocol=tcp)(port=1521))(CONNECT_DATA=(SERVICE_NAME=orclpdb.example.com)))
```
  - 데이터베이스를 고유하게 식별하는 Oracle 시스템 ID(SID)를 사용하려면 jdbc:oracle:thin:@<host>:<port>:<SID> 구문을 사용합니다. 예를 들어, 다음과 같습니다.
```
jdbc:oracle:thin:@myhost:1521:orcl
```
  - Autonomous Data Warehouse를 사용하는 경우 URL 구문에 전자 지갑 경로를 지정하는 TNS_ADMIN 환경 변수를 포함해야 합니다. 전자 지갑은 Essbase 서버 시스템의 아무 곳이나 놓을 수 있지만 jdbc:oracle:thin:@database_service_name?TNS_ADMIN=walletpath 구문을 사용하여 전체 경로를 제공해야 합니다.
    
    Linux 예제
```
jdbc:oracle:thin:@adwsql_low?TNS_ADMIN=/scratch/oracle_home/dist/essbase/drivers/adwConn
```
    Windows 예제
```
jdbc:oracle:thin:@adwsql_low?TNS_ADMIN="C:\\Oracle123\\Middleware\\Oracle_Home\\essbase\\drivers\\adwConn"
```
    OCI 배치의 예제
```
jdbc:oracle:thin:@adwsql_low?TNS_ADMIN=/u01/data/essbase/catalog/users/firstname.lastname@example.com/adwconn
```
  위의 예제는 Oracle Database에만 작동합니다. 다른 제공자와 작업하는 경우 일반 JDBC 드라이버에 대한 추가 접속 예제을(를) 참조하십시오.
4. 테스트를 눌러 접속을 검증하고 검증에 성공하면 생성을 누릅니다.
5. 접속이 성공적으로 생성되었으며 접속 목록에 표시되는지 확인합니다.
일반 JDBC 드라이버 접속을 통해 데이터 소스를 생성합니다.
1. 데이터 소스를 누르고 데이터 소스 생성을 누릅니다.
2. 접속 드롭다운 상자에서 방금 생성한 접속(예: Oracle JDBC)의 이름을 선택합니다. 애플리케이션 레벨 접속에는 appName.connectionName 형식으로 애플리케이션 이름이 접두어로 붙습니다.
3. 데이터 소스의 이름(예: OracleDB_Datasource)을 제공합니다.
4. 선택적으로 데이터 소스에 대한 설명(예: SAMPLE_BASIC_TABLE on Oracle Database)을 입력합니다.
5. [질의] 필드에 이 데이터 소스에서 제공할 데이터를 선택하는 적절한 SQL 질의를 제공합니다.
6. 다음을 누릅니다. SQL 문이 테이블을 올바르게 질의한 경우 질의된 열이 채워집니다.
7. 숫자 열을 [이중]으로 변경하고 다음을 누릅니다.
8. 해당하는 경우 추가 소스별 매개변수를 변경하고 다음을 누릅니다. 매개변수 사용에 대한 자세한 내용은 데이터 소스에 대한 매개변수 구현을(를) 참조하십시오.
9. 미리보기 패널을 검토합니다. 외부 소스에서 데이터 열을 인출하는 질의 결과를 확인해야 합니다.
10. 미리보기가 올바르게 표시되면 생성을 눌러 데이터 소스 생성을 완료합니다.