Compartir vía

Conexión manual a SQL Workbench/J

  • Artículo

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

Nota:

En este artículo se trata SQL Workbench/J, que no se proporciona ni es compatible con Databricks. Para ponerse en contacto con el proveedor, consulte el foro de soporte técnico de SQL Workbench/J en Google Groups..

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, vea configuración de autenticación para el controlador JDBC de Databricks.

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

  • 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.

  • 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, haga lo siguiente:

    1. En el área de trabajo de Azure Databricks, haga clic en el nombre de usuario de Azure Databricks de la barra superior y, a continuación, seleccione Configuración en la lista desplegable.
    2. Haga clic en Desarrollador.
    3. Junto a Tokens de acceso, haga clic en Administrar.
    4. Haga clic en Generate new token (Generar nuevo token).
    5. (Opcional) Escriba un comentario que le ayude a identificar este token en el futuro y cambie la duración predeterminada del token de 90 días. Para crear un token sin duración (no recomendado), deje el cuadro Duración (días) vacío (en blanco).
    6. Haga clic en Generar.
    7. Copie el token mostrado en una ubicación segura y, a continuación, haga clic en Listo.

    Nota:

    Asegúrese de guardar el token copiado en una ubicación segura. No comparta el token copiado con otros usuarios. Si pierde el token copiado, no podrá volver a generar ese mismo token. Debe repetir el procedimiento para crear un nuevo token. Si pierde el token copiado o cree que el token se ha visto comprometido, Databricks recomienda eliminar inmediatamente ese token del área de trabajo haciendo clic en el icono de papelera (Revocar) situado junto al token en la página Tokens de acceso.

    Si no puede crear o usar tokens en el área de trabajo, puede deberse a que el administrador del área de trabajo tiene tokens deshabilitados o no le ha concedido permiso para crear o usar tokens. Consulte el administrador del área de trabajo o los siguientes temas:

    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 direcciones URL de JDBC, vea Configuración de la conexión para el controlador JDBC de Databricks.
    4. Haga clic en Probar.
    5. Haga clic en Aceptar dos veces.

Recursos adicionales