Udostępnij za pośrednictwem


Interfejs wiersza polecenia repozytoriów (starsza wersja)

Ważne

Ta dokumentacja została wycofana i może nie zostać zaktualizowana.

Te informacje dotyczą starszych wersji interfejsu wiersza polecenia usługi Databricks w wersji 0.18 i poniżej. Usługa Databricks zaleca użycie nowszego interfejsu wiersza polecenia usługi Databricks w wersji 0.205 lub nowszej. Zobacz Co to jest interfejs wiersza polecenia usługi Databricks?. Aby znaleźć swoją wersję interfejsu wiersza polecenia usługi Databricks, uruchom polecenie databricks -v.

Aby przeprowadzić migrację z interfejsu wiersza polecenia usługi Databricks w wersji 0.18 lub nowszej do interfejsu wiersza polecenia usługi Databricks w wersji 0.205 lub nowszej, zobacz Migracja interfejsu wiersza polecenia usługi Databricks.

Uwaga

Interfejs wiersza polecenia repozytoriów wymaga interfejsu wiersza polecenia usługi Databricks w wersji 0.15.0 lub nowszej.

Uruchamiasz polecenia interfejsu wiersza polecenia repozytoriów usługi Databricks, dołączając je do databricks repospolecenia . Te podpolecenia wywołają interfejs API repozytoriów.

Aby uzyskać więcej informacji na temat repozytoriów, zobacz Integracja usługi Git dla folderów Git usługi 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.

Tworzenie repozytorium

Aby wyświetlić dokumentację użycia, uruchom polecenie databricks repos create --help.

Użycie

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

Wymiana:

  • <url> z wymaganym adresem URL dostawcy git do repozytorium.

  • <provider> z wymaganą nazwą dostawcy Git, na przykład gitHub. Dostępni są między innymi następujący dostawcy:

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

    Nazwę dostawcy można określić jako bez uwzględniania wielkości liter (na przykład gitHub i github są one prawidłowe).

  • <path> z opcjonalną ścieżką do repozytorium w obszarze roboczym usługi Azure Databricks, na przykład /Repos/someone@example.com/my-repo.

Przykładowe dane wyjściowe

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

Wyświetlanie listy wszystkich dostępnych repozytoriów w obszarze roboczym

Aby wyświetlić dokumentację użycia, uruchom polecenie databricks repos list --help.

Użycie

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

Wymiana:

  • <path-prefix> z opcjonalnym prefiksem ścieżki do repozytoriów w obszarze roboczym usługi Azure Databricks, na przykład /Repos/someone@example.com/my-repo.
  • <next-page-token> przy użyciu opcjonalnego tokenu następnej strony dostarczonego wcześniej przez uruchomienie polecenia, aby uzyskać następną stronę wyników.

Przykładowe dane wyjściowe

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

Wyświetlanie listy informacji o repozytorium

Aby wyświetlić dokumentację użycia, uruchom polecenie databricks repos get --help.

Użycie

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

Wymiana:

  • <repo-id> z identyfikatorem repozytorium, na przykład 1234567890123456. Aby uzyskać identyfikator, uruchom polecenie listy . --repo-id lub --path jest wymagany.
  • <path> ze ścieżką do repozytorium w obszarze roboczym usługi Azure Databricks, na przykład /Repos/someone@example.com/my-repo. Aby uzyskać ścieżkę, uruchom polecenie get lub list . --repo-id lub --path jest wymagany.

Przykładowe dane wyjściowe

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

Aktualizowanie repozytorium do najnowszego zatwierdzenia gałęzi zdalnej lub tagu

Aby wyświetlić dokumentację użycia, uruchom polecenie databricks repos update --help.

Użycie

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

Lub:

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

Lub:

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

Lub:

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

Dokładnie jeden z --repo-id lub --path jest wymagany i dokładnie jeden z --branch lub --tag jest wymagany.

--repo-id lub --path identyfikuje folder Git usługi Databricks, który ma zostać zaktualizowany. --branch lub --tag identyfikuje zatwierdzenie aktualizacji do lub nowej gałęzi do wyewidencjonowania. Jeśli --branch lub --tag odwołuje się do gałęzi, która jest obecnie wyewidencjonowana, foldery Git usługi Databricks wykonują operację ściągania w celu zaktualizowania do najnowszego zatwierdzenia dla tej gałęzi. --tag Jeśli --branch lub odwołuje się do gałęzi, która nie jest obecnie wyewidencjonowana, foldery Git usługi Databricks sprawdzają określoną gałąź.

Wymiana:

  • <repo-id> z identyfikatorem repozytorium, na przykład 1234567890123456. Aby uzyskać identyfikator, uruchom polecenie listy .
  • <path> ze ścieżką do repozytorium w obszarze roboczym usługi Azure Databricks, na przykład /Repos/someone@example.com/my-repo. Aby uzyskać ścieżkę, uruchom polecenie get lub list .
  • <branch> z nazwą gałęzi w repozytorium do użycia, na przykład my-branch.
  • <tag> z nazwą gałęzi w repozytorium do użycia, na przykład my-tag.

Przykładowe dane wyjściowe

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

Usuwanie repozytorium

Aby wyświetlić dokumentację użycia, uruchom polecenie databricks repos delete --help.

Użycie

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

Lub:

databricks repos delete --path <path>

Wymiana:

  • <repo-id> z identyfikatorem repozytorium, na przykład 1234567890123456. Aby uzyskać identyfikator, uruchom polecenie listy . --repo-id lub --path jest wymagany.
  • <path> ze ścieżką do repozytorium w obszarze roboczym usługi Azure Databricks, na przykład /Repos/someone@example.com/my-repo. Aby uzyskać ścieżkę, uruchom polecenie get lub list . --repo-id lub --path jest wymagany.

W przypadku powodzenia żadne dane wyjściowe nie są wyświetlane.