기능문의

Orange Config Admin을 실행하게 되면 Orange Catalog , Orange Schema를 DB서버에 설치하게 됩니다. 그로 얻는 이점은 이렇습니다

 - PL/SQL툴의 소스 잠금기능 ( Check In, Check out) 동시작업을 제한하여 독립성을 유지합니다

 - Orange가 사용하는 쿼리의 성능 향상 ( Orange의 실행속도 향상 )

 - 각종 권한 문제 해결  ( All_Segment와 같은 뷰가 없으므로 Orange_Segment로 대체하여 해결 )

오라클 9i 이후 부터는 원격지에서 sys유저로 접속하기 위해서는 인증모드(authentication mode)를 반드시 SYSDBA로 하셔야 합니다.

인증모드를 sysdba로 선택하시기 바랍니다. 

9i에서는 O7_DICTIONARY_ACCESSIBILITY 라는 오라클 초기화 파라미터의 값이 FALSE 이기 때문입니다.

오라클 초기화 파라미터 remote_login_passwordfile 이라는 파라미터의 값이 none 이기 때문에 원격지에서 sysdba 권한으로 접속하는 것을 허용하지 않기 때문입니다. 

remote_login_passwordfile 파라미터의 값을 exclusive로 바꾸셔야 합니다. 이 파라미터의 값을 바꾸려면 db를 shutdown 했다가 다시 startup 하셔야 합니다.

그러나, 24시간 운영되어야 하는 시스템은 DB를 내렸다가 올릴 수가 없으므로 orange configuration admin 프로그램을 사용하실 수가 없습니다.

별도의 스크립트를 요청하셔야 합니다. 요청하실때는 DBMS 버전을 알려주셔야 합니다.

오라클 초기화 파라미터 remote_login_passwordfile 의 값이 exclusive인데도 접속이 안된다면 오라클 서버에 패스워드 파일이 존재하는 지 확인하여 주시기 바랍니다. 

패스워드 파일이 없으면 orapwd 유틸리티를 사용하여 생성하시기 바랍니다. orapwd 사용법은 오라클 매뉴얼을 참고하시기 바랍니다.

오렌지 스키마에는 connect ,resource, select any dictionary(select any table) 권한이 있습니다. DBA권한은 갖고 있지 않습니다.

그리고 패스워드를 변경하셔도 Orange 사용에 지장이 없습니다. 

보안이 염려되신다면 alter user orange account lock; 명령을 사용하여 Orange 계정을 잠그셔도 됩니다.

오라클 11g를 사용하는 경우 오렌지 설치중에 오렌지 스키마를 설치하지 마시고 설치 후 온라인 업데이트를 먼저 받으신 후 Orange Config Admin을 실행하시기 바랍니다.

다음의 권한이 필요합니다.

• SELECT ANY DICTIONARY

• SELECT ANY TABLE

• GRANT 에 대한 ADMIN 옵션

해당하는 데이터베이스의 딕셔너리 뷰와 SYS의 테이블을 조회해서 Orange 스키마를 생성하기 때문에, SELECT ANY DICTIONARY, SELECT ANY TABLE 권한을 주시기 바랍니다. 해당 시스템 권한은 Orange 스키마 생성후 revoke 하셔도 되나, Schema Browser나 Description Tool에서 객체의 세그먼트 정보가 조회되지 않을수 있으나 접속하는 계정에 sys.dba_segments 에 대한 권한을 줄 경우 상관이 없습니다. 또한 GRANT 에 대한 ADMIN 권한을 필요로 하는데, 최초 Orange 스키마를 만드는 과정에서 ORANGE_MONITORING_ROLE을 생성할때에만 사용되므로 Orange 스키마 생성 이후로는 revoke 하여도 됩니다.

Oracle Client not found 메세지가 뜨는 경우는 Oracle Client 인식을 하지 못해서 발생하는 문제입니다.

Q. 설치하신 Oracle Client가 64bit 인가요?  

설치하신 Oracle Client의 bit와 같은 Orange를 설치 해주세요.  자세한 내용은 설치 FAQ를 참고해주세요.

[설치하신 Oracle Client의 bit는 확인하는 방법]

1. 윈도우 시작 > Registry 편집기를 실행합니다.

2. HKEY_LOCAL_MACHINE-> SOFTWARE-> WOW6432Node-> ORACLE의 하위로 Key 생성되어있을경우, 32bit Oracle Client를 설치한 것을 확인할 수 있습니다.

Q. Oracle Client 10g 이하를 사용하시나요? 

A. Oracle Client 10g 이하를 설치하여 Orange를 사용하시는 경우, Orange가 설치되는 경로에 괄호'()'나 특수문자가 포함될 경우 동일한 오류가 발생하고 있습니다. 

이 경우 Orange를 Program Files 폴더가 아닌, 다른 기본경로로 사용하시거나, 이미 설치된 폴더를 다른 폴더로 복사하여 실행해보시고 동일 현상 발생하는지 확인 바랍니다.

그 후에도 동일한 현상이 있을시에 orange@warevalley.com으로 해당하는 증상과 PC 원격지원 가능여부, 연락처 등을 전달하여 주시기 바랍니다.

Oracle Server에 호환이 되는 Client를 이용해야 합니다. 호환 버전에 대해서는 Oracle 에 문의 부탁드립니다.

Oracle Client 설치시, Instant Client 와 일반 Client 의 파일 구성이 다릅니다.

저희가 위의 둘을 구분하는 기준점은 Instant Client 폴더는, oci.dll과 tnsnames.ora 파일이 동일한 위치에 있고, 일반 Client 는 해당하는 Client 폴더하위의 bin 폴더에 oci.dll 이 존재하고, network\admin 폴더에 tnsnames.ora 파일이 존재합니다.

종종 Instant Client 설치하시고 해당 폴더가 없다고 network\admin 폴더를 직접 생성하여 tnsnames.ora 파일을 검색하시는 경우가 있는데, 이경우 접속이 정상적으로 되지 않습니다. 반드시 설치하신 Client 종류에 따라 tnsnames.ora 파일이 위치하도록 설정하여야 합니다.

사용하시고자 하는 DB의 ODBC를 32bit 로 설치하셔야 합니다.

해당하는 ODBC의 존재 유무는 "ODBC 데이터원본(32bit)"로 확인이 가능하며, 각각의 DB에 맞는 ODBC를 설치한 후, Orange를 재시작 하시면, 하단의 ODBC 콤보 박스에 해당하는 ODBC 가 표시됩니다.

화면상에서  Toolbar 및 Report의 위치 조정값 등을 저장하는 파일의 삭제가 필요합니다.

삭제할 파일의 위치는 버전별로 다음과 같습니다. 다음 폴더로 이동해서 xml 파일을 모두 삭제합니다.

• Orange 7.0    : C:\사용자\[윈도우계정]\AppData\Local\WareValley\[Orange 설치 폴더명]\xml 폴더

• Orange 6.0    : C:\Program Files(x86)\WareValley\[Orange 설치 폴더명]\xml 폴더

• Orange 5.0    : C:\Program Files(x86)\WareValley\[Orange 설치 폴더명]\xml 폴더

• Orange 4.0    : C:\Program Files(x86)\WareValley\[Orange 설치 폴더명]\properties 폴더

Orange 7.0은 DBMS Logon 화면에서 Export to File 기능을 제공합니다. 

이 기능은 접속 이력을 이관하는 방법입니다.  패스워드 관련 값은 저장되지 않습니다. 

패스워드를 포함하여 동일하게 이관하기 위해서는 레지스트리 정보를 이관하십시오.

기존 PC에서 윈도우 시작메뉴 실행창에서 regedit을 실행합니다. 

레지스트리 편집기 창의 왼쪽트리에서 HKEY_CURRENT_USER -> Software -> WareValley-> Orange-> Connections 를 선택하고 내보내기를 선택하여 .reg 파일로 저장합니다.

새로운 PC로 이 파일을 옮긴 후 탐색기에서 이 .reg 파일을 병합하기 하시면 오렌지의 DBMS 로그인 정보가 저장됩니다.

Orange버전이 동일하지 않을 경우 정보가 동일하게 이관되지 않을 수 있습니다. 

또한, Oracle Client 폴더에 위치한 TNSNames.ora 파일도 백업하셔야 정상적으로 접속이 가능합니다.

해당 기능은 계정정보 이관에 사용하기 보단 목록 관리로 사용하는 것으로 패스워드 관련 값은 저장되지 않습니다.

따라서, Import시 발생하는 오류에 대해서 확인하기 위해서는 해당 XML파일을 생성하신 오렌지 버전과, Import 하려 하신 오렌지 버전과 함께

해당 XML 파일을 전달하여 주시면 원인 분석에 도움이 되겠습니다.

해당 오류의 경우, 오라클 클라이언트의 sqlplus 로 접속이 가능한지 여부부터 확인해보셔야합니다.

tnsnames.ora 파일이 정상적으로 생성되어있고, SQLPlus로 접속이 가능한지부터 먼저 확인하기 바랍니다.

Orange 기본설치폴더가 C:\Program Files(x86)\WareValley\Orange…로 되어있는데, Orange 폴더를 괄호('(')나, 특수문자 없는 위치로 이동하여 실행해보시기 바랍니다.

공용 세션은 여러 툴들이 공용으로 사용하는 세션으로 공용 세션은 동시에 여러 개의 툴에 할당될 수 있으나, 한 순간에 세션을 사용할 수 있는 툴은 하나뿐입니다.
공용 세션은 생성되는 순서에 의해 고유한 ID를 부여 받으며, 공용 세션을 사용하는 툴들은 반드시 생성된 공용 세션들 중 하나를 할당 받아야 작업을 실행할 수 있습니다.
현재 할당된 세션의 이름은 오렌지의 타이틀 바에 표시되며 관련 툴은 아래와 같습니다.

관련 툴 : SQL Tool, PL/SQL Tool, Plan Tool, Table Editor, Description Tool, Database Information,
Data Dictionary Tool, Schema Browser, Query Builder, Object Report Tool

공용 세션을 사용하지 않거나 세션을 사용하지 않는 툴을 제외하고는 모두 전용 세션을 사용합니다.
전용 세션을 사용하는 툴은 화면 시작 시 데이터베이스 로그온 대화상자를 보여주어 데이터베이스에 별도로 접속할 것을 요구합니다.
접속에 성공하면, 이 때 만들어진 세션은 해당 툴만이 배타적으로 사용하게 되며, 다른 전용세션 툴이나 공용세션 툴에서는 이 세션에 접근이 불가능합니다.
Standard Edition 에서의 일부 툴과, DBA Edition의 DBA 메뉴 하위의  전체 툴이 전용 세션을 사용합니다.

 관련 툴 : ER Viewer, SQL Monitor, Session Monitor, Transaction Monitor, Lock Monitor, Instance Monitor, Wait Event Monitor, ASH Monitor, Export Tool, Import Tool,
Unload Tool, Load Tool, Data Generation Tool, Script Generation Tool, Space Manager, Security Manager, Health Check, Stats Manager, Graph&Report,
Log Miner, AWR Manager, DQ Manager

해당 원인은 여러가지가 있을수 있습니다.

1.  Oracle Client가 설치가 제대로 완료되지 않은 경우

2. Instant Client로 설치한 경우

3. Oracle Client 패키지를 통해 설치하였으나, Instant 타입을 선택한 경우

4. Oracle Client와 Orange의 비트가 맞지않는 경우 ( 32/64 )

5. 오라클 관련 레지스트리 값이 삭제된 경우 

위와 같은 이유로 Oracle Home을 찾지 못할수 있으며, Instant Client는 Client Type을 Instant로 설정한뒤, 

Instant Client Path직접 oci.dll이 위치한 경로를 지정해주어야 합니다.

그 외의 경우는 Oracle Client를 위 조건들을 확인하여 재설치를 하셔야 합니다.

Description Tool 옵션에서 script 탭에서 Include Storage 하위의 exclude LOB storage 체크박스를 언체크해주세요.

 Desc Tool에서는 해당 테이블에 대한 정보를 보여주기 위하여 많은 테이블 및 View를 검색하게 됩니다. 

DBA 관련 테이블에 접근이 가능하여 테이블에 대한 desc 검색을 기준으로 예를 들었을때, sys.dba_objects, sys.dba_tab_comments, sys.dba_col_comments, sys.dba_constraints, sys.dba_tab_columns, sys.dba_ind_columns 등에 대해 검색하여 표시하고, DBA가 아닐 경우 sys.all_objects, sys.all_tab_comments, sys.all_col_comments, sys.all_constraints, sys.all_tab_columns, sys.all_ind_columns 등에 대해 검색하여 정보를 표시하고 있습니다.

ORA-00942 오류가 발생한다면 관련된 테이블 또는 View에 대한 권한 설정이 부족하여 발생한 것으로 생각됩니다.

오렌지에서는 Truncate Table 의 일괄 처리 기능은 지원하지 않습니다.

이는 실수로 인한 데이터 소실의 위험성을 높이는 방법으로 추후에도 지원할 예정이 없습니다.

소수 표현식이 길어지는 경우, 엑셀 파일을 불러오는 과정에서 지수 표현식으로 변경되게 됩니다. 

혹시 xlsx를 unload tool로 내려받으신 경우라면, 파일 포멧을 LDRD로 unload하신 후 load tool을 이용하실 경우 정상적으로 입력이 가능합니다.

다만 excel로 열어서 중간 검토를 하실 수는 없습니다.

Insert 구문의 실행에 대해 확인한 결과 Timestamp 값이 "0000/00/00 00:…."와 같이 년월일구분자에 대해 /로 입력하고 Insert 수행시 날짜문자열로 인식하지 않아 동일한 오류가 발생하는것을 확인하였습니다.

Oracle의 경우 년월일 구분자에 대해 /를 인지하고 있으나, DB2의 경우 년월일 구분자에 대해 /가 아닌 -로 입력해야 합니다.

따라서 Unload된 엑셀의 Timestamp 값으로 들어갈 문자열에서 / 대신 -로 변경후 실행하여 주시기 바랍니다.

Orange for Tibero - Load Tool 사용시 hang이 걸리는 현상은 사용하시는 tibero 서버와 odbc driver가 맞지 않는 경우 발생하는 걸로 보고되고 있습니다.  해당 문제점은 Tibero 쪽에 연락하셔서 Tibero 서버 버전에 맞는 ODBC driver 를 다시 요청하셔서 설정해야합니다.

Ansi 버전은 Windows 메모장에서 파일을 열었을때, 인코딩 방식이 ANSI로 표현되며, Unicode 버전은 Windows 메모장에서 파일을 열었을때, 인코딩 방식이 UTF16-LE 로 저장 된 것을 말합니다. 초기 Sample Data를 확인하시면 Load 전에 한글 깨짐 현상 등을 확인하실 수 있습니다.

해당 기능은 Altibase ODBC 6.5.1 사용시 발생하는 건으로 확인되었습니다.
하여 6.1.1 또는 7.0.1 등 다른 ODBC로 변경하여 사용하시기 바랍니다. 

cost, card, byte는 CBO(cost based optimizer) 가 사용될 경우 실행계획에 나타납니다.

•           cost는 어떤 특별한 측정 단위가 아니고 비용기반 옵티마이저가 하나의 SQL에 대해 여러 개의 실행계획을 작성하여 그 중 최적의 실행계획을 추출하기 위해 생성된 실행계획간에 비교하기 위한 편의상의 단위입니다.  cost가 낮은 경우 좋은 성능을 예상할 수 있습니다. (항상 그러하지는 않습니다)

•           card는 각 실행계획 단계에서 access된 row 수를 의미합니다.

•           byte는 각 실행계획 단계에서 access된 byte 수를 의미합니다.

Oracle의 Explain Plan에 대해 검색하여 보시면 더 자세한 내역을 확인하실 수 있습니다.

Windows Vista 이상의 OS에서 사용자 계정 컨트롤(UAC)의 등급이 높은 경우 발생할 수 있는 현상으로 특정 레지스트리 값을 하나 추가하고 재부팅하시기 바랍니다. 

Registry 편집기를 이용하여, HKEY_LOCAL_MACHINE\ SOFTWARE\ Microsoft\Windows\CurrentVersion\Policies\System으로 이동합니다.

DWORD타입으로 EnableLinkedConnections 라는 이름의 키를 추가합니다.

 EnableLinkedConnections의 값은 1로 입력한후 PC를 재부팅합니다.

참고 : http://technet.microsoft.com/ko-kr/library/ee844140(v=ws.10).aspx

정상적인 Trace 파일의 경우 Session ID 값과 PID 값을 기준으로 처리되는 것이 맞습니다. 

하여 해당 Session ID 값은 userenv('tid') 값으로, PID 값은 V$session 에서 가져오고 있습니다.  일부 DB 보안 프로그램(DB Safer 등)의 경우 sid 값을 일부 변경하여 표시하면서 제대로 된 값이 전달되지 않아, 0으로 표시될 수 있습니다. 

이에 대해 확인하시려면 Session Monitor 에서 각 Session 값과 비교하여 보시기 바랍니다.

• SID 값

  • Select userenv('tid') from dual;

• PID/serial 값

  • Select serial#, pid from v$session where sid = 'SID 값'

• 위에서 도출한 SID 값을 기준으로 PID/Serial 값을 도출

  • SELECT DISTINCT s.serial#, p.spid, s.sid FROM v$session s, v$process p WHERE s.sid = (SELECT userenv('tid') FROM DUAL ) AND s.pid = p.sid;

위 세 문장을 실행하셔서 각각의 값이 동일하게 나오는지 확인바랍니다.

PL/SQL의 경우 오라클에 저장된 SYS.DBA_ERRORS 또는 SYS.ALL_ERRORS에 저장된 Error 또는 Warning 데이터를 조회하고 있습니다.

말씀하신 Create with warning으로 표현되고 Warning값에 대한 표현이 되지 않는 경우, Oracle의 PLSQL_WARNINGS 값의 변경을  필요로 합니다.

기본 값인 'DIABLE:ALL'이라해도 Error의 경우 SYS.DBA_ERRORS 또는 SYS.ALL_ERRORS에 에러상황을 저장하지만 Warning의 경우 저 값을 'ENABLE:ALL'값으로 설정해야 SYS.DBA_ERRORS 또는 SYS.ALL_ERRORS에 warning 메시지가 저장됩니다.

일반적으로 세션 파라미터로 저장되므로, 

alter session set plsql_warnings = 'ENABLE:ALL'; 

로 설정하시거나, Orange의 DB Information Tool을 통해서 Session Parameter 에서 값을 변경하신후 사용해보시기 바랍니다.

US7ASCII에 대한 지원정책을 변경하거나 하지 않습니다.

unicode와 ansi 구분에 따라 오렌지를 설치하여 사용상에 문제가 없다면, 지속적으로 사용하실수 있습니다.

3.1.5.5 이상 패치를 하셔야 합니다.

툴바에서 먼저 edit mode를 선택하고 나서 SQL을 실행하셔야 합니다.

오렌지 5.0 이상 버전에서는 run edit mode 기능으로 edit mode 실행이 가능합니다.

특정 테이블을 수정모드로 전환하려면 테이블에 Primary key 혹은 Unique 칼럼이 존재해야 합니다. 

만약 존재하지 않는다면 아래 문장처럼 rowid 라는 의사(pseudo) 칼럼을 사용해야 합니다.

select rowid, e.* from emp e; (Oracle 기준)

Execution time은 쿼리가 실행된 시간을 의미하고,

Elapsed time은 결과가 Fetch되는 동안의 수행 시간을 의미합니다.

한글 데이터가 깨지는 것은 폰트 문제와 DB문자셋 문제로 인해 발생할 수 있습니다. 

폰트문제일 경우,Fixedsys 변종폰트가 원인일수 있습니다. 윈도우즈 기본 폰트폴더(C:\Windows\Fonts)에 Fixedsys 변종폰트가 존재하는 경우 한글이 깨져보이는데 해당 변종 폰트를 삭제하거나 Fixedsys 이외의 폰트를 사용하시도록 권장하고 있습니다. 

또한 DB문자셋이 US7ASCII 일 경우 PC 레지스트리의 NLS_LANG도 US7ASCII 로 설정하셔야 하며, 유니코드용 오렌지를 사용하셔도, 동일하게 한글이 깨져 보일 수 있습니다.

LONG 칼럼이나 CLOB 칼럼의 경우 매우 큰 데이타가 들어있을 수 있으므로 전체 데이타를 가져오면 메모리 문제가 발생하므로 

Orange Option 의 Common > Session 창에서  LONG SIZE 라는 옵션에서 설정한 크기만큼만 가져옵니다.
데이타가 짤렸다고 생각하신다면 LONG SIZE를 늘려주시기 바랍니다.

또한 Oracle의 경우, 결과 Grid 화면에서 Export LOB,LONG,RAWs 를 활용하여 관련 값을 파일로 추출할 수 있으니 참고하시기 바랍니다.

오렌지 폴더에서 SQLCache.log 파일의 크기를 확인하시고 해당 파일이 너무 클경우 삭제하시고 사용하시기 바랍니다. 

이 파일은 현재까지 실행한 SQL 구문을 최대값 까지 저장하는 기능의 파일로 SQL Tool의 Option 창의 SQL Cache 의 Max Count 값을 줄여서 사용하시기 바랍니다.

자주 사용하는 SQL일 경우는 SQL Cache 보다 Named Script 기능을 사용하여 저장하셔서 사용하시기 바랍니다.

버전별로 파일의 위치입니다.

• Orange 7.0    : C:\사용자\[윈도우계정]\AppData\Local\WareValley\[Orange 설치 폴더명]\log 폴더

• Orange 6.0    : C:\Program Files(x86)\WareValley\[Orange 설치 폴더명]\log폴더

• Orange 5.0    : C:\Program Files(x86)\WareValley\[Orange 설치 폴더명]\log 폴더

• Orange 4.0 이하    : C:\Program Files(x86)\WareValley\[Orange 설치 폴더명]\DATA폴더

Action->Recall Named  실행하셔서 자주 쓰는 SQL 구문을 등록 및 불러오기 하실 수 있습니다.

다국어 언어(한글, 영어 외에 다른 언어) 지원을 위해서는 Unicode용을 사용해주셔야 합니다. 

메뉴 Help > About Orange에서 Product ID에서 4번째 문자열 값이 UNI라고 되어 있으면 Unicode 용, ANS라고 되어 있으면 ANSI용입니다. 

Unicode 설치 후에도 동일하게 깨지신다면 Orange Option - Common - Editor에서 Font 설정을 깨지는 언어를 지원하는 폰트로 변경한 후에 Apply 버튼 눌러서  적용해주시기 바랍니다.

Orange는 Windows에 MS Office가 설치되어 있어야지만 엑셀로 결과 값을 추출할 수 있습니다. Excel 이 아닌 csv, txt, xml, html도 지원하고 있으니 참고 바랍니다.

Orange는 Office 2016에 대한 지원은 Orange 6.0의 build 62버전 부터 지원하고 있습니다. 

그 이전버전일 경우 Office 버전을 인식하지 못해, Excel 2000 버전을 기본값으로 인지하여, 행을 나누어 저장되는 것입니다.

따라서 Orange 최신 버전을 설치하여 주시기 바랍니다.

해당 오류는 Orange Unicode 버전에서 실행했을때, Unicode 가 아닌 파일을 선택했을경우, 발생하는 메시지 입니다. 

이 경우, 해당 파일의 Encoding 파일 형식을 변경하여야 합니다. 

CSV 파일은 기본적으로 TEXT를 기반으로 하는 문서로,  해당 파일을 Excel 파일에서 형식 변경하여 저장하는 것이 아닌,  일반적인 Editor 파일에서, Encoding 파일 형식을 변경하셔서, 사용하시기 바랍니다. 

예를 들어 EditPlus의 경우, 원본 파일을 열고, 다른이름으로 저장을 선택하여, 하단의 인코딩에서 ANSI가 아닌 Unicode로 선택하여 저장하시면 됩니다.

오렌지는 탭과 연계된 바인드 변수는 한번이라도 실행된 SQL에 한하여,  탭간 이동이 되더라도 저장되고 있습니다.  

이는 Orange 5.0 부터 동일하게 처리되어있으며, 

반드시 실행이 한번이라도 된 SQL 구문에 대해 매칭되는 바인드 변수를 저장하여, 탭간 이동이 이뤄졌을 때, 바인드 변수를 보이도록 하고 있습니다.

실행되지 않은 SQL 문장에 대한 바인드 변수 값에 대한 저장은 되지 않습니다.

Oracle server, Client 간의 NLS_LANG 값을 반드시 동일하게 할 필요는 없으나, NLS_LANG의 값에 따라 데이터 포맷 값이 바뀌는 것에 영향이 가는 구문입니다. 

해당 포맷 값을 확인하시어 적절한 NLS_LANG 값을 입력하여 주시기 바랍니다. (이는 Ansi 버전에만 해당하는 내용입니다.)

새로 생성된 테이블의 경우, 자동완성이 바로 이뤄지지 않습니다.

따라서 SQL Tool에서 점(.)을 입력하여 나타나는 자동완성 창 하단의 리프레시 버튼을 클릭하거나, Orange Option 의 Common -> Auto Complete 화면에서, Clear Auto Complete cache when exiting Orange 를 체크해 두시면, 오렌지 종료시 오렌지 내부에서 저장되어있던 자동완성을 위한 데이터(meta data)를 제거하여, 다음 오렌지 실행시에 새로 생성된 테이블까지 모두 포함한 데이터를 생성하도록 할 수 있습니다.

Grid Result로 조회후에 해당 컬럼 선택->오른쪽 마우스 클릭->Show Value 기능 선택하시면 됩니다.

동일한 값이 반복될 경우 빈 칸으로 출력하는 기능인 Suppress Repeating Value   가 체크되어있는지 확인 바랍니다. 

해당 값의 변경은 SQL Tool에서 상단 Menu에서 Option -> Suppress Repeating Value로 변경 가능합니다.

에디터에서 자동완성 기능을 사용할 때 프로그램 종료 현상이 발생할 수 있습니다. 

이런 경우에는 Orange 종료시에 자동완성 캐시 파일을 자동 삭제하도록 옵션을 설정하시거나

캐시파일을 삭제하시고 Orange를 재시작 바랍니다.

옵션 위치 :  Orange Option -> Common -> Auto Complete -> Clear Auto Complete cache when exiting Oracle

                        (오렌지 옵션 -> 공통 -> 자동완성 -> 오렌지 종료시 자동완성 캐시 삭제 )

캐시파일 위치 :  C:\Users\[사용자계정]\AppData\Local\WareValley\[Orange 설치 폴더]\AC 폴더\모든 ac 파일

이후 사용시 문제 발생하시면 개발팀 orange@warevalley.com으로 연락 주시기 바랍니다..

해당 메시지는 저희 웨어밸리의 또 다른 제품 샤크라 맥스 제품을 설치하였을때, 특정 데이터베이스에 대해 파일 저장/복사기능에 대한 제한이 걸려있을 경우, 오렌지에서 표시하는 메시지입니다. 

해당하는 테이블이 속한 데이터베이스에 대한 설정을 소속하신 사내의 샤크라를 관리하시는 담당자에게 문의하여 주시기 바랍니다.

해당 현상은 MS Office 구성 파일에 문제가 발생한 경우로 실제 동일 현상이 발생한 고객에게 MS Office 삭제및 재설치를 권장하였으며, 정상 처리되었습니다.

해당 이슈는 Active Directory 를 사용하여 보안이 강화된 일부 환경에서 발생하는 것이 확인되었습니다.

이런 증상이 나타날 경우, Orange의 실행 방법에 대해 확인해주세요.

버전별로 다음 방법으로 실행하실 경우 정상 동작 합니다.

• Orange 7              : 윈도우 시작 > Orange for [DB] 7.0 > Orange Launcher 바로가기

• Orange 6 이하  : 윈도우 시작 > Orange for [DB] 6.0 > Orange for [DB] 바로가기

해당 증상은 Windows 보안문제와 관련된 것으로, Orange 설치시 제공된 바로가기를 통해서 사용 부탁 드립니다.

Ctrl+Enter = Ctrl+K 와 동일한 Run Cursor 기능을 실행하는 기능입니다.

해당 기능은 커서가 위치한, SQL 구문을 실행하도록 하는 기능으로 실행후 화면이 해당 문장의 처음으로 이동을 하고 있습니다.

다만 커서는 원래의 위치로 남아있어서, 화면이 이동했다하더라도, 화살표등으로 커서를 이동하시면 해당 화면으로 이동하는것을 확인하실수 있습니다.

Orange는 Oracle 클라이언트, 즉 SQLPlus를 통한 쿼리시에 동일한 데이터로 보이는지 확인바랍니다. 

SQLPlus 에서도 동일한 컬럼에 대해 공백이 ?로 표시될 경우, 해당 하는 데이터에 대한 확인이 필요합니다.

                          Select to_char(rawtohex(' ')) from dual;

위 문장 실행시 20으로 리턴되는데, ?로 표시되는 컬럼에 대해 확인 결과, 

물음표로 나오는 값의 공백이 '20'이 아닌 'C2A0'로 표시되는 경우, 데이터의 이관 등으로 인해 발생할 가능성이 있습니다. 

C2A0 값은 공백은 맞으나 2바이트 공백문자를 뜻합니다.

• chr(32) : 1byte / trim 가능, replace 처리가 space로 만든 공백으로 가능

• chr(49824) : 2byte, trim 불가, replace 처리가 space로 만든 공백으로 불가능

해당 값은 Unicode에서 사용되는 공백으로 정상적으로 보시기 위해서는 Unicode 버전으로 사용하셔야 합니다. 

이는 chr(49824)의 값을 공백으로 보여준다는것 뿐이지, chr(32) 값으로 변경된다는 것을 뜻하진 않기에, EAI를 통한 MSSQL에서의 ?표시는 변경되지 않습니다.

디폴트 디렉토리와 상관 없이 특정 경로를 입력하실경우, @K:\qqq.sql 과 같이 입력하여 주시면 해당파일을 읽어 실행할수 있습니다.

Orange Options -> Common -> Session 탭의 Array Size와 Long Size를 낮춰보시기 바랍니다. ( 기본값 : Array Size = 100 , Long Size = 80 )

Orange의 경우, 32bit 사용시 사용 가능 메모리에 4GB의 제한이 걸리게 되며, 그에 따라 해당 메모리를 모두 사용될 경우,  해당 메시지가 표시됩니다.

SQL Tool에서 데이터 조회시에 해당 Table에 할당된 데이터 크기, 예를 들어 varchar2(2000)과 같은 큰 크기의 데이터가 존재할경우, array 사이즈는 각 컬럼 사이즈를 더한 값으로 1개 row를 구성하도록 되어있으며, array size는 1개 row 크기 * array Size가 되며, Long Size의 경우 Clob의 최대 길이로 지정하고 있으므로, 해당 값의 조절을 통해 조회하실때 메모리 부족현상이 나타나지 않도록 주의하시기 바랍니다.

또한 대용량의 데이터를 모두 SQL Tool에서 조회하기 보다, 데이터를 내려받기 위해서는 unload Tool 을 사용하여 데이터를 내려받기하시면 메모리 부족현상을 겪지 않을수 있습니다.
해당하는 테이블과, 컬럼 타입에 따라서 생성되는 array 크기가 달라지므로 딱 몇row가 된다, 몇row 이상은 메모리 부족 오류가 발생하지 않는다고 단정지을수 없습니다.

Orange for Tibero v7.0 에서 PL/SQL Tool에서 디버깅 기능을 사용하시기 위해서는 아래 구문 실행할 권한이 있어야 합니다.

alter session set psm_debug = yes;

select value from V$PARAMETERS where name = 'PSM_DEBUG';

추가로 PL/SQL Tool에서 오렌지에서 제공하는 디버깅 기능을 다 사용하기 위해서는 Tibero v6 FS6 이상이여야 가능합니다. 

그 이하 버전에서 오렌지가 PL/SQL 디버깅 기능 구현상에 사용하는 Tibero odbc 함수의 일부 기능 중에 정상동작되지 않은 부분이 있어서 그동안 티베로쪽에 수정요청 드렸었고 문제되던 현상이 해결된 버전이 Tibero v6 FS6 이상인 걸로 파악됩니다. 

Orange Ade의 다중 SQL 실행 시에는, 공통적으로 기본 SQL구문은 세미콜론(;) 으로 구분되며, PL/SQL 구문 에서는 슬래시 (/) 문자로 구분됩니다.

예) 

create procedure `proc1`() begin ~ end  /

create procedure `proc2`() begin ~ end  

Delimeter 구문은 Orange Ade 에서는 사용이  어려운점 양해 부탁 드립니다.

접속하고자 하는 해당 서버에 Orange 스키마가 있는지 확인하여 주시기 바랍니다.

또한 Debug가 가능하기 위해서는 아래와 같이 권한을 설정하여야 합니다.

GRANT DEBUG CONNECT SESSION TO [사용자의 DB계정] -- Oracle 10g 이상의 경우 설정
GRANT DEBUG ANY [PROCEDURE | FUCTION | …] TO [사용자의 DB계정]

Orange 에서는 Debug 모드를 사용할 때 Check-In / check-Out 기능을 사용하기 위하여 Orange 스키마의 ORANGE_PLSQL_LOCK_TABLE를 참조하기 때문에, Orange Schema를 설치하는 Orange Config Admin 이란 프로그램을 통해, 해당 DB에 Orange 스키마를 설치하시면 됩니다.

부득이하게 Config Admin을 사용하지 않을 경우, 아래와 같이 Orange 스키마및 해당 테이블 구조를 생성하여 사용하시면 됩니다.

CREATE USER ORANGE IDENTIFIED BY 1 --비밀번호는 사용자 지정입니다.

ACCOUT UNLOCK; --Lock 해주셔도 됩니다.

GRANT RESOURCE TO ORANGE;

CREATE TABLE ORANGE.ORANGE_PLSQL_LOCK_TABLE

(

    LOCKTIME    VARCHAR2(20),

    LOCKHOSTIP  VARCHAR2(30),

    LOCKHOSTNAME VARCHAR2(32),

    LOCKSESSIONID   NUMBER,

    LOCKSERIALNUM   NUMBER,

    OBJECTOWNER VARCHAR2(30),

    OBJECTTYPE  VARCHAR2(13),

    OBJECTNAME  VARCHAR2(128)

);

Orange Config Admin을 실행 하여 Orange Schema가 설치된 경우에  PL/SQL툴의 소스 잠금기능 ( Check In, Check out) 동시작업을 제한하여 독립성을 유지합니다

사용되는 SQL 으로 정확한 쿼리 내용은 아래와 같습니다.

• 해당 오브젝트를 작업하려 할때 해당 오브젝트를 잠금 처리 시 ( Check Out ) 실행 됩니다.

delete from orange.orange_plsql_lock_table where ( LOCKSESSIONID , LOCKSERIALNUM) not in ( select  sid, serial# from orange.orange_session );

• 해당 오브젝트 수정이 완료 후  잠금 해제 시 ( Check In ) 실행됩니다.

delete from orange.orange_plsql_lock_table where objectowner = :owner and objecttype = :type and objectname = :name;

위 쿼리 실행이 염려되시거나, PL/SQL Tool의 소스 잠금 기능의 사용을 원치 않으시는 경우 

orange.orange_plsql_lock_table을 DROP 해주시면 됩니다.

1차적으로는 Oracle 의 Server 와 Client 간의 NLS_LANG 값을 매칭하라고 이야기 합니다. 

Orange의 경우 Ansi 버전 설치시 NLS_LANG 값을 참조하나 Unicode 에서는 해당 값을 참조하지 않습니다.

그러나 해당 값을 동일하게 맞췄다 하더라도,  ORA-29275 오류의 경우, 서버 / Client 간, 또는 데이터 입력하는 Web 화면 등의, 데이터 상호 호환에 문제가 있을 경우 발생할 수 있는 문제 중 하나입니다.

 실제로 Oracle의 Session 생성시 저장되는 V$Session 의 경우, machine, module, action, program 와 같이, 외부 프로그램을 통해 생성되어 저장된 데이터가 해당 오류를 리턴하는 경우가 많습니다.

이는 Server 와 Client 간의 NLS_LANG 문제로도 볼 수 있지만, 데이터 입력 주체에서 NLS_LANG에 맞는 데이터가 입력되지 않을 경우가 발생하기 때문이며, Orange 에서도 해당 값에 대해 to_single_byte 함수를 호출하여 조회하도록 하고 있습니다.

(실제Orange for Oralce 의  Session Monitor / Lock Monitor / Transaction Monitor 에선 to_single_byte 함수 사용 SQL 구문으로 변경 처리 )

 정확한 원인을 알기 위해서는 문제가 되는 데이터에 대한 dump() 함수 사용을 통해, 실제 저장한 문자열 자체를 확인해야 합니다.

그 외에 조회에 대해서는 to_single_byte 함수 사용을 권장하는 바 입니다.

위의 경우에는 여러가지 상황이 존재할수 있습니다.

1. 세션 자체가 끊어지는 경우 - Session Monitor 또는 해당 세션을 확인할수 있는 시스템  뷰를 확인하여  세션이 어떤 상태인지 확인 부탁드립니다.
2. 서버 - 클라이언트 호환 여부 - Oracle 과 같은 DB의 경우 일부 Client 버전에서 Break가 되지 않는 현상이 확인 되었습니다. 이 경우 Orange@warevalley.com 으로
    사용중인 환경 ( 서버 버전, 클라이언트 버전 , Orange 세부 Build 버전 , 증상이 발생하는 테이블 등 ) 에 대해 함께 전달해주시면 확인해드릴수 있습니다.

JSON 타입의 경우, 일반 CLOB 과 같이 문자열로 이루어진 데이터로 볼수 있습니다. 다만 ODBC / JDBC 버전에 따라 해당 문자열에 대해 정상적으로 리턴하지 못하고 있습니다.

MySQL ODBC 버전 8.0.36 버전으로 테스트시 정상적으로 보이는 것을 확인하였으므로 사용하시는 ODBC 또는 JDBC 버전을 확인하여야 합니다.

트레이스 조회 속도가 느린 부분은 아래 두가지 상황인 경우가 대부분입니다.

1. 트레이스 조회시 로드되는 트레이스 파일 용량이 큰가?

=> 트레이스 조회할 쿼리의 트레이스 정보 말고 이전에 조회한 정보들이 누적된 파일이라서 해당 트레이스 파일의 용량이 크면 전체 데이터 로드 및 파싱시에 오래 걸릴 수 있습니다.

만약 파일 용량이 크다면 해당 파일을 삭제 혹은 백업해놓으신 상태(새로운 트레이스 파일이 새로 생길 수 있는 환경)에서 트레이스 조회해보시기 바랍니다. 

2. 사내의 네트워크 환경이 느린가?

=> Orange는 원격의 DB서버의 트레이스 파일을 전송받아 해당 데이터를 파싱해서 트레이스 정보를 보여드리고 있습니다. 트레이스 파일이 크지 않은데도 조회 속도가 느리다면 네트워크 환경을 점검해보실 필요가 있습니다. 

가장 확실한 방법은 로컬의 DB서버가 있다면 로컬에 있는 DB연결->트레이스 조회해보시면 확인하실 수 도 있습니다.

혹시 위에 언급된 상황 확인하시고 또 다른 문의 사항이 있으시면 orange@warevalley.com으로 회신 주시면 됩니다.

Orange에서는 SSH 포트(SFTP) 기능에 대해 6.0 부터 FTP/SFTP로 선택할 수 있도록 지원을 하고 있습니다. 6.0 최신 패치를 설치하시거나, 7.0 사용을 권장합니다.

v$session의 program 칼럼의 값이 2 바이트 문자일 때 v$session을 select 하는 경우 발생합니다.

이 문제가 발생하는 Oracle 버전은 아래와 같습니다. 

• 9.2.0.6 

• 9.2.0.7

• 10.1.0.2               

• 10.1.0.3 

• 10.1.0.4               

• 10.2.0.1           

SQL Monitor를 통해 Explain Plan 수행으로 전달되는 Plan Data의 Bind변수값은 Oracle의 경우 해당 V$sql_bind_capture 라는 뷰를 검색하여 해당 SQL이 실행시 호출된 Bind 변수값을 보여주고 있습니다.

연결된 Plan Tool의 Bind Dta 에 보시면 마지막 Last_Captured 컬럼으로 해당 쿼리가 캡쳐된 일시를 알수 있습니다.

Orange Lock Monitor의 경우, select 하는 다양한 객체들이 있습니다.

그외에 Oracle 12c 의 경우 sys.user$ 에 대한 접근 권한을 추가적으로 grant 해주셔야 합니다.

• all_users

• orange.orange_users

• v$latchholder

• v$lock

• v$open_cursor

• v$process

• v$process

• v$px_session

• v$rollname

• v$session

• v$session_wait

• v$sesstat

• v$sqlarea

• v$sqltext_with_newlines

• v$statname

• v$transaction

더 자세한 monitoring Tool 에서 사용하는 객체 목록이 필요할 경우 다음의 문서를 참고하시기 바랍니다.

Oracle)_오렌지_모니터링_툴_사용_객체들.pdf

• Elapsed Time 의 경우 리포트 상에 표기되는 단위는 초 단위이며 소수 3자리 까지의 밀리초 단위 까지 표기됩니다.

   예) 0.011 -> 11 밀리초

•    또한 Buffer Gets 등에서 사용되는 단위는 DB의 블록 단위 이며, 각 DB에 설정된 파라미터를  확인하여 한개 블록의 단위를 확인하여야 합니다.

  예) select * from v$parameters where name = 'DB_BLOCK_SIZE'; 

Session Monitor의 Command 컬럼은 v$Session 또는 GV$Session의 command 컬럼의 값을 decode로 변환하여 다음의 값으로 치환하여 보여줍니다.  

 1 'SELECT',

 2, 'INSERT',

 3, 'UPDATE',

 4, 'DELETE',

 5, 'CALL', 

 이 외의 값을 가진 경우 UNKNOWN 으로 표기되도록 로직이 구성되어 있으며,  해당 세션의 값들은 모두 0으로 나타나고 있을 가능성이 보여집니다.

 v$sqltext_with_newlines 뷰의  sql_text 뷰를 참조하여 Current Statement 의 값을 가져오도록 되어있습니다.

   해당 컬럼에 sql_id로 조회하여 값이 표기되지 않는 경우 Session monitor 상에서도 표기되지 않습니다.

status 의 값은 세션 상태를 보여주는 값입니다. 다음의 값들을 가질수 있습니다.

 - Ready : 세션이 준비 되었습니다.

 - Running : 세션이 실행 중입니다.

 - TX_RECOVERING : 트랜잭션이 복구중입니다.

 - SESS_CLEANUP : 세션 리소스를 정리중입니다.

 - ASSIGNED : 세션에 할당된 스레드가 있지만 아직 준비되지 않았습니다.

 - CLOSING : 세션을 닫는 중입니다.

 - ROLLING_BACK : PE 슬레이브의 명령문 수준 트랜잭션이 롤백됩니다.

type 의 값은 세션의 유형을 나타내며 다음과 같은 값을 가집니다.

- WTHR : 작업 스레드

- CTHR : 제어 스레드

- LGWR : 로그 작성 과정 

- CKPT : 체크포인트 프로세스 

- LARC : 로그 아카이브 

- AGENT : 시퀀스 프로세스 

- MTHR : 모니터링 프로세스 

- DBWR : 데이터 블록 쓰기 프로세스

- LNW : 로그 네트워크 작성 프로세스 

SQL Trace : 세션이 SQL 추적을 사용하는지 여부 입니다. 트레이스 파일 경로는 v$parameters 의 'SQL_TRACE_DEST' 파라미터를 참조하시기 바랍니다. 

 - Trace On된 경우 SQL Trace가 ENABLED로 표시 됩니다. 

 - SessMonitor 의 우측 클릭 후 Trace On 으로 설정 가능합니다

 - 해당 세션 클릭 후 상단의 Trace On 으로 설정 가능합니다

v$transaction 뷰를 참조하여 Transaction Monitor에 보여지는 항목이 구성됩니다.

Commit 되지 않은 변경사항을 만들어 보시면 실제로 뷰에 항목들이 표기됩니다.

v$lock 의 lmode 항목을 참고 하여 표시하고 있습니다. 같은 SID , Serial 에 다른 lock이 잡혀 있는 경우 값이 비어있을수 있습니다.

오렌지 스키마가 존재하지 않기 때문입니다. 

orange configuration admin을 먼저 실행하시기 바랍니다.

해당 오류는 Orange에서 사용하는 Chart 관련 Library가 존재하지 않거나, 지원하는 버전과 맞지 않을 경우 발생하는 것으로 보고 있습니다.

먼저 C:\Program Files(x86)\Common Files\Software FX Shared 폴더가 있는지 확인하시고 없으시다면 Orange 개발팀(orange@warevalley.com)으로 메일을 보내셔서 해당 파일을 전달받으시기 바랍니다.

실제 파일이 해당 위치에 있는 지 확인하도록 하며, Oracle Home이 정상적으로 선택되었는지 Orange Option의 Common -> Environment 에서 확인 합니다.

Client Type 에서 Default Oracle Home 으로 선택이 되지 않을 경우, 기본 값으로 가지는 Oracle Client Home이 없다고 생각 합니다.

이경우 Default Oracle Home 대신 Select Oracle Home을 선택하신후, 하단의 Oracle Home Name 에서 목록이 표시되는지 확인 해야하며, 이때에도 목록이 존재하지 않을 경우, 해당 PC에 Oracle Client가 아닌 Oracle Instant Client, 또는 Orange와 맞지 않는 bit수의 Client가 설치되었을 수 있습니다.  예를 들어 Orange를 32bit로 설치하시고 Oracle 을 64bit로 설치하시면 Orange에서는 해당 Oracle을 찾지 못합니다.
이경우,  FAQ-F011을 참조하시어 Oracle Client 설치 위치에 대해 Registry 값을 확인하시고, 32 bit 인지, 64bit 인지 확인하시기 바라며, Instant Client 일 경우, Client Type에서 Use Instant Client로 선택후, Instant Client Path 에서 해당 Instant Client 의 경로를 지정하여 줍니다.

Instant Client 또한, Orange와 맞지 않는 bit수일 경우, TNSNames.ora 파일은 정상적으로 보일수 있으나,  Oracle Client not found 오류가 발생할수 있으므로, 반드시 설치하신 Oracle의 bit수를 확인하여 주시기 바랍니다.

TNSNames.ora 파일이 읽히긴 하는데 목록이 다를 경우, 동일한 경로에 있는 파일이 맞는지 확인후, 보이지 않는 목록이 정상적으로 괄호의 시작과 끝이 맺혀 있는지 확인 해야합니다.

Orange 에서 임의로 Parsing 하는 것이기 때문에, 주석처리나, 괄호에 대한 마무리가 정상적이지 않을 경우 제대로 보이지 않을수 있으며, 되도록 Orange 최신 버전으로 설치후, 확인하시기 바라며, 필요시 보이지 않는 목록에 대해 신규 추가하여 저장해 보도록 합니다.

그외에 오류가 발생할 경우 외부 유출이 가능하다면 orange@warevalley.com 으로 해당 tnsnames.ora 파일을 전달하여 주시면, 오류 해결에 도움을 드릴수 있습니다.

Oracle Client 를 설치할때 인스턴트 타입으로 설치 되었을수 있습니다.
해당 클라이언트는 OracleHome 을 Orange Option에서 설정할수 없습니다.

런타임 또는 관리자 타입으로 설치해주시기 바랍니다.

접속한 사용자의 권한에 문제가 있을 때에는 Orange Schema에 권한이 필요한 것처럼 메시지 ( "It is recommanded to use `Orange` schema for using Reorg Manager"

) 가 나타날 수 있습니다.

아래의 사항을 확인해 보시기 바랍니다.

위 권한 관련 문구와 함께 나타나는 권한 목록은 다음과 같습니다.

grant create any table to `사용자명`;

grant alter any table to `사용자명`;

grant drop any table to `사용자명`;

grant lock any table to `사용자명`;

grant comment any table to `사용자명`;

grant select any table to `사용자명`;

grant query rewrite to `사용자명`;

grant create any index to `사용자명`;

grant create any procedure to `사용자명` 

2. 일반 SQL Tool에서 해당 계정으로 접속 및 아래 SQL 실행 결과를 확인 후, Reorg Manager를 사용하기 위해 사용자 계정에도 적절한 권한을 부여해주시기를 바랍니다.

SELECT *

  FROM user_sys_privs

 WHERE privilege IN ('CREATE ANY TABLE',

               'ALTER ANY TABLE',

               'DROP ANY TABLE',

               'LOCK ANY TABLE',

               'COMMENT ANY TABLE',

               'QUERY REWRITE',

               'SELECT ANY TABLE',

               'CREATE ANY INDEX',

               'CREATE ANY PROCEDURE',

               'CREATE ANY TRIGGER',

               'ALTER ANY INDEX',

               'ALTER ANY PROCEDURE',

               'ALTER ANY TRIGGER',

               'ANALYZE ANY',

               'GRANT ANY OBJECT PRIVILEGE',

               'GRANT ANY OBJECT PRIVILEGES');