Configuratieprofielen voor de Databricks CLI

Notitie

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 bijwerken en Azure Databricks-configuratieprofielen.

Informatie over configuratieprofielen verkrijgen

Door meerdere configuratieprofielen aan het .databrickscfg bestand toe te voegen, kunt u snel opdrachten uitvoeren in verschillende werkruimten door de naam van het doelconfiguratieprofiel op te geven in de opdracht --profile of -p vlag. Als u geen profiel opgeeft, selecteert de CLI er een in de volgende volgorde:

  1. De DATABRICKS_CONFIG_PROFILE omgevingsvariabele, indien ingesteld.
  2. De default_profile instelling in de [__settings__] sectie van .databrickscfg, indien aanwezig. U kunt dit instellen met databricks auth switch. Zie databricks auth switch.
  3. Het DEFAULT profiel.

Aanbeveling

U kunt op Tab drukken na --profile of -p om een lijst weer te geven met 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, stelt u de omgevingsvariabele DATABRICKS_CONFIG_FILE in op een ander pad. Zie .databrickscfg-specifieke velden.

Voer de opdracht auth describe uit om informatie over een bestaand configuratieprofiel op te halen:

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

Hier ziet u bijvoorbeeld de uitvoer voor een profiel dat is geconfigureerd met persoonlijke toegangstokenverificatie van 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

Notitie

De auth env opdracht is afgeschaft. Gebruik databricks auth describe dit om de configuratie van een profiel te inspecteren of databricks auth token om een OAuth-toegangstoken in de cache op te halen.

Voer de opdracht auth profiles uit om informatie over alle beschikbare profielen op te halen:

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 tokendetails voor een specifiek profiel wilt weergeven, voert u uit databricks auth describe --profile <profile-name> of databricks auth token --profile <profile-name>.

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 juist hebt ingesteld, 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 ingesteld 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
  • Last updated on