Condividi tramite


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 esempio gitHub. 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 e github 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 esempio 1234567890123456. 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 esempio 1234567890123456. 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 esempio my-branch.
  • <tag> con il nome del ramo nel repository da usare, ad esempio my-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 esempio 1234567890123456. 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.