Azure Databricks

Nota:

Databricks posee y proporciona este conector.

Resumen

Property Value
Conector icono de Azure Databricks Azure Databricks
Productos Power BI (modelos semánticos)
Power Query Online
Estado de lanzamiento Disponibilidad general
Category Database
Tipos de autenticación Azure Active Directory
Credenciales de cliente de Databricks
Token de acceso personal
Autenticación específica del producto Entidad de seguridad de servicio (Power BI / Fabric)
Identidad del área de trabajo (Power BI/Fabric)
Tipo de origen de datos Databricks
Documentación de referencia de funciones Databricks.Catalogs
Databricks.Contents
Databricks.Query

Importante

El conector de Azure Databricks para Power BI ahora admite el controlador Arrow Database Connectivity (ADBC). Este conector realiza la transición del controlador ODBC de Simba Spark insertado al controlador ADBC de Databricks. Para obtener instrucciones sobre la migración, fechas clave y controles de administración, consulte Transition de ODBC a controladores ADBC en Power BI y Fabric.

Prerequisites

En el caso de las redes privadas, deberá implementar la siguiente configuración de red:

  • *.blob.core.windows.net* y *.store.core.windows.net deben estar abiertos en el entorno de red.
  • Esta lista de descargas y revocaciones de certificados también debe agregarse a la lista de permitidos.
  • Si la compatibilidad con firewall está habilitada en la cuenta de almacenamiento del área de trabajo de Databricks, debe configurar una puerta de enlace de datos de red virtual o una puerta de enlace de datos local para permitir el acceso privado a la cuenta de almacenamiento. Esto garantiza que el servicio Power BI fabric pueda seguir accediendo a la cuenta de almacenamiento del área de trabajo y que CloudFetch sigue funcionando correctamente. Como alternativa, puede deshabilitar CloudFetch con la configuración EnableQueryResultDownload=0.

Capacidades soportadas

  • Importación
  • DirectQuery (modelos semánticos de Power BI)

Parameters

Punto de entrada:Databricks.Catalogs

Recuento de parámetros requerido: 2

Parameter Nombre para mostrar Required Type Group Descripción Valores de ejemplo Anulable
host Nombre del equipo servidor Yes Mensaje de texto Nombre de host del servidor de Databricks. "example.azuredatabricks.net" false
httpPath Ruta de acceso HTTP Yes Mensaje de texto Ruta de acceso HTTP del clúster. "/sql/1.0/warehouses/abcdef1234567890" false
options Opciones avanzadas No Registro anulable Opciones avanzadas true

Campos de options

Field Nombre para mostrar Required Type Group Descripción Predeterminado declarado Valores permitidos Valores de ejemplo Anulable Optional Metadatos de valores permitidos Valores declarados permitidos
options.Catalog Catálogo predeterminado No Mensaje de texto Opciones avanzadas Seleccione un catálogo predeterminado para la conexión. false true
opciones.Base de datos Database No Mensaje de texto Opciones avanzadas Limite la conexión a la base de datos seleccionada. Esto puede hacer que listar tablas sea más rápido, pero evitará el query folding para las consultas que alcanzan varias bases de datos diferentes. false true
options.QueryTags Etiquetas de búsqueda No Mensaje de texto Opciones avanzadas Etiquetas clave-valor para el seguimiento de consultas en la tabla system.query.history. "tag1:value1,tag2:value2" false true
options.EnableAutomaticProxyDiscovery Detección automática del proxy No Mensaje de texto Opciones avanzadas Esto permite la detección automática de proxy en todo el sistema Windows. "habilitado" (habilitado); "deshabilitado" (Deshabilitado (valor predeterminado)) false true [{"Metadata": {"Documentation.Caption": "Enabled", "Documentation.Name": "AutomaticProxyDiscoveryFlag.Enabled"}, "Value": "enabled"}, {"Metadata": {"Documentation.Caption": "Disabled (default)", "Documentation.Name": "AutomaticProxyDiscoveryFlag.Disabled"}, "Value": "disabled"}] ["activado", "desactivado"]
opciones.Implementación Implementation No Mensaje de texto Opciones avanzadas Use "2.0 (beta)" para especificar ADBC. El valor "predeterminado" usará la configuración del entorno para determinar qué controlador se va a usar. "2.0" "2.0" (2.0 - ADBC); null (valor predeterminado del sistema) false true ["2.0", null]
options.Protocol Protocol No Mensaje de texto Opciones avanzadas Especifica el protocolo utilizado por el controlador ADBC. Seleccione "REST (SEA)" para usar la API de ejecución de instrucciones. Cuando no se establece, se usa el valor predeterminado del controlador (Thrift). nulo null (valor predeterminado); "rest" (REST (SEA)) false true [null, "rest"]

Conéctese desde Power Query Desktop

AWS, Azure o GCP

Para conectarse a Databricks desde Power Query Desktop, siga estos pasos:

  1. En la experiencia Obtener datos, busque Databricks para obtener una lista abreviada del conector de Databricks, Azure Databricks. Use el conector Azure Databricks para todos los datos de Databricks SQL Warehouse a menos que el representante de Databricks le indique lo contrario.

    Captura de pantalla del cuadro de diálogo Obtener datos para Databricks Cloud.

  2. Proporcione el nombre de host del servidor y la ruta de acceso HTTP para su Databricks SQL Warehouse. Consulte Configurar los controladores ODBC y JDBC de Databricks para obtener instrucciones sobre cómo encontrar los valores de "Nombre de host del servidor" y "Ruta HTTP". Escriba esta información en consecuencia. Opcionalmente, puede proporcionar un catálogo y/o una base de datos predeterminados en Opciones avanzadas. Seleccione Aceptar para continuar.

    Captura de pantalla de los campos de conexión de Sql Warehouse de Databricks.

  3. Proporcione sus credenciales para autenticarse con Databricks SQL Warehouse. Hay tres opciones para las credenciales:

    • Credenciales de cliente de Databricks. Consulte Databricks OAuth M2M para obtener instrucciones sobre cómo generar credenciales de cliente de OAuth M2M de Databricks.

    • Token de acceso personal (utilizable para AWS, Azure o GCP). Para obtener instrucciones sobre cómo generar un token de acceso personal (PAT), consulte Tokens de acceso personal.

    • Azure Active Directory (solo se puede usar para Azure). Inicie sesión en su cuenta de organización con el menú emergente del explorador.

      Captura de pantalla del campo de entrada del token de Databricks.

    Nota:

    Una vez que escriba sus credenciales para una instancia determinada de Databricks SQL Warehouse, Power BI Desktop almacena en caché y reutiliza esas mismas credenciales en intentos de conexión posteriores. Si quiere modificar dichas credenciales, vaya a Archivo > Opciones y configuración > Configuración de origen de datos. Mayor información: Cambiar el método de autenticación

  4. Una vez que se conecte correctamente, el Navegador muestra los datos disponibles en el clúster. Puede elegir Transform Data para transformar los datos mediante Power Query o Load cargar los datos en Power Query Desktop.

    Imagen del navegador de Power Query cargando datos de Databricks Cloud en la aplicación de escritorio.

Conectar desde Power Query Online

Para conectarse a Databricks desde Power Query Online, siga estos pasos:

  1. Seleccione la opción Azure Databricks en la experiencia obtener datos. Las diferentes aplicaciones tienen diferentes formas de acceder a la experiencia de obtención de datos en línea Power Query. Para obtener más información sobre cómo acceder a la experiencia de obtención de datos de Power Query Online desde la aplicación, vaya a Where para obtener datos.

    Filtra los conectores de Databricks disponibles usando el cuadro de búsqueda. Use el conector Azure Databricks para todos los datos de Databricks SQL Warehouse a menos que el representante de Databricks le indique lo contrario.

    Captura de pantalla de las opciones del conector de Databricks en Power Query.

  2. Escriba el Nombre de host del servidor y la Ruta HTTP para Databricks SQL Warehouse. Consulte Configurar los controladores ODBC y JDBC de Databricks para obtener instrucciones sobre cómo encontrar los valores de "Nombre de host del servidor" y "Ruta HTTP". Opcionalmente, puede proporcionar un catálogo y/o una base de datos predeterminados en Opciones avanzadas.

    La captura de pantalla de la configuración de conexión y las credenciales de Azure Databricks.

  3. Proporcione sus credenciales para autenticarse con Databricks SQL Warehouse. Hay cuatro opciones para las credenciales:

    • Credenciales de cliente de Databricks. Para obtener instrucciones sobre cómo generar credenciales de cliente de OAuth M2M de Databricks, consulte Databricks OAuth M2M.
    • Token de acceso personal (utilizable para AWS, Azure o GCP). Consulte Tokens de Acceso Personal para obtener instrucciones sobre cómo generar un Token de Acceso Personal (PAT).
    • Azure Active Directory (solo se puede usar para Azure). Inicie sesión en su cuenta de organización con el menú emergente del explorador.
    • Entidad de servicio (solo utilizable con Azure). Autentíquese con una entidad de servicio de Microsoft Entra ID. Esta opción está disponible al configurar una conexión de nube o puerta de enlace.
  4. Una vez que se haya conectado con éxito, aparece el Navigator y muestra los datos disponibles en el servidor. Seleccione sus datos en el navegador. A continuación, seleccione Next para transformar los datos en Power Query.

    Captura de pantalla del navegador de Power Query cargando datos de Databricks Cloud en app.

Información adicional

Implementación del conector del controlador Arrow Database Connectivity para bases de datos

Puede usar el controlador Arrow Database Connectivity (ADBC) para el conector de Azure Databricks en Power BI. A medida que seguimos mejorando y agregando nuevas funcionalidades a este conector, se recomienda actualizar a la versión más reciente para probarlo y enviar comentarios sobre el producto.

Nota:

Desde febrero de 2026, las nuevas conexiones creadas en Power BI Desktop o en Power BI Service usarán automáticamente el controlador Arrow Database Connectivity (ADBC) por defecto. Las conexiones existentes seguirán usando ODBC a menos que las actualice manualmente a ADBC.

Para cambiar al controlador ADBC:

  1. Abra el panel deseado en Power BI.
  2. Seleccione Transformar datos.
  3. Seleccione Editor avanzado en la sección de opciones Query.
  4. Especifique Implementation="2.0" para ADBC.
    let
        Source = Databricks.Catalogs("adb-<workspace-id>.<random-number>.azuredatabricks.net", "/sql/1.0/warehouses/<sql-warehouse-id>",
            [Catalog=null, Database=null, EnableAutomaticProxyDiscovery=null, Implementation="2.0"]),
        powerbi_Database = Source{[Name="powerbi",Kind="Database"]}[Data],
        default_Schema = powerbi_Database{[Name="default",Kind="Schema"]}[Data],
        dashboard_data_Table = default_Schema{[Name="dashboard_data",Kind="Table"]}[Data]
    in
        dashboard_data_Table
    

Limitaciones y consideraciones

  • El conector de Azure Databricks admite web proxy. Sin embargo, no se admite la configuración de proxy automática definida en archivos .pac.
  • En el conector de Azure Databricks, el origen de datos Databricks.Query no se admite en combinación con el modo DirectQuery del modelo semántico de Power BI.