Skip to main content

A command line interface for Databricks

Project description

Build Status

This repository includes the code for the command line interface to Databricks APIs. Currently, the only APIs implemented are for DBFS. PLEASE NOTE, this CLI is under active development and is released as an experimental client. This means that interfaces are subject to being changed and that SLAs/engineering support are not provided.

If you’re interested in contributing to the project please reach out. In addition, please leave bug reports as issues on our Github project.

Requirements

  • Python Version > 2.7.9

  • Python 3 is not supported

Installation

To install simply run pip install databricks-cli

In order to upgrade your databricks-cli installation please run pip install --upgrade databricks-cli

Getting started and setting up authentication

After installing, databricks and dbfs (shorthand for databricks fs) will be installed into your PATH. Try it out by running dbfs --help.

There are two ways to authenticate to the Databricks API. The first way is to use your username and password pair. To do this run dbfs configure and follow the prompts. The second way is to use a access token generated inside of Databricks. To configure the CLI to use an access token run dbfs configure --token and follow the prompts.

Known Issues

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

For compliance reasons, our webapp requires the client to speak TLSV1.2. The built in version of Python for MacOS does not have this version of TLS built in.

To use databricks-cli you should install a version of Python which has ssl.PROTOCOL_TLSv1_2. For MacOS, the easiest way may be to install Python with Homebrew.

Don’t have a password because of SSO?

Databricks will soon provide a token service which will allow users to authenticate to the API using a secret token.

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.2.0.tar.gz (14.4 kB view hashes)

Uploaded Source

Built Distribution

databricks_cli-0.2.0-py2-none-any.whl (29.9 kB view hashes)

Uploaded Python 2

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