Perfiles de configuración para la CLI de Databricks

Nota:

El uso de la CLI de Databricks está sujeto a la licencia de Databricks y al aviso de privacidad de Databricks, incluidas las disposiciones de datos de uso.

En este artículo se describe cómo usar la CLI de Databricks con perfiles de configuración. Se supone que ya ha instalado la CLI de Databricks y ha creado un archivo de perfiles de configuración de Databricks. Consulte Instalación o actualización de los perfiles de configuración de la CLI de Databricks y Azure Databricks.

Tener información sobre los perfiles de configuración

Agregar varios perfiles de configuración al archivo .databrickscfg le permite ejecutar comandos rápidamente en varias áreas de trabajo al especificar el nombre del perfil de configuración de destino en el indicador --profile o -p del comando. Si no especifica un perfil, la CLI selecciona una en el orden siguiente:

  1. La variable de entorno DATABRICKS_CONFIG_PROFILE, si está definida.
  2. La configuración default_profile en la sección [__settings__] de .databrickscfg, si está presente. Puede establecerlo con databricks auth switch. Consulte databricks auth switch.
  3. Perfil DEFAULT .

Sugerencia

Puede presionar Tab después --profile o -p para mostrar una lista de los perfiles de configuración disponibles existentes desde los que elegir.

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. Para cambiar la ruta de acceso predeterminada del .databrickscfg archivo, establezca la variable DATABRICKS_CONFIG_FILE de entorno en otra ruta de acceso. Consulte los campos específicos de .databrickscfg.

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

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

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

Host: https://dbc-a1b2345c-d6e7.cloud.databricks.com
User: user@example.com
Authenticated with: pat
-----
Current configuration:
  ✓ host: https://dbc-a1b2345c-d6e7.cloud.databricks.com (from ~/.databrickscfg config file)
  ✓ token: ******** (from ~/.databrickscfg config file)
  ✓ profile: <configuration-profile-name> (from --profile flag)
  ✓ auth_type: pat

Nota:

El comando auth env está en desuso. Use databricks auth describe para inspeccionar la configuración de un perfil o databricks auth token para recuperar un token de acceso de OAuth almacenado en caché.

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

databricks auth profiles

Name                     Host                                            Valid
DEFAULT                  https://dbc-a1b2345c-d6e7.cloud.databricks.com  YES
Development              https://dbc-a1b2345c-d6e7.cloud.databricks.com  YES
Staging                  https://dbc-a1b2345c-d6e7.cloud.databricks.com  YES
Production               https://dbc-a1b2345c-d6e7.cloud.databricks.com  YES

La salida del auth profiles comando no muestra ningún token de acceso. Para mostrar los detalles del token de un perfil específico, ejecute databricks auth describe --profile <profile-name> o databricks auth token --profile <profile-name>.

Importante

La CLI de Databricks 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 los perfiles de configuración

Para probar los perfiles de configuración y comprobar que ha configurado la autenticación correctamente, ejecute un comando que se conecte a un área de trabajo.

Si no especifica un perfil, se usa el perfil predeterminado. Por ejemplo, el siguiente comando enumera las versiones disponibles de Databricks Runtime para el área de trabajo de Azure Databricks asociada al DEFAULT perfil.

Nota:

Este comando supone que no tiene ninguna variable de entorno establecida que tenga 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

Para comprobar un perfil de configuración específico, proporcione el nombre del perfil mediante la -p marca .

databricks clusters spark-versions -p PROD
  • Last updated on