databricks-cli


Namedatabricks-cli JSON
Version 0.17.4 PyPI version JSON
download
home_pagehttps://github.com/databricks/databricks-cli
SummaryA command line interface for Databricks
upload_time2022-12-08 09:14:50
maintainerNone
docs_urlNone
authorAndrew Chen
requires_pythonNone
licenseApache License 2.0
keywords databricks cli
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage
            databricks-cli
==============
.. image:: https://github.com/databricks/databricks-cli/actions/workflows/push.yml/badge.svg?branch=main
  :target: https://github.com/databricks/databricks-cli/actions/workflows/push.yml?query=branch%main
  :alt: Build status
.. image:: https://codecov.io/gh/databricks/databricks-cli/branch/main/graph/badge.svg
  :target: https://codecov.io/gh/databricks/databricks-cli


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 under active development and is released as an experimental client. This means that interfaces are still subject to change.

If you're interested in contributing to the project please reach out.
In addition, please leave bug reports as issues on our `GitHub project <https://github.com/databricks/databricks-cli>`_.

Requirements
------------

-  Python Version > 2.7.9 or > 3.6

Installation
---------------

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

Then set up authentication using username/password or `authentication token <https://docs.databricks.com/api/latest/authentication.html#token-management>`_. 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 <https://brew.sh/>`_.

Using Docker
------------
.. code::

    # 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

- `Databricks <https://docs.databricks.com/user-guide/dev-tools/databricks-cli.html>`_
- `Azure Databricks <https://learn.microsoft.com/en-us/azure/databricks/dev-tools/cli>`_

            

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/databricks/databricks-cli",
    "name": "databricks-cli",
    "maintainer": null,
    "docs_url": null,
    "requires_python": null,
    "maintainer_email": null,
    "keywords": "databricks cli",
    "author": "Andrew Chen",
    "author_email": "andrewchen@databricks.com",
    "download_url": "https://files.pythonhosted.org/packages/ca/18/be4b07af8cf405e60b665e8edc9bf310a6328fdbea5aca5504ed26907d12/databricks-cli-0.17.4.tar.gz",
    "platform": null,
    "description": "databricks-cli\n==============\n.. image:: https://github.com/databricks/databricks-cli/actions/workflows/push.yml/badge.svg?branch=main\n  :target: https://github.com/databricks/databricks-cli/actions/workflows/push.yml?query=branch%main\n  :alt: Build status\n.. image:: https://codecov.io/gh/databricks/databricks-cli/branch/main/graph/badge.svg\n  :target: https://codecov.io/gh/databricks/databricks-cli\n\n\nThe Databricks Command Line Interface (CLI) is an open source tool which provides an easy to use interface to\nthe Databricks platform. The CLI is built on top of the Databricks REST APIs.\n\n**Note**: This CLI is under active development and is released as an experimental client. This means that interfaces are still subject to change.\n\nIf you're interested in contributing to the project please reach out.\nIn addition, please leave bug reports as issues on our `GitHub project <https://github.com/databricks/databricks-cli>`_.\n\nRequirements\n------------\n\n-  Python Version > 2.7.9 or > 3.6\n\nInstallation\n---------------\n\nTo install simply run\n``pip install --upgrade databricks-cli``\n\nThen set up authentication using username/password or `authentication token <https://docs.databricks.com/api/latest/authentication.html#token-management>`_. Credentials are stored at ``~/.databrickscfg``.\n\n- ``databricks configure`` (enter hostname/username/password at prompt)\n- ``databricks configure --token`` (enter hostname/auth-token at prompt)\n\nMultiple connection profiles are also supported with ``databricks configure --profile <profile> [--token]``.\nThe connection profile can be used as such: ``databricks workspace ls --profile <profile>``.\n\nTo test that your authentication information is working, try a quick test like ``databricks workspace ls``.\n\nKnown Issues\n---------------\n``AttributeError: 'module' object has no attribute 'PROTOCOL_TLSv1_2'``\n\nThe Databricks web service requires clients speak TLSV1.2. The built in\nversion of Python for MacOS does not have this version of TLS built in.\n\nTo use the Databricks CLI you must install a version of Python that has ``ssl.PROTOCOL_TLSv1_2``.\nFor MacOS, the easiest way may be to install Python with `Homebrew <https://brew.sh/>`_.\n\nUsing Docker\n------------\n.. code::\n\n    # build image\n    docker build -t databricks-cli .\n\n    # run container\n    docker run -it databricks-cli\n\n    # run command in docker\n    docker run -it databricks-cli fs --help\n    \nDocumentation\n-------------\n\nFor the latest CLI documentation, see\n\n- `Databricks <https://docs.databricks.com/user-guide/dev-tools/databricks-cli.html>`_\n- `Azure Databricks <https://learn.microsoft.com/en-us/azure/databricks/dev-tools/cli>`_\n",
    "bugtrack_url": null,
    "license": "Apache License 2.0",
    "summary": "A command line interface for Databricks",
    "version": "0.17.4",
    "split_keywords": [
        "databricks",
        "cli"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "md5": "f02412bdedbe99952f042e921690de5a",
                "sha256": "bbd57bc21c88ac6d1f8f0b250db986e500490c4d3cb69664229384632eaeed81"
            },
            "downloads": -1,
            "filename": "databricks_cli-0.17.4-py2-none-any.whl",
            "has_sig": false,
            "md5_digest": "f02412bdedbe99952f042e921690de5a",
            "packagetype": "bdist_wheel",
            "python_version": "2.7",
            "requires_python": null,
            "size": 147837,
            "upload_time": "2022-12-08T09:14:52",
            "upload_time_iso_8601": "2022-12-08T09:14:52.407794Z",
            "url": "https://files.pythonhosted.org/packages/58/7d/4bd6e5dc4420fb5dbb5ae895c1d9934fc0c9e77d9c5dc010725195f093a7/databricks_cli-0.17.4-py2-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "md5": "48474faed50e684a5a97c0be88b41e98",
                "sha256": "bc0c4dd082f033cb6d7978cacaca5261698efe3a4c70f52f98762c38db925ce0"
            },
            "downloads": -1,
            "filename": "databricks-cli-0.17.4.tar.gz",
            "has_sig": false,
            "md5_digest": "48474faed50e684a5a97c0be88b41e98",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": null,
            "size": 82283,
            "upload_time": "2022-12-08T09:14:50",
            "upload_time_iso_8601": "2022-12-08T09:14:50.204892Z",
            "url": "https://files.pythonhosted.org/packages/ca/18/be4b07af8cf405e60b665e8edc9bf310a6328fdbea5aca5504ed26907d12/databricks-cli-0.17.4.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2022-12-08 09:14:50",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "github_user": "databricks",
    "github_project": "databricks-cli",
    "travis_ci": false,
    "coveralls": true,
    "github_actions": true,
    "requirements": [],
    "tox": true,
    "lcname": "databricks-cli"
}
        
Elapsed time: 0.05695s