configure opdrachtgroep

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.

configure Met de opdrachtgroep in de Databricks CLI kunt u de Databricks CLI verifiëren met Azure Databricks met behulp van persoonlijke toegangstokens van Azure Databricks of Microsoft Entra ID-tokens (voorheen Azure Active Directory).

Notitie

Als best practice voor beveiliging, wanneer u zich verifieert met geautomatiseerde hulpprogramma's, systemen, scripts en apps, raadt Databricks u aan om persoonlijke toegangstokens te gebruiken die behoren tot service-principals in plaats van werkruimtegebruikers. Zie Tokens voor een service-principal beheren om tokens voor service-principals te maken.

Houd er rekening mee dat dit artikel alleen betrekking heeft op het persoonlijke toegangstoken van Azure Databricks en microsoft Entra ID-tokenverificatie voor het aanroepen van opdrachten op werkruimteniveau . Zie Verificatie voor de Databricks CLI voor aanvullende configuratieopties voor verificatie.

Belangrijk

Voordat u deze opdracht uitvoert, moet u ervoor zorgen dat u de Databricks CLI.

U voert opdrachten uit configure door ze toe te voegen aan databricks configure. Als u help voor de configure opdracht wilt weergeven, voert u het volgende uit databricks configure -h.

Een configuratieprofiel maken

Een configuratieprofiel is een verzameling instellingen die verificatiegegevens bevatten, zoals een URL van een Azure Databricks-werkruimte en een waarde voor het toegangstoken. Een configuratieprofiel heeft een programmatische naam, zoals DEFAULT, DEVof PROD.

Als u een configuratieprofiel wilt maken, voert u de configure opdracht als volgt uit:

databricks configure --host <workspace-url>

<workspace-url>Voer uw URL per werkruimte in, met de indelinghttps://adb-<workspace-id>.<random-number>.azuredatabricks.net. Zie URL per werkruimteals u de URL per werkruimte wilt get.

Met de opdracht wordt u gevraagd uw persoonlijke toegangstoken van Azure Databricks of het Microsoft Entra ID-token<workspace-url>

✔ Databricks Token:

Nadat u uw toegangstoken hebt ingevoerd, wordt uw toegangstoken standaard opgeslagen in het bestand ~/.databrickscfg in Linux of macOS of %USERPROFILE%\.databrickscfg in Windows. Het bestand bevat een standaardverbindingsprofielvermelding met de naam DEFAULT:

[DEFAULT]
host  = <workspace-url>
token = <access-token>

Als u een andere naam wilt gebruiken voor uw verbindingsprofiel in plaats van DEFAULT, voegt u de --profile optie toe aan de configure opdracht, bijvoorbeeld:

databricks configure --host <workspace-url> --profile <profile-name>

Tip

U kunt na --profile of -p op Tab drukken om een list van bestaande beschikbare configuratieprofielen weer te geven waaruit u kunt kiezen, in plaats van de naam van het configuratieprofiel handmatig in te voeren.

Alle bestaande host- en tokengegevens in het opgegeven verbindingsprofiel worden overschreven met de nieuwe host- en tokengegevens.

Door meerdere verbindingsprofielen aan het .databrickscfg bestand toe te voegen, kunt u snel opdrachten uitvoeren in verschillende werkruimten door de naam van het doelverbindingsprofiel op te geven in de optie van --profile de opdracht. Als u de --profile optie niet opgeeft in een opdracht die deze optie ondersteunt, gebruikt de opdracht standaard het DEFAULT verbindingsprofiel.

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

U kunt het standaardpad van dit .databrickscfg bestand wijzigen door de omgevingsvariabele DATABRICKS_CONFIG_FILEin te stellen. Zie de documentatie van uw besturingssysteem voor meer informatie over het set van omgevingsvariabelen.

Als u informatie over bestaande configuratieprofielen wilt get, gebruikt u de verificatieopdrachtgroep.