이 섹션에서는 Oracle SQL Developer를 사용하여 ADB에 접속하는 방법을 실습합니다. SQL Developer는 오라클 데이터베이스를 관리하는 데 유용한 무료 IDE입니다. ADB에 접속하여 데이터베이스 객체를 탐색하고 SQL 쿼리를 실행할 수 있습니다. 단계별 실습을 통해 ADB 접속 과정을 익혀보겠습니다.
1단계: Oracle SQL Developer 다운로드 및 설치
먼저 Oracle SQL Developer를 다운로드합니다. 오라클 웹사이트에서 다운로드할 수 있습니다. (https://www.oracle.com/tools/downloads/sqldev-downloads.html) 운영체제에 맞는 버전을 선택합니다. JDK가 필요할 수 있습니다. JDK가 설치되어 있지 않다면 함께 설치합니다. 다운로드한 파일을 실행하여 SQL Developer를 설치합니다. 설치 과정은 간단합니다. 기본 설정으로 진행해도 무방합니다.
2단계: SQL Developer 실행 및 접속 설정
SQL Developer를 실행합니다. “접속” 탭에서 “+” 버튼을 클릭합니다. “새 접속” 대화 상자가 나타납니다. 다음 정보를 입력합니다.
- 이름: 접속 이름을 입력합니다. 예: “ADB_Autotrade”.
- 사용자 이름: ADB 사용자 이름을 입력합니다. 예: “ADMIN” 또는 다른 사용자. (1.2.3에서 생성한 사용자)
- 비밀번호: 사용자 이름에 해당하는 비밀번호를 입력합니다.
- 접속 유형: “Cloud PDB”를 선택합니다.
- 구성 파일: 1.2.4 섹션에서 다운로드한 Wallet 파일 (
Wallet_<데이터베이스이름>.zip)을 선택합니다. “찾아보기…” 버튼을 클릭하여 파일을 선택합니다. - 서비스 이름:
tnsnames.ora파일에서 접속 이름(Service Name)을 확인합니다.AUTOTRADE_ADB와 같은 이름을 선택합니다. (1.2.4.3 참조)
3단계: 접속 테스트
입력한 정보를 확인합니다. “접속 테스트” 버튼을 클릭합니다. “성공” 메시지가 나타나면 연결이 정상적으로 설정된 것입니다. 오류 메시지가 나타나면 입력 정보를 다시 확인합니다. 특히 Wallet 파일 경로, 비밀번호, 서비스 이름을 확인합니다.
4단계: 접속
“접속” 버튼을 클릭합니다. SQL Developer가 ADB에 접속합니다.
5단계: 데이터베이스 객체 탐색
접속에 성공하면 “접속” 탭에 ADB 접속 정보가 표시됩니다. 접속 이름을 확장하면 데이터베이스 객체 목록을 볼 수 있습니다. 테이블, 뷰, 프로시저, 함수 등을 탐색할 수 있습니다.
6단계: SQL 쿼리 실행
SQL 워크시트를 엽니다. (파일 -> 새로 만들기 -> SQL 워크시트) SQL 쿼리를 작성하고 실행할 수 있습니다. 예를 들어, 다음과 같은 쿼리를 실행하여 테이블 목록을 확인할 수 있습니다.
SELECT table_name FROM user_tables;
쿼리를 실행하려면 “SQL 실행” 버튼을 클릭합니다. (녹색 화살표 아이콘) 쿼리 결과가 하단 창에 표시됩니다.
7단계: 데이터 탐색
테이블을 마우스 오른쪽 버튼으로 클릭합니다. “데이터 보기”를 선택합니다. 테이블의 데이터를 확인할 수 있습니다. 필터를 적용하거나 정렬하여 데이터를 탐색할 수 있습니다.
8단계: 문제 해결
- “IO 오류: The Network Adapter could not establish the connection” 오류: Wallet 파일 경로가 올바른지 확인합니다.
TNS_ADMIN환경 변수가 올바르게 설정되었는지 확인합니다. (1.2.4.4 참조) 방화벽 설정이 ADB 접속을 차단하지 않는지 확인합니다. - “인증 실패” 오류: 사용자 이름과 비밀번호가 올바른지 확인합니다.
- “ORA-12154: TNS: 지정된 접속 식별자를 해석할 수 없습니다.” 오류:
tnsnames.ora파일에 지정된 서비스 이름이 올바른지 확인합니다. SQL Developer에서 선택한 서비스 이름이tnsnames.ora파일의 이름과 일치하는지 확인합니다.
9단계: SQL Developer 종료
작업이 완료되면 SQL Developer를 종료합니다.
이 단계를 따라하면 Oracle SQL Developer를 사용하여 ADB에 접속할 수 있습니다. ADB에 접속하여 데이터베이스 객체를 관리하고 SQL 쿼리를 실행할 수 있습니다. 다음 섹션에서는 파이썬 개발 환경을 준비하는 방법을 알아봅니다.