Condividi tramite

Interfaccia della riga di comando di Repos (legacy)

  • Articolo

Importante

Questa documentazione è stata ritirata e potrebbe non essere aggiornata.

Queste informazioni si applicano alle versioni legacy dell'interfaccia della riga di comando di Databricks 0.18 e successive. Databricks consiglia di usare invece la versione 0.205 o successiva dell'interfaccia della riga di comando di Databricks più recente. Vedere Che cos'è l'interfaccia della riga di comando di Databricks?. Per trovare la versione dell'interfaccia della riga di comando di Databricks, eseguire databricks -v.

Per eseguire la migrazione dall'interfaccia della riga di comando di Databricks versione 0.18 o successiva all'interfaccia della riga di comando di Databricks versione 0.205 o successiva, vedere Migrazione dell'interfaccia della riga di comando 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>

Replace:

  • <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>

Replace:

  • <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>

Replace:

  • <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.

Replace:

  • <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>

Replace:

  • <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.