Condividi tramite


Configurare l'autorizzazione per l'estensione Databricks per Visual Studio Code

Questo articolo descrive come configurare l'autorizzazione e l'autenticazione tra l'estensione Databricks per Visual Studio Code e l'area di lavoro Azure Databricks se non è già stata configurata l'estensione tramite la configurazione del progetto. Vedere estensione Databricks per Visual Studio Code.

L'estensione Databricks per Visual Studio Code implementa parti dello standard Databricks unified authentication, che consente di configurare Azure Databricks autorizzazione basata su OAuth 2.0 e quindi usare tale configurazione in più Azure Databricks strumenti e SDK senza ulteriori modifiche di autorizzazione e configurazione dell'autenticazione. Fornisce anche aggiornamenti automatici dei token di accesso attivi, riducendo la complessità del processo durante lo sviluppo.

Databricks consiglia l'autorizzazione utente interattiva OAuth, facile da configurare usando l'estensione Databricks per Visual Studio Code. Vedere Configurare l'autorizzazione e l'autenticazione OAuth.

In caso contrario, se si usa Autenticazione con token di accesso personali di Azure Databricks (legacy), Autorizzare l'accesso del principal di servizio a Azure Databricks con OAuth o Autenticare con principal di servizio Microsoft Entra, vedere Impostare l'autenticazione con un profilo di configurazione. Per Authenticate con Azure CLI, vedere Impostare l'autenticazione Azure CLI.

Nota

L'estensione Databricks per Visual Studio Code non supporta l'autenticazione usando identità gestite di Azure (in precedenza identità del servizio gestite di Azure (MSI)), ma Databricks Connect può essere usato senza l'estensione Databricks per Visual Studio Code. Per installare Databricks Connect, vedere Installare Databricks Connect per Python.

Configurare l'autorizzazione e l'autenticazione OAuth

Azure Databricks supporta l'autorizzazione e l'autenticazione basata su OAuth 2.0 e semplifica la gestione dei token di accesso con Databricks unified authentication. Per altre informazioni sull'autorizzazione dell'utente e dell'entità servizio con Azure Databricks, vedere Autorizzare l'accesso alle risorse Azure Databricks.

Per completare l'installazione per l'autorizzazione OAuth, aprire il progetto VSCode con l'estensione Databricks per Visual Studio Code abilitata:

  1. Nella visualizzazione Configurazione fare clic su Tipo di autenticazione e poi sull'icona a forma di ingranaggio (Accedi all'area di lavoro di Databricks).

    Accedere all'area di lavoro di Databricks

  2. Se si dispone già di un profilo di configurazione di autenticazione in questo elenco con l'etichetta Authenticate using OAuth (User to Machine) e che si conosce corrisponde all'host Databricks di destinazione, selezionarlo dall'elenco e quindi eseguire le operazioni seguenti:

    1. Se richiesto, completare le istruzioni visualizzate nel Web browser per completare l'autenticazione con Azure Databricks.
    2. Se richiesto, consentire l'accesso a tutti gli API.
    3. Vai direttamente a Seleziona calcolo per eseguire codice e processi.
  3. Nella Palette dei comandi , per Selezionare il metodo di autenticazione, fare clic su OAuth (da utente a macchina).

  4. Per Selezionare il metodo di autenticazione, selezionare OAuth (da utente a computer).

  5. Immettere un nome per il profilo di autenticazione Azure Databricks associato.

  6. Nella visualizzazione Configurazione fare clic su Accedi a Databricks.

    Accedere a Databricks

  7. Nel riquadro comandi per Selezionare il metodo di autenticazioneselezionare il nome del profilo di configurazione dell'autenticazione appena creato.

  8. Se richiesto, completare le istruzioni visualizzate nel Web browser per completare l'autenticazione con Azure Databricks. Se richiesto, consentire l'accesso a tutti gli API.

  9. Dopo aver eseguito l'accesso, tornare a Visual Studio Code.

Configurare l'autenticazione con un profilo di configurazione

Le istruzioni seguenti presuppongono che sia già stato configurato un profilo di configurazione Azure Databricks con i campi obbligatori per il tipo di autenticazione Azure Databricks. Per creare un profilo, vedere profili di configurazione di Azure Databricks. Per configurare le impostazioni per il profilo, vedere la scheda Profile o la sezione relativa al tipo di autenticazione in Autorizzare l'accesso alle risorse Azure Databricks.

Per selezionare il profilo di configurazione da usare con il progetto e l'estensione aperta, eseguire le operazioni seguenti:

  1. Nella visualizzazione Configurazione fare clic su Tipo di autenticazione e poi sull'icona a forma di ingranaggio (Accedi all'area di lavoro di Databricks).

    Accedere all'area di lavoro di Databricks

  2. Nell'Riquadro comandi selezionare il profilo di configurazione Azure Databricks di destinazione nell'elenco.

    Suggerimento

    L'host dell'area di lavoro di destinazione può essere modificato in un secondo momento modificando l'impostazione di destinazione workspace nel file di configurazione databricks.yml associato al progetto. Si veda Obiettivi.

Se non si dispone di un profilo di configurazione, è possibile crearne uno che esegue l'autenticazione usando un token di accesso personale Azure Databricks, ad esempio, come indicato di seguito:

  1. Con il progetto e l'estensione aperta, nella visualizzazione Configurazione fare clic su Tipo di autenticazione o Accesso a Databricks, quindi fare clic sull'icona a forma di ingranaggio (Accedi all'area di lavoro di Databricks).

    Accedere all'area di lavoro di Databricks

  2. Nella Palette comandi , selezionare Token di Accesso Personale.

  3. Completate le richieste sullo schermo per eseguire le seguenti operazioni:

    1. Immettere un nome per il profilo di autenticazione Azure Databricks associato.
    2. Generare il token di accesso personale nell'area di lavoro Azure Databricks e quindi copiare il valore del token.
    3. Tornare all'estensione e immettere il valore del token copiato.

L'estensione crea una cartella nel progetto denominata .databricks con un file denominato databricks.env, se non esiste già. Questo file contiene l'host dell'area di lavoro immesso, insieme ad altri dettagli di configurazione Azure Databricks usati dall'estensione Databricks per Visual Studio Code.

L'estensione aggiunge al progetto anche un file nascosto .gitignore, se il file non esiste o se non è possibile trovare un file esistente .gitignore in cartelle padre. Se viene creato un nuovo file.gitignore, l'estensione aggiunge una voce .databricks/ al nuovo file. Se l'estensione trova un file esistente .gitignore, aggiunge una voce .databricks/ al file esistente.

Impostare l'autenticazione Azure CLI

Azure Databricks supporta l'autenticazione con Azure CLI installata in locale. In questo modo è possibile generare token di breve durata (un'ora) Microsoft Entra ID, eliminando così il rischio di esporre accidentalmente token di lunga durata, ad esempio token di accesso personale di Azure Databricks tramite check-in nel controllo di versione o altri mezzi.

Dopo aver aperto il progetto e l'estensione e il Azure CLI installato in locale, eseguire le operazioni seguenti:

  1. Nella visualizzazione Configurazione fare clic su Configura Databricks.

    Nota

    Se Configura Databricks non è visibile, fare clic sull'icona a forma di ingranaggio (Configura area di lavoro) accanto a Configurazione.

    Icona a forma di ingranaggio per configurare le impostazioni dell'area di lavoro 1

  2. Nella Palette dei comandi, per Host Databricks, immettere l'URL per spazio di lavoro, ad esempio https://adb-1234567890123456.7.azuredatabricks.net. Premere INVIO.

  3. Selezionare Azure CLI.