DuckDB 接続文字列ビルダー
DuckDB はプロセス内で動き、ファイルを開くだけなので、その「接続文字列」はパスです。読み取り専用またはインメモリのデータベースファイルについて、JDBC URL、Python 呼び出し、SQLAlchemy URL、CLI コマンドを組み立てられます。 すべてブラウザー内で実行されます。入力した内容がどこかに送信されることはありません。
SQLly でこの接続を開く
設計段階からプライベート。 ビルダーとデコーダーは、このタブで動く素の JavaScript です。ページは、入力した内容を含むリクエストを一切送信せず、何も保存せず(ブラウザー内にも保存しません)、一度読み込めばオフラインでも動作し続けます。「SQLly で開く」リンクは、ブラウザーからお使いのコンピューター上のアプリへ直接つながります。
DuckDB 接続文字列の形式
すべての DuckDB クライアントは、データベースファイルのパスか、 :memory: 一時的なインメモリデータベース用。ファイルを読み書き可能で開けるのは同時に 1 つのプロセスのみですが、複数のプロセスが読み取り専用で共有できます。
ファイルパス すべてのクライアント、SQLly
/var/data/analytics.duckdb
JDBC DuckDB JDBC ドライバー
jdbc:duckdb:/var/data/analytics.duckdb
SQLAlchemy URL duckdb-engine
duckdb:////var/data/analytics.duckdb
CLI、読み取り専用 duckdb
duckdb -readonly /var/data/analytics.duckdb
次のようなプレースホルダー your_password あくまで一例です。接続文字列は上のフォームで組み立ててください。SQLlyをDuckDBに接続する方法の詳細: DuckDB 向け SQLly.
DuckDB データベースを開く
読み取り専用モードでは、複数のプロセスが 1 つのファイルを読み取れます。
| キーワード | シノニム | デフォルト | 何ができるか |
|---|---|---|---|
JDBC |
- | jdbc:duckdb: (メモリ内) | jdbc:duckdb:/path/file.duckdb; 読み取り専用と duckdb.read_only=true 接続プロパティ。設定はセミコロンで区切って続けられます: jdbc:duckdb:/path;threads=4. |
Python |
- | :memory: | duckdb.connect("file.duckdb", read_only=True). |
SQLAlchemy |
- | - | duckdb:///relative.duckdb, duckdb:////abs/path.duckdb, duckdb:///:memory:; 次を介して読み取り専用 connect_args={"read_only": True}. |
CLI |
- | インメモリ | duckdb file.duckdb; 次を追加します -readonly 読み取り専用の場合。 |
Node.js |
- | - | @duckdb/node-api: await DuckDBInstance.create("file.duckdb"). |
一般的な DuckDB 接続エラー
IO Error: Could not set lock on file "analytics.duckdb": Conflicting lock is held
理由: 別のプロセスがすでにそのファイルを読み書きモードで開いています (多くの場合、ノートブック、CLI セッション、またはアプリの 2 つ目のインスタンスです)。
修正: 他方のプロセスを閉じるか、どちらも書き込みが不要であれば両方を読み取り専用で開いてください。
IO Error: Cannot open database "analytics.duckdb" in read-only mode: database does not exist
理由: 読み取り専用モードではファイルは作成されません。パスが間違っているか、予期しない作業ディレクトリからの相対パスになっています。
修正: 既存のデータベースに絶対パスを使用する。
DuckDB 接続文字列 FAQ
DuckDB に接続文字列はありますか?
クライアント/サーバーという意味ではありません: DuckDB は組み込み型なので、ファイルパスを開きます (または :memory:)。ラッパーは次のように異なります: jdbc:duckdb:/path Java では、 duckdb:///path SQLAlchemy では、Python、Node、CLI ではプレーンなパスです。
DuckDB ファイルを読み取り専用で開くにはどうすればよいですか?
read_only=True Python では、 duckdb.read_only=true JDBC のプロパティ、 connect_args={"read_only": True} SQLAlchemy では、または duckdb -readonly file.duckdb CLI で。
2 つのプログラムで同じ DuckDB ファイルを使えますか?
読み書きモードで開けるのは 1 つのプロセスだけです。複数のプロセスが同時に読み取り専用で開くことはできます。
つなぐのは一度だけ。あとは SQL を書くだけ。
SQLly は、macOS、Windows、Linux 向けのネイティブ SQL ワークベンチです。接続文字列を接続エディターに貼り付け、パスワードはシステムのキーチェーンに保管し、DuckDB などでスキーマ対応の IntelliSense を利用できます。