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 -v
om 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:
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_FILE
in 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