Conexión manual a SQL Workbench/J

En este artículo se describe cómo usar SQL Workbench/J con Azure Databricks.

Requisitos

• SQL Workbench/J.

• Controlador JDBC de Databricks. Descargue Databricks JDBC Driver en la máquina de desarrollo local, extrayendo el archivo DatabricksJDBC42.jar del archivo descargado DatabricksJDBC42-<version>.zip.

  Nota:

  Este artículo se ha probado con macOS, SQL Workbench/J Build 130, Zulu OpenJDK 21.0.1 y Databricks JDBC Driver 2.6.36.

  Para la autenticación de Azure Databricks, si no usa la autenticación de tokens de acceso personal, puede omitir la generación de un token de acceso personal más adelante en estos requisitos. Para más información sobre los tipos de autenticación de Azure Databricks disponibles, consulte Configuración de autenticación del controlador JDBC de Databricks (Simba).

• Un clúster o almacén SQL en el área de trabajo de Azure Databricks.

  • Referencia de configuración de proceso.
  • Creación de un almacén de SQL.

• Los detalles de la conexión del clúster o almacén SQL, concretamente los valores Nombre de host del servidor, Puerto y Ruta de acceso HTTP.

  • Obtener detalles de conexión para un recurso de proceso de Azure Databricks.

• Un token de acceso personal de Azure Databricks o un token de Microsoft Entra ID (anteriormente, Azure Active Directory). Para crear un token de acceso personal, siga los pasos descritos en Creación de tokens de acceso personal para los usuarios del área de trabajo.

  Nota:

  Como procedimiento recomendado de seguridad, cuando se autentique con herramientas, sistemas, scripts y aplicaciones automatizados, Databricks recomienda usar los tokens de acceso personal pertenecientes a las entidades de servicio en lugar de a los usuarios del área de trabajo. Para crear tókenes para entidades de servicio, consulte Administración de tokens de acceso para una entidad de servicio.

Pasos para conectarse a Workbench/J

Para conectarse a Workbench/J, haga lo siguiente:

1. Inicie SQL Workbench/J.
2. Seleccione la ventana File > Connect (Archivo > Conectar).
3. En el cuadro de diálogo Select Connection Profile (Seleccionar perfil de conexión), haga clic en Manage Drivers (Administrar controladores).
   1. En el campo Nombre, escriba Databricks.
   2. En el campo Biblioteca, haga clic en el icono Seleccionar los archivos JAR. Vaya al directorio donde extrajo el archivo DatabricksJDBC42.jar del archivo descargado DatabricksJDBC42-<version>.zip y seleccione el archivo JAR. A continuación, haga clic en Elegir.
   3. Compruebe que el campo Classname (Nombre de clase) está rellenado con com.databricks.client.jdbc.Driver.
   4. Haga clic en OK.
4. Haga clic en el icono Create a new connection profile (Crear un nuevo perfil de conexión) .
   1. Escriba un nombre para el perfil.
   2. En el campo Controlador, seleccione Databricks (com.databricks.client.jdbc.Driver).
   3. En el campo URL, escriba la dirección URL de JDBC del recurso de Azure Databricks. Para obtener la sintaxis del campo URL para las URLs de JDBC, consulte Configuración de autenticación para el controlador JDBC de Databricks (Simba).
   4. Haga clic en Probar.
   5. Haga clic en Aceptar dos veces.

Recursos adicionales

• SQL Workbench/J
• Soporte técnico