Configuratieprofielen voor de Databricks CLI

Notitie

Deze informatie is van toepassing op Databricks CLI-versies 0.205 en hoger. De Databricks CLI bevindt zich in openbare preview.

Databricks CLI-gebruik is onderhevig aan de Databricks-licentie en de privacyverklaring van Databricks, met inbegrip van alle bepalingen voor gebruiksgegevens.

In dit artikel wordt beschreven hoe u de Databricks CLI gebruikt met configuratieprofielen. Hierbij wordt ervan uitgegaan dat u de Databricks CLI al hebt geïnstalleerd en een Databricks-configuratieprofielenbestand hebt gemaakt. Zie De Databricks CLI installeren of update en Azure Databricks-configuratieprofielen.

Get informatie over configuratieprofielen

Door meerdere configuratieprofielen toe te voegen aan het .databrickscfg-bestand kunt u snel opdrachten uitvoeren in verschillende werkruimten door de naam van het doelconfiguratieprofiel op te geven in de --profile of -p vlag van de opdracht. Als dit niet is opgegeven, wordt het DEFAULT configuratieprofiel gebruikt.

Tip

U kunt op Tab drukken na --profile of -p om een list weer te geven van bestaande beschikbare configuratieprofielen waaruit u kunt kiezen.

U kunt bijvoorbeeld een configuratieprofiel DEV hebben dat verwijst naar een Azure Databricks-werkruimte die u gebruikt voor ontwikkelworkloads en een afzonderlijk configuratieprofiel met de naam PROD die verwijst naar een andere Azure Databricks-werkruimte die u gebruikt voor productieworkloads.

De Databricks CLI zoekt standaard naar het .databrickscfg bestand in de ~ map (de startpagina van uw gebruiker) in Unix, Linux of macOS, of uw %USERPROFILE% map (de startpagina van uw gebruiker) in Windows. Als u het standaardpad van het .databrickscfg-bestand wilt wijzigen, set de omgevingsvariabele DATABRICKS_CONFIG_FILE naar een ander pad. Zie .databrickscfg-specifieke omgevingsvariabelen en -velden.

Als u informatie over een bestaand configuratieprofiel wilt get, voert u de opdracht auth env uit:

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

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

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

Hier ziet u bijvoorbeeld de uitvoer voor een profiel dat is geconfigureerd met persoonlijke toegangstokenverificatie van Azure Databricks:

{
  "env": {
    "DATABRICKS_AUTH_TYPE": "pat",
    "DATABRICKS_CONFIG_PROFILE": "DEFAULT",
    "DATABRICKS_HOST": "https://dbc-a1b2345c-d6e7.cloud.databricks.com",
    "DATABRICKS_TOKEN": "dapi123..."
  }
}

Als u informatie over alle beschikbare profielen wilt get, voert u de opdracht auth profiles uit:

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

In de uitvoer van de auth profiles opdracht worden geen toegangstokens weergegeven. Als u een toegangstoken wilt weergeven, voert u de voorgaande auth env opdracht uit.

Belangrijk

De Databricks CLI werkt niet met een .netrc-bestand. U kunt een .netrc bestand in uw omgeving hebben voor andere doeleinden, maar de Databricks CLI gebruikt dat .netrc bestand niet.

Uw configuratieprofielen testen

Als u uw configuratieprofielen wilt testen en wilt controleren of u de verificatie correct hebt set, voert u een opdracht uit die verbinding maakt met een werkruimte.

Als u geen profiel opgeeft, wordt het standaardprofiel gebruikt. Met de volgende opdracht worden bijvoorbeeld de beschikbare Databricks Runtime-versies weergegeven voor de Azure Databricks-werkruimte die is gekoppeld aan uw DEFAULT-profiel.

Notitie

Met deze opdracht wordt ervan uitgegaan dat u geen omgevingsvariabelen hebt set die voorrang hebben op de instellingen in uw DEFAULT-profiel. Zie Verificatievolgorde van evaluatie voor meer informatie.

databricks clusters spark-versions

Als u een specifiek configuratieprofiel wilt controleren, geeft u de profielnaam op met behulp van de vlag -p.

databricks clusters spark-versions -p PROD