CLI di Repos (legacy)
Importante
Questa documentazione è stata ritirata e potrebbe non essere aggiornata.
Queste informazioni si applicano all'interfaccia della riga di comando di Databricks 0.18 e precedenti. Databricks consiglia di usare invece la versione 0.205 o successiva dell'interfaccia della riga di comando. Consultare Che cos'è il Databricks CLI?. Per trovare la versione del Databricks CLI, eseguire databricks -v
.
Per eseguire la migrazione dalla CLI di Databricks versione 0.18 o precedente alla CLI di Databricks versione 0.205 o successiva, vedere Migrazione della CLI di Databricks.
Nota
L'interfaccia della riga di comando di Repos richiede l'interfaccia della riga di comando di Databricks 0.15.0 o versione successiva.
I sottocomandi dell'interfaccia della riga di comando di Databricks vengono eseguiti aggiungendoli a databricks repos
. Questi sottocomandi chiamano l'API Repos.
Per altre informazioni sui repository, vedere Integrazione git per le cartelle Git di Databricks.
databricks repos --help
Usage: databricks repos [OPTIONS] COMMAND [ARGS]...
Utility to interact with the repos API.
Options:
-v, --version [VERSION]
--debug Debug mode. Shows full stack trace on error.
--profile TEXT CLI connection profile to use. The default profile is
"DEFAULT".
-h, --help Show this message and exit.
Commands:
create Creates a repo.
delete Deletes a repo.
get Lists information about a repo.
list Lists all available repos in the workspace.
update Updates information about a repo.
Creare un repository
Per visualizzare la documentazione sull'utilizzo, eseguire databricks repos create --help
.
Utilizzo
databricks repos create --url <url> --provider <provider> --path <path>
Sostituire:
<url>
con l'URL del provider Git richiesto per il repository.<provider>
con il nome del provider Git richiesto, ad esempiogitHub
. I provider disponibili includono:azureDevOpsServices
bitbucketCloud
bitbucketServer
gitHub
gitHubEnterprise
gitLab
gitLabEnterpriseEdition
Il nome del provider può essere specificato come senza distinzione tra maiuscole e minuscole,ad
gitHub
esempio egithub
sono entrambi validi.<path>
con un percorso facoltativo del repository nell'area di lavoro di Azure Databricks, ad esempio/Repos/someone@example.com/my-repo
.
Output di esempio
{
"id": 1234567890123456,
"path": "/Repos/someone@example.com/my-repo",
"url": "https://github.com/my/my-repo",
"provider": "gitHub",
"branch": "master",
"head_commit_id": "9837ac1f924a5ca56117597c5c79bb02300ff1f4"
}
Elencare tutti i repository disponibili nell'area di lavoro
Per visualizzare la documentazione sull'utilizzo, eseguire databricks repos list --help
.
Utilizzo
databricks repos list --path-prefix <path-prefix> --next-page-token <next-page-token>
Sostituire:
<path-prefix>
con un prefisso di percorso facoltativo ai repository nell'area di lavoro di Azure Databricks, ad esempio/Repos/someone@example.com/my-repo
.<next-page-token>
con un token di pagina successivo facoltativo fornito eseguendo il comando in precedenza, per ottenere la pagina successiva dei risultati.
Output di esempio
{
"repos": [
{
"id": 1234567890123456,
"path": "/Repos/someone@example.com/my-repo",
"url": "https://github.com/my/my-repo",
"provider": "gitHub",
"branch": "master",
"head_commit_id": "9837ac1f924a5ca56117597c5c79bb02300ff1f4"
},
{
"id": 2345678901234567,
"path": "/Repos/someone@example.com/my-repo-2",
"url": "https://github.com/my/my-repo-2",
"provider": "gitHub",
"branch": "master",
"head_commit_id": "837ac1f924a5ca56117597c5c79bb02300ff1f4a"
}
]
}
Elencare le informazioni su un repository
Per visualizzare la documentazione sull'utilizzo, eseguire databricks repos get --help
.
Utilizzo
databricks repos get --repo-id <repo-id> --path <path>
Sostituire:
<repo-id>
con l'ID del repository, ad esempio1234567890123456
. Per ottenere l'ID, eseguire il comando list . È richiesto--repo-id
o--path
.<path>
con il percorso del repository nell'area di lavoro di Azure Databricks, ad esempio/Repos/someone@example.com/my-repo
. Per ottenere il percorso, eseguire il comando get o list . È richiesto--repo-id
o--path
.
Output di esempio
{
"id": 1234567890123456,
"path": "/Repos/someone@example.com/my-repo",
"url": "https://github.com/my/my-repo",
"provider": "gitHub",
"branch": "master",
"head_commit_id": "9837ac1f924a5ca56117597c5c79bb02300ff1f4"
}
Aggiornare un repository al commit più recente di un ramo remoto o a un tag
Per visualizzare la documentazione sull'utilizzo, eseguire databricks repos update --help
.
Utilizzo
databricks repos update --repo-id <repo-id> --branch <branch>
Oppure:
databricks repos update --repo-id <repo-id> --tag <tag>
Oppure:
databricks repos update --path <path> --branch <branch>
Oppure:
databricks repos update --path <path> --tag <tag>
È necessario esattamente uno di --repo-id
o --path
ed è necessario esattamente uno di --branch
o --tag
.
--repo-id
o --path
identifica la cartella Git di Databricks che deve essere aggiornata. --branch
o --tag
identifica il commit per eseguire l'aggiornamento a o il nuovo ramo da archiviare. Se --branch
o --tag
fa riferimento al ramo attualmente estratto, le cartelle Git di Databricks eseguono un'operazione pull per eseguire l'aggiornamento al commit più recente per tale ramo. Se --branch
o --tag
fa riferimento a un ramo non estratto, le cartelle Git di Databricks estrae il ramo specificato.
Sostituire:
<repo-id>
con l'ID del repository, ad esempio1234567890123456
. Per ottenere l'ID, eseguire il comando list .<path>
con il percorso del repository nell'area di lavoro di Azure Databricks, ad esempio/Repos/someone@example.com/my-repo
. Per ottenere il percorso, eseguire il comando get o list .<branch>
con il nome del ramo nel repository da usare, ad esempiomy-branch
.<tag>
con il nome del ramo nel repository da usare, ad esempiomy-tag
.
Output di esempio
{
"id": 1234567890123456,
"path": "/Repos/someone@example.com/my-repo",
"url": "https://github.com/my/my-repo",
"provider": "gitHub",
"branch": "my-branch",
"head_commit_id": "9837ac1f924a5ca56117597c5c79bb02300ff1f4"
}
Eliminare un repository
Per visualizzare la documentazione sull'utilizzo, eseguire databricks repos delete --help
.
Utilizzo
databricks repos delete --repo-id <repo-id>
Oppure:
databricks repos delete --path <path>
Sostituire:
<repo-id>
con l'ID del repository, ad esempio1234567890123456
. Per ottenere l'ID, eseguire il comando list . È richiesto--repo-id
o--path
.<path>
con il percorso del repository nell'area di lavoro di Azure Databricks, ad esempio/Repos/someone@example.com/my-repo
. Per ottenere il percorso, eseguire il comando get o list . È richiesto--repo-id
o--path
.
In caso di esito positivo, non viene visualizzato alcun output.