Perfiles de configuración para la CLI de Databricks

Nota:

Esta información se aplica a las versiones 0.205 y posteriores de la CLI de Databricks, que se encuentran en Versión preliminar pública. Para encontrar su versión de la CLI de Databricks, ejecute databricks -v.

En este artículo se describe cómo configurar la autenticación entre la CLI de Databricks y las cuentas y áreas de trabajo de Azure Databricks. Consulte ¿Qué es la CLI de Databricks?.

En este artículo se supone que ya ha instalado la CLI de Databricks y ha configurado la CLI para la autenticación. Vea:

• Instalación o actualización de la CLI de Databricks
• Autenticación para la CLI de Databricks

Tener información sobre los perfiles de configuración

Agregar varios perfiles de configuración al .databrickscfg archivo permite ejecutar rápidamente comandos en varias áreas de trabajo especificando el nombre del perfil de configuración de destino en la opción o --profile del -p comando, para los comandos que admiten esta opción. Si no especifica la opción --profile o -p en un comando que admite esta opción, el comando usará el DEFAULT perfil de configuración de forma predeterminada.

Sugerencia

Puede presionar Tab después de --profile o -p para mostrar una lista de perfiles de configuración disponibles entre los que elegir, en lugar de escribir manualmente el nombre del perfil de configuración.

Por ejemplo, podría tener un perfil de configuración denominado DEV que haga referencia a un área de trabajo de Azure Databricks que use para cargas de trabajo de desarrollo y un perfil de configuración independiente denominado PROD que haga referencia a un área de trabajo de Azure Databricks diferente que use para cargas de trabajo de producción.

De forma predeterminada, la CLI de Databricks busca este .databrickscfg archivo en la ~ carpeta (su inicio de usuario) en Unix, Linux o macOS, o en la %USERPROFILE% carpeta (inicio del usuario) en Windows. Puedes cambiar la ruta por defecto del archivo .databrickscfg configurando la variable de entorno DATABRICKS_CONFIG_FILE. Para aprender cómo establecer estas variables de entorno, consulte la documentación del sistema operativo.

Para obtener información sobre un perfil de configuración existente, ejecute el auth env comando:

databricks auth env --profile <configuration-profile-name>

# Or:
databricks auth env --host <account-console-url>

# Or:
databricks auth env --host <workspace-url>

Por ejemplo, este es el resultado de un perfil configurado con la autenticación de token de acceso personal de Azure Databricks:

{
  "env": {
    "DATABRICKS_AUTH_TYPE": "pat",
    "DATABRICKS_CONFIG_PROFILE": "<configuration-profile-name>",
    "DATABRICKS_HOST": "<workspace-url>",
    "DATABRICKS_TOKEN": "<token-value>"
  }
}

Para obtener información sobre todos los perfiles disponibles, ejecute el comando auth profiles:

databricks auth profiles

Salida (los puntos suspensivos representan contenido omitido, por brevedad):

{
  "profiles": [
    {
      "name": "<configuration-profile-name>",
      "host": "<workspace-url>",
      "cloud": "<cloud-id>",
      "auth_type": "<auth-type>",
      "valid": true
    },
    {
      "...": "..."
    }
  ]
}

La salida del auth profiles comando no muestra ningún token de acceso. Para mostrar un token de acceso, ejecute el comando anterior auth env.

Importante

La CLI no funciona con un archivo .netrc. Puede tener un archivo .netrc en su entorno para otros fines, pero la CLI no usará ese archivo .netrc.

Prueba de la configuración del perfil de configuración PREDETERMINADO

Para comprobar si ha configurado correctamente la autenticación, puede ejecutar un comando como el siguiente, que enumera las versiones disponibles de Databricks Runtime para el área de trabajo de Azure Databricks asociada al DEFAULT perfil.

En la siguiente llamada se da por supuesto que no tiene ninguna variable de entorno especial establecida, que tiene prioridad sobre la configuración del DEFAULT perfil. Para obtener más información, consulte Orden de evaluación de autenticación.

databricks clusters spark-versions

Prueba tus perfiles de configuración

Para comprobar si has configurado correctamente algún perfil de configuración, puedes ejecutar un comando como el siguiente con uno de los nombres de tus perfiles de configuración a nivel de área de trabajo. Este comando enumera las versiones disponibles de Databricks Runtime para el área de trabajo de Azure Databricks asociada al perfil de configuración especificado, representado aquí por el marcador de posición <configuration-profile-name>:

databricks clusters spark-versions -p <configuration-profile-name>

Sugerencia

Puede presionar Tab después de --profile o -p para mostrar una lista de perfiles de configuración disponibles entre los que elegir, en lugar de escribir manualmente el nombre del perfil de configuración.

Para enumerar los detalles de un perfil específico, ejecute el siguiente comando:

databricks auth env --profile <configuration-profile-name>

Para enumerar los detalles de todos los perfiles disponibles, ejecute el siguiente comando:

databricks auth profiles