Configurare l'autorizzazione per l'estensione IDE Databricks

Questo articolo descrive come impostare l'autorizzazione e l'autenticazione tra l'estensione IDE Databricks e il tuo workspace Azure Databricks, se non hai già configurato l'estensione tramite la configurazione del progetto. Vedi estensione IDE Databricks.

L'estensione IDE Databricks implementa parti dello standard di autenticazione unificata Databricks, che ti permette di configurare una sola volta l'autorizzazione basata su Azure Databricks OAuth 2.0 e poi utilizzare quella configurazione su più strumenti e SDK Azure Databricks senza ulteriori modifiche di autorizzazione e autenticazione. Fornisce anche aggiornamenti automatici dei token di accesso attivi, riducendo la complessità del processo durante lo sviluppo.

Databricks raccomanda l'autorizzazione utente interattiva OAuth, che è facile da configurare utilizzando l'estensione IDE Databricks. 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 interfaccia della riga di comando di Azure, vedere Impostare l'autenticazione interfaccia della riga di comando di Azure.

Nota

L'estensione IDE Databricks non supporta l'autenticazione tramite identità gestite Azure (precedentemente Azure Managed Service Identities (MSI)), ma Databricks Connect usato senza l'estensione IDE Databricks sì. 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 la configurazione dell'autorizzazione OAuth, apri il tuo progetto VSCode con l'estensione IDode Databricks 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 dello spazio di lavoro che hai inserito, insieme ad altri dettagli di configurazione di Azure Databricks utilizzati dall'estensione IDE Databricks.

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 interfaccia della riga di comando di Azure

Azure Databricks supporta l'autenticazione con interfaccia della riga di comando di Azure 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 interfaccia della riga di comando di Azure 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 interfaccia della riga di comando di Azure.