Шпаргалка по строкам подключения Firebird

Общий шаблон в стиле URL

[<протокол>://[<имя_хоста>[:<порт>]/]]<путь_к_файлу_БД_или_алиас>

Подключения TCP/IP (INET)

Примеры для удалённого клиента

Традиционный

имя_сервера/порт:путь_к_БД

В стиле URL

INET://имя_сервера:порт/путь_к_БД

# Традиционный
serverlinux/13050:employee
serverwindows:c:\data\mydatabase.fdb

# В стиле URL
INET://serverlinux:13050/employee
INET://serverwindows:d:/data/db.fdb

Примеры для локального клиента

# Традиционный
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

• Используйте INET6:// для принудительного использования IPv6

• Используйте INET4:// для принудительного использования IPv4

• По умолчанию INET будет использовать IPv6, если он настроен

Именованные каналы Windows (WNET) - устарело

Шаблон

Традиционный

имя_сервера[@имя_службы]\\путь_к_БД

В стиле URL

WNET://\\имя_сервера[:служба]/путь_к_БД

# Традиционный
\\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)

Шаблон

Традиционный

путь_к_БД

В стиле URL

XNET://путь_к_БД

# Традиционный
d:\data\db.fdb

# В стиле URL
XNET://d:/data/db.fdb
XNET://MyDB  # Использование алиаса

Рекомендации

• TCP/IP рекомендуется для всех платформ

• WNET (именованные каналы Windows) устарел, лучше его не использовать

• XNET доступен только в Windows и обеспечивает несколько более высокую производительность, чем INET/WNET, для локальных подключений. Лучше его не использовать.

• Прямые слэши работают для путей Windows, кроме имени сервера в WNET; используйте их как универсальный разделитель

• Алиасы баз данных можно использовать вместо полных путей

Встроенный (Embedded) протокол

Ключевые характеристики

• Серверный процесс не требуется

• Прямой доступ к файлу базы данных

• Аутентификация не требуется

• Доступен на всех платформах

• Может подключаться к базам данных, уже работающим в режиме Classic/Superclassic

Шаблон подключения

Всегда

Только путь к базе данных

# Подключение по прямому пути
/path/to/db.fdb
C:\path\to\db.fdb

# Использование алиаса
mydb

Важные замечания

• Требуется доступный провайдер Engine12+

• Проверка пароля не выполняется, но имя пользователя обрабатывается

• Имя пользователя берётся из:

• Запроса на подключение

• Переменной окружения ISC_USER

• Невозможно подключиться, если база данных открыта монопольно:

• Автономным сервером с архитектурой SuperServer

• Другим процессом встроенного движка