Freigeben über

Repos CLI (Legacy)

  • Artikel

Wichtig

Diese Dokumentation wurde eingestellt und wird unter Umständen nicht aktualisiert.

Diese Informationen gelten für ältere Versionen der Databricks-Befehlszeilenschnittstelle (0.18 und niedriger). Databricks empfiehlt, stattdessen die neuere Databricks-CLI Version 0.205 oder höher zu verwenden. Weitere Informationen finden Sie unter Was ist die Databricks-CLI?. Führen Sie databricks -v aus, um die Version Ihrer Databricks CLI zu ermitteln.

Informationen zum Migrieren der Databricks CLI-Version 0.18 oder niedriger zur Databricks CLI-Version 0.205 oder höher finden Sie unter Databricks CLI-Migration.

Hinweis

Die Repository-CLI erfordert Databricks CLI 0.15.0 oder höher.

Sie führen Unterbefehle über die CLI für Databricks-Repositorys aus, indem Sie sie an databricks repos anfügen. Diese Unterbefehle rufen die Repository-API auf.

Weitere Informationen zu Repos finden Sie unter Git-Integration mit Databricks Git-Ordnern.

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.

Erstellen eines Repositorys

Führen Sie databricks repos create --help aus, um die Syntaxdokumentation anzuzeigen.

Verwendung

databricks repos create --url <url> --provider <provider> --path <path>

Ersetzen Sie:

  • <url> durch die URL des erforderlichen Git-Anbieters zum Repository.

  • <provider> durch den Namen des erforderlichen Git-Anbieters, z. B. gitHub. Zu den verfügbaren Anbietern gehören:

    • azureDevOpsServices
    • bitbucketCloud
    • bitbucketServer
    • gitHub
    • gitHubEnterprise
    • gitLab
    • gitLabEnterpriseEdition

    Der Name des Anbieters kann ohne Berücksichtigung der Groß-/Kleinschreibung angegeben werden (z. B. ist sowohl gitHub als auch github gültig).

  • <path> durch einen optionalen Pfad zum Repository im Azure Databricks-Arbeitsbereich, z. B. /Repos/someone@example.com/my-repo.

Beispielausgabe

{
  "id": 1234567890123456,
  "path": "/Repos/someone@example.com/my-repo",
  "url": "https://github.com/my/my-repo",
  "provider": "gitHub",
  "branch": "master",
  "head_commit_id": "9837ac1f924a5ca56117597c5c79bb02300ff1f4"
}

Auflisten aller verfügbaren Repositorys im Arbeitsbereich

Führen Sie databricks repos list --help aus, um die Syntaxdokumentation anzuzeigen.

Verwendung

databricks repos list --path-prefix <path-prefix> --next-page-token <next-page-token>

Ersetzen Sie:

  • <path-prefix> durch ein optionales Pfadpräfix zu den Repositorys im Azure Databricks-Arbeitsbereich, z. B. /Repos/someone@example.com/my-repo.
  • <next-page-token> durch ein optionales Token für die nächste Seite, das durch vorheriges Ausführen des Befehls bereitgestellt wurde, um die nächste Seite mit Ergebnissen abzurufen.

Beispielausgabe

{
  "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"
    }
  ]
}

Auflisten von Informationen zu einem Repository

Führen Sie databricks repos get --help aus, um die Syntaxdokumentation anzuzeigen.

Verwendung

databricks repos get --repo-id <repo-id> --path <path>

Ersetzen Sie:

  • <repo-id> durch die ID des Repositorys, z. B. 1234567890123456. Führen Sie den Befehl list aus, um die ID abzurufen. --repo-id oder --path Ist erforderlich.
  • <path> durch den Pfad zum Repository im Azure Databricks-Arbeitsbereich, z. B. /Repos/someone@example.com/my-repo. Führen Sie zum Abrufen des Pfads den Befehl get oder list aus. --repo-id oder --path Ist erforderlich.

Beispielausgabe

{
  "id": 1234567890123456,
  "path": "/Repos/someone@example.com/my-repo",
  "url": "https://github.com/my/my-repo",
  "provider": "gitHub",
  "branch": "master",
  "head_commit_id": "9837ac1f924a5ca56117597c5c79bb02300ff1f4"
}

Aktualisieren eines Repositorys auf den letzten Commit eines Remotebranchs oder auf ein Tag

Führen Sie databricks repos update --help aus, um die Syntaxdokumentation anzuzeigen.

Verwendung

databricks repos update --repo-id <repo-id> --branch <branch>

Oder:

databricks repos update --repo-id <repo-id> --tag <tag>

Oder:

databricks repos update --path <path> --branch <branch>

Oder:

databricks repos update --path <path> --tag <tag>

Genau eine Angabe von --repo-id oder --path ist erforderlich, und genau eine Angabe von --branch oder --tag ist erforderlich.

--repo-id oder --path identifiziert den Databricks-Git-Ordner, der aktualisiert werden soll. --branch oder --tag gibt den Commit für die Aktualisierung an oder die neue Verzweigung an, die ausgecheckt werden soll. Wenn --branch oder --tag auf die Verzweigung verweist, die aktuell ausgecheckt ist, führt Databricks Git-Ordner einen Pullvorgang aus, um den neuesten Commit für diese Verzweigung zu aktualisieren. Wenn --branch oder --tag auf einen Branch verweist, der derzeit nicht ausgecheckt ist, checkt Databricks Git-Ordner den angegebenen Branch aus.

Ersetzen Sie:

  • <repo-id> durch die ID des Repositorys, z. B. 1234567890123456. Führen Sie den Befehl list aus, um die ID abzurufen.
  • <path> durch den Pfad zum Repository im Azure Databricks-Arbeitsbereich, z. B. /Repos/someone@example.com/my-repo. Führen Sie zum Abrufen des Pfads den Befehl get oder list aus.
  • <branch> durch den Namen des zu verwendende Branchs im Repository, z. B. my-branch.
  • <tag> durch den Namen des zu verwendende Branchs im Repository, z. B. my-tag.

Beispielausgabe

{
  "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"
}

Löschen eines Repositorys

Führen Sie databricks repos delete --help aus, um die Syntaxdokumentation anzuzeigen.

Verwendung

databricks repos delete --repo-id <repo-id>

Oder:

databricks repos delete --path <path>

Ersetzen Sie:

  • <repo-id> durch die ID des Repositorys, z. B. 1234567890123456. Führen Sie den Befehl list aus, um die ID abzurufen. --repo-id oder --path Ist erforderlich.
  • <path> durch den Pfad zum Repository im Azure Databricks-Arbeitsbereich, z. B. /Repos/someone@example.com/my-repo. Führen Sie zum Abrufen des Pfads den Befehl get oder list aus. --repo-id oder --path Ist erforderlich.

Bei Erfolg wird keine Ausgabe angezeigt.