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
. Le providers 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"
}
List tutti i repository disponibili nello spazio 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 precedentemente, per ottenere get 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"
}
]
}
List 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 effettuare l'operazione get sull'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 get 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"
}
Update 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
identificano il commit da update o il nuovo ramo da esaminare. Se --branch
o --tag
si riferisce al ramo attualmente controllato, le cartelle Git di Databricks eseguono un'operazione di pull su update per ottenere il commit più recente per quel 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 get 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 get 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 get 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 get il percorso, eseguire il comando get o list. È richiesto--repo-id
o--path
.
In caso di esito positivo, non viene visualizzato alcun output.