특수 SQL 구성 옵션

사용 사례

기본 설정을 변경해야 하는 한 가지 사용 사례는 JDBC, ODBC, Essbase에 포함됨, Essbase에 포함되지 않음 등 드라이버를 사용하여 다중 스레드 SQL 데이터 로드(병렬 데이터 로드와 동일하지 않음)를 사용으로 설정해야 하는 경우입니다. 예를 들어, SQL 데이터를 집계 저장 영역 큐브로 로드하는 경우 최대 8개의 규칙 파일을 사용하여 데이터를 병렬로 로드할 수 있습니다. 각 규칙 파일에는 동일한 인증 정보(SQL 유저 이름 및 암호)가 포함되어야 합니다.

Essbase는 데이터 값이 정렬되고 누적되는 여러 임시 합산 저장영역 데이터 로드 버퍼(각 규칙 파일에 대해 하나씩)를 초기화합니다. 데이터가 데이터 로드 버퍼에 완전히 로드되면 Essbase는 모든 버퍼의 콘텐츠를 하나의 작업으로 큐브에 커밋합니다. 이는 버퍼를 개별적으로 커밋하는 것보다 빠릅니다.

다음 MaxL 예제에서 SQL 데이터는 두 개의 규칙 파일(rule1.rul 및 rule2.rul)에서 로드됩니다.

import database AsoSamp.Basic data 
   connect as TBC identified by 'password' 
   using multiple rules_file 'rule1' , 'rule2' 
   to load_buffer_block starting with buffer_id 100 
   on error write to "error.txt";

SQL 구성 변경

위의 사용 사례에서와 같이 외부 SQL 소스에서 다중 스레드 데이터 로드를 사용으로 설정하려면 esssql.cfg를 수정하여 Essbase와 함께 배포된 드라이버에 대한 기본 설정을 변경해야 합니다. 그렇지 않으면 데이터 로드를 시도하는 동시 사용자에게 다음과 같은 오류가 발생합니다. ERROR - 1021025 - SQL driver [driverLibrary] for [DriverName] is in use already and does not allow multiple connections. Please try later.

Essbase와 함께 Oracle에 포함되지 않은 ODBC 드라이버를 사용하여 데이터베이스에 연결하려는 경우에도 esssql.cfg에 항목을 추가해야 합니다.

SQL 구성 설정을 변경하려면

Essbase 도메인에서 SQL 구성 파일을 찾습니다.

<DOMAIN HOME>/config/fmwconfig/essconfig/essbase/esssql.cfg

파일 복사본을 다른 이름으로 저장합니다. 예를 들어, esssql_cfg.orig이라는 복사본을 만듭니다.
편집할 esssql.cfg을 엽니다.

여러 블록(드라이버마다 하나씩)을 사용하여 이 파일을 구성합니다. 블록은 대괄호 []로 구분됩니다. 블록을 복사하여 붙여넣고 각 드라이버의 필요에 따라 설정을 편집할 수 있습니다.
요구 사항에 따라 필요에 따라 변경하고 파일을 저장합니다. 아래의 esssql.cfg Options를 참조하십시오. 예를 들어 다중 스레드 작업을 활성화하려면 SingleConnection 값을 0으로 변경합니다.
서버 시작, 정지 및 검사에 설명된 대로 Essbase 서버를 중지하고 재시작합니다.

샘플 esssql.cfg 파일

다음 샘플 esssql.cfg에는 6개의 구성 블록이 있습니다. 첫번째 항목은 기본적으로 여기에 있으며, 다음 다섯 개는 다중 스레드 SQL 데이터 로드를 활성화하도록 서로 다른 소스를 구성하는 예제로 추가됩니다.

[
Description "Oracle BI Server"
DriverName libnqsodbc
UserId 1
Password 1
Database 1
SingleConnection 0
IsQEDriver 0
ConvertUTF16toUTF8 1
]
[
Description "SQL Server"
DriverName SQLSRV
UserId 1
Password 1
Database 1
SingleConnection 0
IsQEDriver 0
]
[
Description "Oracle SQL Server Wire Protocol"
DriverName ARSQLS
UserId 1
Password 1
Database 1
SingleConnection 0
IsQEDriver 1
]
[
Description "Oracle DB2 Wire Protocol"
DriverName ARDB2
UserId 1
Password 1
Database 1
SingleConnection 0
IsQEDriver 1
]
[
Description "Oracle MySQL Wire Protocol"
DriverName ARMYSQL
UserId 1
Password 1
Database 1
SingleConnection 0
IsQEDriver 1
]
[
Description "Teradata"
DriverName TDATAODBC_SB64
UserId 1
Password 1
Database 1
SingleConnection 0
IsQEDriver 0
]

Teradata DriverName의 경우 TDATA 또는 TDATAODBC_SB64를 사용할 수 있습니다.

esssql.cfg 옵션

esssql.cfg 구성 파일에는 최소한 드라이버 파일 이름(DriverName)이 포함되어야 합니다. 선택적으로 설명(설명)을 포함할 수 있습니다. 구성 파일에는 0 또는 1인 추가 키워드가 포함될 수 있습니다.

Linux에서 DriverName을 찾으려면 odbcinst.ini(

<Essbase Product Home>/modules/<driver class>/<driver version>

드라이버 이름이 드라이버에 지정된 경로의 끝에 있습니다.

예를 들어, odbcinst.ini의 다음 항목에서 드라이버 이름이 ARora임을 알고 있습니다(버전 정보 28를 포함할 필요가 없음).

Driver=/scratch/username/oracle_home/essbase/modules/oracle.essbase.datadirect.odbc/8.0.2/lib/ARora28.so

Windows에서 DriverName을 찾으려면 드라이버 탭에서 Windows 64비트 ODBC 데이터 소스 관리자 유틸리티를 참조하십시오.

드라이버 탭이 선택된 ODBC 데이터 소스 관리자 도구입니다. Oracle 8.0 Oracle Wire Protocol이 강조 표시되어 있습니다. 드라이버 파일 이름은 ARORA28.DLL입니다.

키워드	값	값 = 0	값 = 1
설명	(선택 사항) 큰따옴표로 묶인 드라이버에 대한 설명입니다. 기본값은 `""`입니다.	N/A	N/A
DriverName	(필수) 드라이버 파일 이름(예: ARORA)	N/A	N/A
UserId	0 또는 1	사용자 ID는 필요하지 않습니다(기본값).	사용자 ID 필요
비밀번호	0 또는 1	비밀번호가 필요하지 않음(기본값)	비밀번호 필요
Database	0 또는 1	데이터베이스 이름은 필수가 아닙니다(기본값).	데이터베이스 이름 필요
서버	0 또는 1	서버 이름은 필요하지 않습니다(기본값).	서버 이름이 필요합니다.
애플리케이션	0 또는 1	애플리케이션 이름은 필수가 아닙니다(기본값).	애플리케이션 이름이 필요합니다.
딕셔너리	0 또는 1	딕셔너리 이름이 필요하지 않음(기본값)	사전 이름 필요
파일	0 또는 1	파일 이름은 필수가 아닙니다(기본값).	파일 이름이 필요합니다.
단일 연결	0 또는 1	드라이버 스레드 안전 -- 다중 활성 연결이 허용됨	드라이버가 스레드 안전하지 않음 -- 하나의 활성 연결이 허용됨
IsQEDriver	0 또는 1	드라이버가 Essbase와 함께 제공되지 않음(기본값)	드라이버가 Essbase와 함께 제공됩니다.
ConvertUTF16toUTF8	0 또는 1	UTF16 데이터를 UTF8로 변환하지 않습니다(기본값).	Oracle BI 데이터 소스에서 UTF16 인코딩 데이터를 UTF8로 변환합니다. OBI에서 Essbase로 SQL 데이터를 로드하려면 UNIX에서 필요합니다.

기본값은 지정되지 않은 값에 적용됩니다. 구성 파일 내에 적용된 기본값은 esssql.cfg 파일이 없는 경우 적용되는 Essbase 기본값과 다릅니다.

키워드와 값은 적어도 하나의 공백으로 구분되어야 하며, 각 드라이버에 대한 키워드와 값 집합은 대괄호( [ ] )로 묶어야 합니다.

다른 드라이버에는 추가 값이 필요할 수 있습니다. 자세한 내용은 드라이버 설명서를 참조하십시오.