{"id":42577652,"url":"https://github.com/columnar-tech/dbc","last_synced_at":"2026-02-10T05:11:23.894Z","repository":{"id":316810730,"uuid":"1052841794","full_name":"columnar-tech/dbc","owner":"columnar-tech","description":"dbc is a command-line tool for installing and managing ADBC drivers","archived":false,"fork":false,"pushed_at":"2026-01-24T21:36:34.000Z","size":1355,"stargazers_count":79,"open_issues_count":37,"forks_count":7,"subscribers_count":2,"default_branch":"main","last_synced_at":"2026-01-25T09:58:46.132Z","etag":null,"topics":["adbc","apache","apache-arrow","cli","database-connector","open-source"],"latest_commit_sha":null,"homepage":"https://docs.columnar.tech/dbc","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/columnar-tech.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-09-08T16:13:08.000Z","updated_at":"2026-01-24T21:08:40.000Z","dependencies_parsed_at":"2025-09-26T22:07:36.306Z","dependency_job_id":"5189378a-a71c-4736-a3bc-b526b6036aca","html_url":"https://github.com/columnar-tech/dbc","commit_stats":null,"previous_names":["columnar-tech/dbc"],"tags_count":6,"template":false,"template_full_name":null,"purl":"pkg:github/columnar-tech/dbc","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/columnar-tech%2Fdbc","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/columnar-tech%2Fdbc/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/columnar-tech%2Fdbc/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/columnar-tech%2Fdbc/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/columnar-tech","download_url":"https://codeload.github.com/columnar-tech/dbc/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/columnar-tech%2Fdbc/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28853194,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-28T15:15:36.453Z","status":"ssl_error","status_checked_at":"2026-01-28T15:15:13.020Z","response_time":57,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["adbc","apache","apache-arrow","cli","database-connector","open-source"],"created_at":"2026-01-28T22:00:36.171Z","updated_at":"2026-01-28T22:00:36.806Z","avatar_url":"https://github.com/columnar-tech.png","language":"Go","readme":"\u003c!--\nCopyright 2026 Columnar Technologies Inc.\n\nLicensed under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License.\nYou may obtain a copy of the License at\n\n    http://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software\ndistributed under the License is distributed on an \"AS IS\" BASIS,\nWITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\nSee the License for the specific language governing permissions and\nlimitations under the License.\n--\u003e\n\n# dbc \u003cpicture\u003e\u003cimg src=\"https://raw.githubusercontent.com/columnar-tech/dbc/refs/heads/main/resources/dbc_logo_animated_padded.png?raw=true\" width=\"180\" align=\"right\" alt=\"dbc Logo\"/\u003e\u003c/picture\u003e\n\n[![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](LICENSE)\n[![GitHub release (latest SemVer)](https://img.shields.io/github/v/release/columnar-tech/dbc)](https://github.com/columnar-tech/dbc/releases)\n[![Release dbc](https://github.com/columnar-tech/dbc/actions/workflows/release.yml/badge.svg)](https://github.com/columnar-tech/dbc/actions/workflows/release.yml)\n\n## Overview\n\n**dbc is a command-line tool for installing and managing [ADBC](https://arrow.apache.org/adbc) drivers.**\n\ndbc can:\n\n* Install pre-built [ADBC](https://arrow.apache.org/adbc) drivers with a single command\n* Install drivers in your user account, on the system, or in virtual environments\n* Manage isolated, reproducible project environments with driver lists and lockfiles\n* Run on macOS, Linux, and Windows\n* Be installed in many ways (with pip, standalone installers, Docker images, and more)\n* Work in CI/CD environments\n\n## Installation\n\nThere are multiple ways to install dbc:\n\n### From PyPI\n\nFor simple installation, we recommend the popular [pipx](https://pipx.pypa.io/stable/installation) tool which will automatically put it on your `PATH`:\n\n```sh\npipx install dbc\n```\n\nYou can also just test it out instead of installing it:\n\n```sh\npipx run dbc\n```\n\nYou can also use a virtual environment:\n\n```sh\npython -m venv .venv\nsource .venv/bin/activate\npip install dbc\n```\n\n### Standalone Installer\n\n#### macOS or Linux\n\nYou can download the install script and execute it:\n\n```sh\ncurl -LsSf https://dbc.columnar.tech/install.sh | sh\n```\n\nIf your system doesn't have `curl` you can also use `wget`:\n\n```sh\nwget -q0- https://dbc.columnar.tech/install.sh | sh\n```\n\nIf you want to inspect the script before use, you can simply run:\n\n```sh\ncurl -LsSf https://dbc.columnar.tech/install.sh | less\n```\n\n#### Windows\n\nDownload the Windows graphical installer for your architecture:\n\n| Architecture |  Installer                                              |\n| ------------ | ------------------------------------------------------- |\n| x64 (64-bit) | \u003chttps://dbc.columnar.tech/latest/dbc-latest-x64.msi\u003e   |\n\nOr use `irm` to download the install script and execute it with `iex`:\n\n```sh\npowershell -ExecutionPolicy ByPass -c \"irm https://dbc.columnar.tech/install.ps1 | iex\n```\n\nChanging the [execution policy](https://learn.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_execution_policies?view=powershell-7.4#powershell-execution-policies) allows running a script from the internet.\n\nOf course, you can also inspect the script before use:\n\n```sh\npowershell -c \"irm https://dbc.columnar.tech/install.ps1 | more\"\n```\n\n### GitHub Releases\n\nRelease artifacts for dbc can also be downloaded directly from [GitHub Releases](https://github.com/columnar-tech/dbc/releases). Included in the artifacts are also\ncryptographic signatures and a checksum file to ensure nothing has been tampered with.\n\nEach release includes the following assets allowing you to install using your preferred method:\n\n- `.tar.gz` or `.zip` archives containing the appropriate binary for all supported platforms and architectures\n- `.deb` and `.rpm` installation packages\n- An `msi` installer package for Windows\n- `.snap` packages\n- Python wheel packages that bundle the dbc executable binary\n\n### Docker\n\nDocker images are also provided with standalone binaries that can be easily run using:\n\n```sh\ndocker run --rm -it columnar/dbc:latest --help\n```\n\n#### Available Images\n\nThe following distroless images are available for linux-based `amd64` and `arm64`\narchitectures:\n\n- `columnar/dbc:latest`\n- `columnar/dbc:{major}.{minor}.{patch}`, e.g. `columnar/dbc:0.0.1`\n\n## Homebrew\n\ndbc is available via the Columnar Homebrew tap. The tap will first need\nto be added to your environment:\n\n```sh\nbrew tap columnar-tech/tap\n```\n\nOnce you've done this you can install the `dbc` cask:\n\n```sh\nbrew install --cask dbc\n```\n\n## Getting Started\n\nOnce you have dbc available to you on the command line, you can install an ADBC\ndriver and make it available to your user. For example, to install the snowflake driver:\n\n```sh\ndbc install snowflake\n```\n\nAlternately, when working on a project you can create a `dbc.toml` file to create a\nlist of drivers to install to create a reproducible environment:\n\n```sh\ncd \u003cpath/to/project\u003e\ndbc init # creates dbc.toml\ndbc add snowflake # adds this to the driver list\ndbc sync # install drivers and create dbc.lock\n```\n\nUsing `dbc add` also allows version constraints:\n\n```sh\ndbc add \"snowflake\u003e=1.0.0\"\ndbc sync # looks for and installs a version \u003e=1.0.0\n```\n\n### Using the Driver\n\nThe simplest way to use the driver is via Python with [`adbc-driver-manager`](https://pypi.org/project/adbc-driver-manager/).\n*Note: version 1.8.0 added support for driver manifests, so you'll need that version of the driver manager or higher*.\n\n```sh\ndbc install snowflake\npip install \"adbc-driver-manager\u003e=1.8.0\"\n```\n\nUsing the driver is easy:\n\n```python\nimport adbc_driver_manager.dbapi as adbc\n\nsnowflake_connect_args = {\n    \"username\": \"USER\",\n    \"password\": \"PASS\",\n    \"adbc.snowflake.sql.account\": \"ACCOUNT-IDENT\",\n    \"adbc.snowflake.sql.db\": \"SNOWFLAKE_SAMPLE_DATA\",\n    # other connect options\n}\n\nwith adbc.connect(\n    driver=\"snowflake\",\n    db_kwargs=snowflake_connect_args,\n) as con, con.cursor() as cursor:\n    cursor.execute(\"SELECT * FROM CUSTOMER LIMIT 5\")\n    table = cursor.fetch_arrow_table()\n\nprint(table)\n```\n\nFor more detailed information on using dbc, see the [documentation](https://docs.columnar.tech/dbc). Also check out the [ADBC Quickstarts](https://github.com/columnar-tech/adbc-quickstarts) repo to learn how to use ADBC with a variety of languages and databases.\n\n## Communications\n\nFor general questions and discussion, use the GitHub [discussions](https://github.com/columnar-tech/dbc/discussions).\n\nTo report an issue, request a feature, or contribute an improvement, use the GitHub\n[issues](https://github.com/columnar-tech/dbc/issues) and\n[PRs](https://github.com/columnar-tech/dbc/pulls).\n\nSee [CONTRIBUTING.md](./CONTRIBUTING.md) for more information on contributing.\n\n## Code of Conduct\n\nBy choosing to contribute to dbc, you agree to follow our [Code of Conduct](https://github.com/columnar-tech/.github/blob/main/CODE_OF_CONDUCT.md).\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcolumnar-tech%2Fdbc","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcolumnar-tech%2Fdbc","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcolumnar-tech%2Fdbc/lists"}