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. La CLI de Databricks está en versión preliminar pública.

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 se especifica, se usa el DEFAULT perfil de configuración.

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 campos específicos de .databrickscfg.

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": "DEFAULT",
    "DATABRICKS_HOST": "https://dbc-a1b2345c-d6e7.cloud.databricks.com",
    "DATABRICKS_TOKEN": "dapi123..."
  }
}

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