Condividi tramite

Interfaccia a riga di comando di Databricks

Nota

Queste informazioni si applicano all'interfaccia della riga di comando di Databricks versione 0.205 e successive. L'interfaccia della riga di comando di Databricks è disponibile in anteprima pubblica.

L'uso della CLI di Databricks è soggetto alla Licenza di Databricks e all'Informativa sulla privacy di Databricks, incluse eventuali disposizioni sui dati di utilizzo.

L'interfaccia della riga di comando Databricks (interfaccia della riga di comando) consente di interagire con la piattaforma Azure Databricks dal terminale locale o dagli script di automazione. È anche possibile eseguire i comandi dell'interfaccia della riga di comando di Databricks dall'interno di un'area di lavoro di Databricks usando il terminale Web. Consulta eseguire i comandi della shell nel terminale web di Azure Databricks.

Per installare e configurare l'autenticazione per il Databricks CLI, vedere Installare o aggiornare il Databricks CLI e Autenticazione per il Databricks CLI.

Consiglio

L'origine dell'interfaccia della riga di comando di Databricks è disponibile pubblicamente nel repository databricks/cli GitHub.

Informazioni per gli utenti del Databricks CLI legacy

  • Databricks non ha piani per il supporto o lo sviluppo di nuove funzionalità per la versione obsoleta dell'interfaccia della riga di comando di Databricks.
  • Per ulteriori informazioni sulla versione legacy dell'interfaccia della riga di comando di Databricks, vedere Legacy Databricks CLI.
  • Per eseguire la migrazione dalla CLI di Databricks versione 0.18 o precedente alla CLI di Databricks versione 0.205 o successiva, vedere Migrazione della CLI di Databricks.

Come funziona l'interfaccia della riga di comando di Databricks?

L'interfaccia della riga di comando avvolge l'API REST di Databricks, che fornisce endpoint per modificare o richiedere informazioni sugli oggetti dell'account e dell'area di lavoro di Azure Databricks. Consultare il riferimento API REST di Azure Databricks.

Ad esempio, per stampare informazioni su un singolo cluster in un'area di lavoro, eseguire l'interfaccia della riga di comando come indicato di seguito:

databricks clusters get 1234-567890-a12bcde3

Con curl, l'operazione equivalente è la seguente:

curl --request GET "https://${DATABRICKS_HOST}/api/2.0/clusters/get" \
     --header "Authorization: Bearer ${DATABRICKS_TOKEN}" \
     --data '{ "cluster_id": "1234-567890-a12bcde3" }'

Esempio: creare un job Azure Databricks

Nell'esempio seguente viene usata l'interfaccia della riga di comando per creare un processo Azure Databricks. Questo lavoro contiene una singola attività lavorativa. Questa attività esegue il notebook di Azure Databricks specificato. Questo notebook ha una dipendenza da una versione specifica del pacchetto PyPI denominato wheel. Per eseguire questa attività, il processo crea temporaneamente un cluster di processi che esporta una variabile di ambiente denominata PYSPARK_PYTHON. Dopo l'esecuzione del processo, il cluster viene terminato.

databricks jobs create --json '{
  "name": "My hello notebook job",
  "tasks": [
    {
      "task_key": "my_hello_notebook_task",
      "notebook_task": {
        "notebook_path": "/Workspace/Users/someone@example.com/hello",
        "source": "WORKSPACE"
      },
      "libraries": [
        {
          "pypi": {
            "package": "wheel==0.41.2"
          }
        }
      ],
      "new_cluster": {
        "spark_version": "13.3.x-scala2.12",
        "node_type_id": "Standard_DS3_v2",
        "num_workers": 1,
        "spark_env_vars": {
          "PYSPARK_PYTHON": "/databricks/python3/bin/python3"
        }
      }
    }
  ]
}'

Passaggi successivi

  • Last updated on