dbc

dbc 技能

使用 dbc 命令行程序为用户安装和管理驱动程序。

安装 dbc

如果用户无法使用 dbc，请尝试为其安装。

如果有相应工具，优先按以下顺序使用这些命令进行安装：

• 如果有 uv：uv tool install dbc
• 如果有 pipx：pipx install dbc
• 如果有 brew：brew install columnar-tech/tap/dbc
• 在 Windows 上，如果有 winget：winget install dbc

如果以上选项都不可用，请停止并询问用户是否要自行手动安装 dbc，然后再继续。请引导他们查看安装文档：https://docs.columnar.tech/dbc/getting_started/installation/。

最重要的命令

• dbc install <driver> - 安装驱动程序（例如，dbc install snowflake）
• dbc search [pattern] - 根据模式搜索驱动程序（例如，dbc search sql）。也会列出已安装的驱动程序（见下文）。
• dbc info <driver> - 获取驱动程序详情

运行 dbc --help 了解其他命令。

列出已安装的驱动程序

没有 dbc list 命令。不要运行 dbc list——它会失败。

要查看已安装的驱动程序，请运行不带参数（或带模式）的 dbc search，并在输出中查找带有 [installed: ...] 标记的条目。例如：

postgresql   An ADBC driver for PostgreSQL ...   [installed: user=>1.11.0]
snowflake    An ADBC driver for Snowflake  ...   [installed: user=>1.10.3]

没有 [installed: ...] 标记的条目表示该驱动程序可用，但尚未安装。

项目工作流

为实现可重现的驱动程序管理，优先采用以下工作流，而不是使用 dbc install：

1. dbc init - 创建 dbc.toml 文件
2. dbc add <driver> - 将驱动程序添加到列表中（支持版本约束，例如 dbc add "postgresql>=13.0"）
3. dbc sync - 安装所有驱动程序并创建 dbc.lock

使用驱动程序

通过 dbc 安装的驱动程序必须搭配 ADBC 驱动程序管理器使用。dbc 无法直接加载驱动程序或查询数据源。不要从 PyPI 等其他来源安装驱动程序，始终优先使用通过 dbc 安装的驱动程序。

驱动程序使用资源：

• 如何加载驱动程序并连接数据库：https://github.com/columnar-tech/adbc-quickstarts
• ADBC 的 Python 指南：https://arrow.apache.org/adbc/current/python/recipe/index.html