Oracle 연결 문자열 생성기
하나의 양식에서 Oracle Easy Connect 문자열, TNS 연결 디스크립터, JDBC thin URL, ODP.NET 문자열을 만들거나, 문자열을 붙여넣어 호스트, 포트, 서비스 이름을 확인하고 SID와 서비스 이름을 혼동한 오류를 잡아낼 수 있습니다. 모든 처리는 브라우저에서 이뤄집니다: 입력한 내용은 어디로도 전송되지 않습니다.
이 연결을 SQLly에서 열기
설계 단계부터 프라이버시를 지킵니다. 빌더와 디코더는 이 탭에서 돌아가는 순수 JavaScript입니다. 입력한 내용으로 요청을 하나도 보내지 않고, 아무것도 저장하지 않으며(브라우저에도 저장하지 않음), 한 번 로드되면 오프라인에서도 계속 작동합니다. SQLly에서 열기 링크는 브라우저에서 컴퓨터의 앱으로 바로 이어집니다.
Oracle 연결 문자열 형식
Oracle 클라이언트는 데이터베이스를 세 가지 방식으로 지정합니다: Easy Connect (host:1521/service_name), 전체 접속 기술자((DESCRIPTION=(ADDRESS=...)(CONNECT_DATA=(SERVICE_NAME=...)))), 또는 다음에서 찾은 TNS 별칭 tnsnames.ora. JDBC thin, ODP.NET, python-oracledb 및 node-oracledb 모두 처음 두 가지를 허용합니다.
전형적인 실수는 SID와 서비스 이름을 헷갈리는 것입니다. 플러거블 데이터베이스와 클라우드 데이터베이스는 서비스 이름으로 접속하고, Easy Connect는 SID를 아예 표현할 수 없으며, 구형 JDBC 형식은 host:port:SID 서비스 이름을 제공하면 ORA-12505 오류가 발생합니다.
간편 연결 SQL*Plus, SQLcl, python-oracledb, node-oracledb, ODP.NET
db.example.com:1521/FREEPDB1
TLS를 통한 Easy Connect Easy Connect Plus
tcps://db.example.com:2484/FREEPDB1
연결 디스크립터 tnsnames.ora, 모든 Oracle 클라이언트
(DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=db.example.com)(PORT=1521))(CONNECT_DATA=(SERVICE_NAME=FREEPDB1)))
JDBC thin Oracle JDBC (ojdbc)
jdbc:oracle:thin:@//db.example.com:1521/FREEPDB1
ADO.NET (ODP.NET) Oracle.ManagedDataAccess
User Id=app_user;Password=your_password;Data Source=db.example.com:1521/FREEPDB1;
SQLAlchemy URL python-oracledb
oracle+oracledb://app_user:[email protected]:1521/?service_name=FREEPDB1
다음과 같은 플레이스홀더 your_password 말 그대로 그 이상도 이하도 아닙니다. 위 양식으로 연결 문자열을 직접 만드세요. SQLly를 Oracle에 연결하는 방법 더 알아보기: Oracle용 SQLly.
Easy Connect (Plus) 구문
[[protocol:]//]host[,host2][:port][/service_name][:server_type][/instance_name][?parameter=value&...]. 프로토콜은 tcp (기본) 또는 tcps; 포트는 둘 다 기본값이 1521입니다. Easy Connect에서는 SID를 사용할 수 없습니다.
| 키워드 | 동의어 | 기본값 | 기능 |
|---|---|---|---|
protocol |
- | tcp | tcps:// TLS를 사용합니다. TLS 리스너는 일반적으로 Oracle의 등록 포트인 2484를 사용하지만, 반드시 작성해야 합니다. |
port |
- | 1521 | 리스너 포트. |
service_name |
- | - | 데이터베이스 서비스, 예: PDB 이름과 같은 FREEPDB1 또는 ORCLPDB1. |
server_type |
- | - | dedicated, shared 또는 pooled. |
connect_timeout |
- | 없음 | 연결을 설정하는 데 허용되는 시간(초). |
transport_connect_timeout |
- | - | TCP 연결 자체에 허용되는 시간(초). |
retry_count / retry_delay |
- | - / 0 | 연결 재시도와 그 사이의 지연 시간. |
ssl_server_dn_match |
- | ON(클라이언트 19.2+) | 서버 인증서의 DN을 호스트와 대조하십시오. |
wallet_location |
- | - | TCPS용 지갑이 있는 디렉토리. |
ODP.NET 연결 문자열 속성
ADO.NET 스타일. Data Source Easy Connect 문자열, TNS 별칭 또는 전체 설명자를 사용합니다.
| 키워드 | 동의어 | 기본값 | 기능 |
|---|---|---|---|
User Id |
- | - | 데이터베이스 사용자. |
Password |
- | - | 비밀번호; 특수 문자가 포함되어 있으면 큰따옴표로 묶으세요. |
Data Source |
- | - | Easy Connect, 별칭 또는 디스크립터. |
DBA Privilege |
- | - | SYSDBA, SYSOPER, SYSASM, SYSBACKUP, SYSDG, SYSKM, SYSRAC. |
Connection Timeout |
- | 15 | 풀 연결 대기 시간(초). |
Pooling |
- | 참 | 연결 풀링. |
Max Pool Size |
- | 100 | 가장 큰 풀. |
Min Pool Size |
- | 1 | 가장 작은 풀. |
Incr Pool Size |
- | 5 | 풀이 확장될 때 추가되는 연결 수. |
Statement Cache Size |
- | 0 | 연결당 캐시되는 문장입니다. |
Validate Connection |
- | 거짓 | 풀에서 꺼낸 연결은 넘겨주기 전에 검증하세요. |
Connection Lifetime |
- | 0 | 풀 연결이 유지될 수 있는 시간(초). |
Oracle JDBC thin URL 형식
사용자 이름과 비밀번호는 문자열에 그대로 넣지 말고 연결 속성으로 전달하세요.
| 키워드 | 동의어 | 기본값 | 기능 |
|---|---|---|---|
jdbc:oracle:thin:@//host:port/service |
- | - | 서비스 이름(Easy Connect). |
jdbc:oracle:thin:@tcps://host:port/service |
- | - | TLS; 다음을 추가: ?wallet_location=/path 지갑을 위해. |
jdbc:oracle:thin:@(DESCRIPTION=...) |
- | - | 전체 연결 디스크립터. |
jdbc:oracle:thin:@alias?TNS_ADMIN=/path |
- | - | 해당 디렉토리의 tnsnames.ora에서 TNS 별칭 (또는 oracle.net.tns_admin 속성). |
jdbc:oracle:thin:@host:port:SID |
- | - | 레거시 SID 형식입니다. 서비스 이름을 권장합니다. |
일반적인 Oracle 연결 오류
ORA-12154: TNS:could not resolve the connect identifier specified
이유: 클라이언트가 문자열을 TNS 별칭으로 처리했으나 찾을 수 없음: 없음 tnsnames.ora, TNS_ADMIN 다른 곳을 가리키거나, 별칭 또는 Easy Connect 문자열의 오타.
해결: Easy Connect 사용 (host:1521/service) 또는 tnsnames.ora를 건너뛰는 전체 접속 기술자를 쓰거나, TNS_ADMIN 파일이 있는 디렉토리로.
ORA-12514: TNS:listener does not currently know of service requested in connect descriptor
이유: 리스너에는 도달하지만 그 서비스 이름으로 등록된 데이터베이스가 없다는 뜻입니다. 서비스 이름이 틀렸거나 철자가 잘못되었거나, SID를 서비스 이름으로 넣었거나, 데이터베이스가 열려 있지 않은 경우입니다.
해결: 실행 lsnrctl services (또는 DBA에게 문의하여) 등록된 서비스 이름을 확인한 뒤 그중 하나를 사용하십시오.
ORA-12505: TNS:listener does not currently know of SID given in connect descriptor
이유: 연결 문자열은 SID로 연결합니다 (host:port:SID 또는 (SID=...)) 그리고 값이 리스너가 알고 있는 SID가 아닌 경우입니다. 실제로는 서비스 이름인 경우가 많습니다.
해결: 서비스 이름 형식으로 전환하세요: //host:port/service_name.
ORA-12541: TNS:no listener
이유: 해당 호스트와 포트에서 수신 중인 리스너가 없습니다: 리스너가 다운되었거나, 포트가 틀렸거나, 방화벽이 차단하고 있는 경우입니다.
해결: 확인 lsnrctl status 서버에서 포트(기본값 1521)와 방화벽을 확인하세요.
ORA-01017: invalid username/password; logon denied
이유: 잘못된 사용자 이름 또는 비밀번호입니다. 비밀번호는 대소문자를 구분하며, 특수 문자가 포함된 비밀번호는 SQL*Plus에서 큰따옴표가 필요할 수 있습니다.
해결: 자격 증명을 확인하고, SQL*Plus에서는 비밀번호를 다음과 같이 따옴표로 묶습니다 user/"p@ss"@host/service.
ORA-28000: the account is locked
이유: 로그인 실패가 너무 많았거나 DBA가 계정을 잠갔습니다.
해결: DBA가 다음 명령을 ALTER USER app_user ACCOUNT UNLOCK;.
Oracle 연결 문자열 FAQ
Oracle Easy Connect 문자열이란 무엇인가요?
간단한 연결 식별자, host[:port]/service_name, tnsnames.ora 항목이 필요 없는 형태입니다. Easy Connect Plus(19c 이상)는 여기에 다음을 더합니다 tcps://, 여러 호스트 및 ?parameter=value 같은 옵션 connect_timeout.
SID와 서비스 이름의 차이점은 무엇인가요?
SID는 하나의 데이터베이스 인스턴스를 지정합니다. 서비스 이름은 클라이언트가 리스너에 요청하는 이름이며, 하나의 데이터베이스(또는 플러거블 데이터베이스)가 여러 개를 제공할 수 있습니다. 최신 및 클라우드 데이터베이스는 서비스 이름으로 접속합니다. Easy Connect는 서비스 이름만 받습니다.
Oracle의 기본 포트는 무엇인가요?
리스너의 기본 포트는 1521입니다. TLS(TCPS)는 다른 포트를 구성하지 않는 한 동일한 기본값을 사용합니다; 많은 사이트가 TLS를 위한 Oracle 등록 포트인 2484를 사용합니다.
Oracle Client를 설치하지 않고 python-oracledb로 어떻게 연결하나요?
python-oracledb는 기본적으로 Thin 모드에서 실행되며 Oracle Client 라이브러리가 필요 없습니다. oracledb.connect(user=..., password=..., dsn="host:1521/service").
SQLly가 연결 문자열에서 Oracle 연결을 열 수 있나요?
SQLly는 Oracle에 연결할 수 있지만, 연결 문자열 붙여넣기를 읽는 기능이 아직 Oracle 문자열을 지원하지 않아 SQLly에서 열기 버튼은 Oracle에서 비활성화입니다. 대신 SQLly의 연결 편집기에 호스트, 포트, 서비스 이름을 입력하세요.
한 번 연결하세요. 그 뒤는 그냥 SQL만 쓰면 됩니다.
SQLly는 macOS, Windows, Linux용 네이티브 SQL 워크벤치입니다. 연결 편집기에 연결 문자열을 붙여넣고, 비밀번호는 시스템 키체인에 보관하고, Oracle 등에서 스키마 인식 IntelliSense를 사용할 수 있습니다.