Skip to main content

A command line interface for Databricks

Project description

Note

Databricks recommends that you use newer Databricks CLI versions 0.200 and above instead of legacy Databricks CLI versions 0.17 and below (located in this repository). You can find the new CLI at https://github.com/databricks/cli.

If you have been using the code in this repository as a Python SDK for interacting with the Databricks APIs, we recommend you use the new dedicated SDK package that can be found at https://github.com/databricks/databricks-sdk-py.

databricks-cli

Build status https://codecov.io/gh/databricks/databricks-cli/branch/main/graph/badge.svg

The Databricks Command Line Interface (CLI) is an open source tool which provides an easy to use interface to the Databricks platform. The CLI is built on top of the Databricks REST APIs.

Note: This CLI is no longer under active development and has been released as an experimental client.

Please leave bug reports as issues on our GitHub project.

Requirements

  • Python Version >= 3.7

Installation

To install simply run pip install --upgrade databricks-cli

Then set up authentication using username/password or authentication token. Credentials are stored at ~/.databrickscfg.

  • databricks configure (enter hostname/username/password at prompt)

  • databricks configure --token (enter hostname/auth-token at prompt)

Multiple connection profiles are also supported with databricks configure --profile <profile> [--token]. The connection profile can be used as such: databricks workspace ls --profile <profile>.

To test that your authentication information is working, try a quick test like databricks workspace ls.

Known Issues

AttributeError: 'module' object has no attribute 'PROTOCOL_TLSv1_2'

The Databricks web service requires clients speak TLSV1.2. The built in version of Python for MacOS does not have this version of TLS built in.

To use the Databricks CLI you must install a version of Python that has ssl.PROTOCOL_TLSv1_2. For MacOS, the easiest way may be to install Python with Homebrew.

Using Docker

# build image
docker build -t databricks-cli .

# run container
docker run -it databricks-cli

# run command in docker
docker run -it databricks-cli fs --help

Documentation

For the latest CLI documentation, see

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

databricks-cli-0.18.0.tar.gz (95.4 kB view details)

Uploaded Source

Built Distribution

databricks_cli-0.18.0-py2.py3-none-any.whl (150.3 kB view details)

Uploaded Python 2 Python 3

File details

Details for the file databricks-cli-0.18.0.tar.gz.

File metadata

  • Download URL: databricks-cli-0.18.0.tar.gz
  • Upload date:
  • Size: 95.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.11.5

File hashes

Hashes for databricks-cli-0.18.0.tar.gz
Algorithm Hash digest
SHA256 87569709eda9af3e9db8047b691e420b5e980c62ef01675575c0d2b9b4211eb7
MD5 d0c172a3f4c98a39cfd5a24608681340
BLAKE2b-256 c76cee7a98f22ba6e4d39cdf7f3a7cd9461fcc562625ccbca58d94bf35fe598b

See more details on using hashes here.

File details

Details for the file databricks_cli-0.18.0-py2.py3-none-any.whl.

File metadata

File hashes

Hashes for databricks_cli-0.18.0-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 1176a5f42d3e8af4abfc915446fb23abc44513e325c436725f5898cbb9e3384b
MD5 c5bdc2e6711f01b4faab51b886b4b0ad
BLAKE2b-256 aea3d56f8382c40899301f327d1c881278b09c9b8bc301c2c111633a0346d06e

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page