Condividi tramite

Connettersi a SQL Workbench/J

  • Articolo

Questo articolo descrive come usare SQL Workbench/J con Azure Databricks.

Nota

Questo articolo tratta di SQL Workbench/J, che non è fornito né supportato da Databricks. Per contattare il fornitore, consultare il forum di supporto di SQL Workbench/J in Google Groups.

Requisiti

  • SQL Workbench/J.

  • Il Driver JDBC di Databricks. Scaricare il driver JDBC di Databricks nel computer di sviluppo locale, estraendo il file DatabricksJDBC42.jardal file scaricato DatabricksJDBC42-<version>.zip.

    Nota

    Questo articolo è stato testato con macOS, SQL Workbench/J Build 130, Zulu OpenJDK 21.0.1 e Databricks JDBC Driver 2.6.36.

    Per l'autenticazione di Azure Databricks, se non si utilizza l'autenticazione con token di accesso personale di Azure Databricks, si può saltare la generazione di un token di accesso personale più avanti in questi requisiti. Per ulteriori informazioni sui tipi di autenticazione disponibili per Azure Databricks, consultare Impostazioni di autenticazione per il driver JDBC di Databricks.

  • Un cluster o SQL Warehouse nell'area di lavoro di Azure Databricks.

  • I dettagli di connessione per il cluster o SQL Warehouse, in particolare i valori Nome host server, Porta e Percorso HTTP.

  • Un token di accesso personale di Azure Databricks o un token Microsoft Entra ID (in precedenza Azure Active Directory). Per creare un token di accesso personale, eseguire le attività seguenti:

    1. Nell'area di lavoro di Azure Databricks, fare clic sul nome utente di Azure Databricks nella barra superiore, quindi selezionare Impostazioni nell'elenco a discesa.
    2. Fare clic su Sviluppatore.
    3. Accanto a Token di accesso fare clic su Gestisci.
    4. Fare clic su Generare nuovi token.
    5. (Facoltativo) Immettere un commento che consente di identificare questo token in futuro e modificare la durata predefinita del token di 90 giorni. Per creare un token senza durata (scelta non consigliata), lasciare vuota la casella Durata (giorni).
    6. Fare clic su Genera.
    7. Copiare il token visualizzato in un percorso sicuro e quindi fare clic su Fine.

    Nota

    Assicurarsi di salvare il token copiato in un percorso sicuro. Non condividere il token copiato con altri utenti. Se si perde il token copiato, non è possibile rigenerare lo stesso esatto token. È invece necessario ripetere questa procedura per creare un nuovo token. Se si perde il token copiato o si ritiene che il token sia stato compromesso, Databricks consiglia vivamente di eliminare immediatamente il token dall'area di lavoro facendo clic sull'icona del cestino (Revoca) accanto al token nella pagina Token di accesso.

    Se non è possibile creare o usare un token di accesso personale nell'area di lavoro, questo potrebbe essere dovuto al fatto che l'amministratore dell'area di lavoro ha disabilitato i token o non ha concesso l'autorizzazione per creare o usare token. Consultare l'amministratore dell'area di lavoro o i seguenti argomenti:

    Nota

    Come procedura consigliata per la sicurezza, quando si esegue l'autenticazione con strumenti automatizzati, sistemi, script e app, Databricks consiglia di usare token di accesso personali appartenenti alle entità servizio, anziché agli utenti dell'area di lavoro. Per creare token per le entità servizio, vedere Gestire i token per un'entità servizio.

Passaggi per la connessione a Workbench/J

Per connettersi a Workbench/J, eseguire le seguenti operazioni:

  1. Avviare SQL Workbench/J.
  2. Selezionare File > Connetti finestra.
  3. Nella finestra di dialogo Seleziona profilo di connessione, fare clic suGestisci driver.
    1. Nel campo Nome, digitare Databricks.
    2. Nel campo Libreria fare clic sull'icona Selezionare i file JAR. Passare alla directory in cui è stato estratto il file DatabricksJDBC42.jar dal file scaricato DatabricksJDBC42-<version>.zip e selezionare il file JAR. Fai clic su Scegli.
    3. Verificare che il campo Nome classe sia popolato con com.databricks.client.jdbc.Driver.
    4. Fare clic su OK.
  4. Fare clic sull’icona Creare un nuovo profilo di connessione.
    1. Digitare un nome per il profilo.
    2. Nel campo Driver selezionare Databricks (com.databricks.client.jdbc.Driver).
    3. Nel campo URL immettere l'URL JDBC per la risorsa di Azure Databricks. Per la sintassi del campo URL per gli URL JDBC, consultare Impostazioni di autenticazione per il driver JDBC di Databricks.
    4. Fare clic su Test.
    5. Fare clic su OK due volte.

Risorse aggiuntive