Configuratieprofielen voor de Databricks CLI

Notitie

Deze informatie is van toepassing op Databricks CLI-versies 0.205 en hoger, die zich in openbare preview bevinden. Voer de opdracht uit databricks -vom uw versie van de Databricks CLI te vinden.

In dit artikel wordt beschreven hoe u verificatie instelt tussen de Databricks CLI en uw Azure Databricks-accounts en -werkruimten. Zie Wat is de Databricks CLI?

In dit artikel wordt ervan uitgegaan dat u de Databricks CLI al hebt geïnstalleerd en de CLI hebt ingesteld voor verificatie. Zie:

• De Databricks CLI installeren of bijwerken
• Verificatie voor de Databricks CLI

Informatie over configuratieprofielen ophalen

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 opdracht of -p optie, voor deze opdrachten die deze optie ondersteunen. Als u de --profile of -p optie niet opgeeft in een opdracht die deze optie ondersteunt, gebruikt de opdracht standaard het DEFAULT configuratieprofiel.

Fooi

U kunt erna --profile drukken Tab of -p een lijst weergeven met bestaande beschikbare configuratieprofielen waaruit u kunt kiezen, in plaats van de naam van het configuratieprofiel handmatig in te voeren.

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. U kunt het standaardpad van het .databrickscfg bestand wijzigen door de omgevingsvariabele DATABRICKS_CONFIG_FILEin te stellen. Zie de documentatie van uw besturingssysteem voor meer informatie over het instellen van omgevingsvariabelen.

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

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": "<configuration-profile-name>",
    "DATABRICKS_HOST": "<workspace-url>",
    "DATABRICKS_TOKEN": "<token-value>"
  }
}

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

databricks auth profiles

Uitvoer (de weglatingstekens vertegenwoordigen weggelaten inhoud, voor beknoptheid):

{
  "profiles": [
    {
      "name": "<configuration-profile-name>",
      "host": "<workspace-url>",
      "cloud": "<cloud-id>",
      "auth_type": "<auth-type>",
      "valid": true
    },
    {
      "...": "..."
    }
  ]
}

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.

De configuratie van uw STANDAARDconfiguratieprofiel testen

Als u wilt controleren of verificatie correct is ingesteld, kunt u een opdracht uitvoeren, zoals de volgende, waarin de beschikbare Databricks Runtime-versies voor de Azure Databricks-werkruimte worden vermeld die aan uw DEFAULT profiel is gekoppeld.

Bij de volgende aanroep wordt ervan uitgegaan dat u geen speciale omgevingsvariabelen hebt ingesteld, die voorrang hebben op de instellingen in uw DEFAULT profiel. Zie Verificatievolgorde van evaluatie voor meer informatie.

databricks clusters spark-versions

Uw configuratieprofielen testen

Als u wilt controleren of u configuratieprofielen correct hebt ingesteld, kunt u een opdracht uitvoeren, zoals het volgende met een van uw configuratieprofielnamen op werkruimteniveau. Met deze opdracht worden de beschikbare Databricks Runtime-versies weergegeven voor de Azure Databricks-werkruimte die is gekoppeld aan het opgegeven configuratieprofiel, dat hier wordt weergegeven door de tijdelijke aanduiding <configuration-profile-name>:

databricks clusters spark-versions -p <configuration-profile-name>

Fooi

U kunt erna --profile drukken Tab of -p een lijst weergeven met bestaande beschikbare configuratieprofielen waaruit u kunt kiezen, in plaats van de naam van het configuratieprofiel handmatig in te voeren.

Voer de volgende opdracht uit om details voor een specifiek profiel weer te geven:

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

Voer de volgende opdracht uit om details voor al uw beschikbare profielen weer te geven:

databricks auth profiles