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アーキテクチャのスタンドアロンサーバー
別の組み込みエンジンプロセス