Firebird 연결 문자열 치트 시트

일반 URL 스타일 패턴

Code

[<protocol>://[<hostname>[:<port>]/]]<database_file_path_or_alias>

TCP/IP 연결 (INET)

원격 클라이언트 예시

전통적 방식

servername/port:database_path

URL 스타일

INET://servername:port/database_path

Code

# 전통적 방식
serverlinux/13050:employee
serverwindows:c:\data\mydatabase.fdb

# URL 스타일
INET://serverlinux:13050/employee
INET://serverwindows:d:/data/db.fdb

로컬 클라이언트 예시

Code

# 전통적 방식
127.0.0.1:d:\data\db.fdb
localhost:/opt/data/db.fdb

# URL 스타일
INET://d:\data\db.fdb
INET:///opt/data/db.fdb

IPv6 및 IPv4

IPv6를 강제하려면 INET6:// 사용
IPv4를 강제하려면 INET4:// 사용
기본 INET은 설정된 경우 IPv6를 사용

Windows 명명된 파이프 (WNET) - 사용 중단됨

패턴

전통적 방식

servername[@service_name]\\database_path

URL 스타일

WNET://\\servername[:service]/database_path

Code

# 전통적 방식
\\serverwindows\c:\data\db.fdb
\\.\c:\data\db.fdb  # 로컬 연결
\\serverwindows@MyService\c:\data\db.fdb

# URL 스타일
WNET://serverwindows/d:/data/db.fdb
WNET://serverwindows:myservice/d:/data/db.fdb

Windows 로컬 프로토콜 (XNET)

패턴

전통적 방식

database_path

URL 스타일

XNET://database_path

Code

# 전통적 방식
d:\data\db.fdb

# URL 스타일
XNET://d:/data/db.fdb
XNET://MyDB  # 별칭 사용

권장 사항

모든 플랫폼에서 TCP/IP 사용을 권장
WNET(Windows 명명된 파이프)은 사용 중단되었으므로 사용하지 않는 것이 좋음
XNET은 Windows 전용이며, 로컬 연결 시 INET/WNET보다 약간 더 나은 성능을 제공하지만 사용하지 않는 것이 좋음
Windows 경로에는 슬래시(/)가 작동하지만 WNET 서버 이름에서는 예외이므로, 범용 구분자로 슬래시를 사용할 것
전체 경로 대신 데이터베이스 별칭을 사용할 수 있음

임베디드 프로토콜

주요 특징

서버 프로세스가 필요 없음
데이터베이스 파일에 직접 접근
인증이 필요 없음
모든 플랫폼에서 사용 가능
Classic/Superclassic 모드로 이미 실행 중인 데이터베이스에 연결 가능

연결 패턴

항상

데이터베이스 경로만 사용

Code

# 직접 경로 연결
/path/to/db.fdb
C:\path\to\db.fdb

# 별칭 사용
mydb

중요 참고 사항

Engine12+ 공급자가 사용 가능해야 함
비밀번호 확인은 수행되지 않지만 사용자 이름은 처리됨
사용자 이름 출처:
연결 요청
ISC_USER 환경 변수
다음에 의해 독점적으로 열린 데이터베이스에는 연결할 수 없음:
SuperServer 아키텍처의 독립 실행형 서버
다른 임베디드 엔진 프로세스