Sdílet prostřednictvím

Rozhraní příkazového řádku úložiště (starší verze)

  • Článek

Důležité

Tato dokumentace byla vyřazena a nemusí být aktualizována.

Tyto informace platí pro starší verzi Rozhraní příkazového řádku Databricks verze 0.18 a novější. Databricks doporučuje místo toho použít novější rozhraní příkazového řádku Databricks verze 0.205 nebo vyšší. Podívejte se, co je rozhraní příkazového řádku Databricks? Pokud chcete zjistit svou verzi rozhraní příkazového řádku Databricks, spusťte databricks -vpříkaz .

Pokud chcete migrovat z Rozhraní příkazového řádku Databricks verze 0.18 nebo novější na Databricks CLI verze 0.205 nebo novější, přečtěte si téma Migrace rozhraní příkazového řádku Databricks.

Poznámka:

Rozhraní příkazového řádku Úložiště vyžaduje Databricks CLI 0.15.0 nebo vyšší.

Podpříkazy rozhraní příkazového řádku Databricks spustíte tak, že je připojíte k databricks repos. Tyto dílčí příkazy volají rozhraní API repos.

Další informace o úložištích najdete v tématu Integrace Gitu se složkami Databricks Git.

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.

Vytvoření úložiště

Pokud chcete zobrazit dokumentaci k použití, spusťte databricks repos create --helppříkaz .

Využití

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

Nahrazení:

  • <url> s adresou URL požadovaného poskytovatele Gitu do úložiště.

  • <provider> s požadovaným názvem poskytovatele Gitu, například gitHub. Mezi dostupné poskytovatele patří:

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

    Název poskytovatele je možné zadat jako nerozlišující velká a malá písmena (například gitHub obě github jsou platné).

  • <path> s volitelnou cestou k úložišti v pracovním prostoru Azure Databricks, například /Repos/someone@example.com/my-repo.

Příklad výstupu

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

Výpis všech dostupných úložišť v pracovním prostoru

Pokud chcete zobrazit dokumentaci k použití, spusťte databricks repos list --helppříkaz .

Využití

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

Nahrazení:

  • <path-prefix> s volitelnou předponou cesty k úložišťm v pracovním prostoru Azure Databricks, například /Repos/someone@example.com/my-repo.
  • <next-page-token> s volitelným dalším tokenem stránky, který jste zadali spuštěním předchozího příkazu, získáte další stránku výsledků.

Příklad výstupu

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

Výpis informací o úložišti

Pokud chcete zobrazit dokumentaci k použití, spusťte databricks repos get --helppříkaz .

Využití

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

Nahrazení:

  • <repo-id> s ID úložiště, například 1234567890123456. Id získáte spuštěním příkazu list . --repo-id nebo --path je povinný.
  • <path> s cestou k úložišti v pracovním prostoru Azure Databricks, například /Repos/someone@example.com/my-repo. Pokud chcete získat cestu, spusťte příkaz get nebo list . --repo-id nebo --path je povinný.

Příklad výstupu

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

Aktualizace úložiště na nejnovější potvrzení vzdálené větve nebo na značku

Pokud chcete zobrazit dokumentaci k použití, spusťte databricks repos update --helppříkaz .

Využití

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

Nebo:

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

Nebo:

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

Nebo:

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

Přesně jeden z --repo-id nebo --path je povinný a přesně jeden z --branch nebo --tag je povinný.

--repo-id nebo --path identifikuje složku Git Databricks, která by se měla aktualizovat. --branch nebo --tag identifikuje potvrzení aktualizace na novou větev nebo novou větev, která se má rezervovat. Pokud --branch nebo --tag odkazuje na aktuálně rezervovanou větev, složky Gitu Databricks provádějí operaci vyžádání změn, která aktualizuje na nejnovější potvrzení pro tuto větev. Pokud --branch nebo --tag odkazuje na větev, která není aktuálně rezervovaná, složky Gitu Databricks zkontrolují zadanou větev.

Nahrazení:

  • <repo-id> s ID úložiště, například 1234567890123456. Id získáte spuštěním příkazu list .
  • <path> s cestou k úložišti v pracovním prostoru Azure Databricks, například /Repos/someone@example.com/my-repo. Pokud chcete získat cestu, spusťte příkaz get nebo list .
  • <branch> s názvem větve v úložišti, která se má použít, například my-branch.
  • <tag> s názvem větve v úložišti, která se má použít, například my-tag.

Příklad výstupu

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

Odstranění úložiště

Pokud chcete zobrazit dokumentaci k použití, spusťte databricks repos delete --helppříkaz .

Využití

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

Nebo:

databricks repos delete --path <path>

Nahrazení:

  • <repo-id> s ID úložiště, například 1234567890123456. Id získáte spuštěním příkazu list . --repo-id nebo --path je povinný.
  • <path> s cestou k úložišti v pracovním prostoru Azure Databricks, například /Repos/someone@example.com/my-repo. Pokud chcete získat cestu, spusťte příkaz get nebo list . --repo-id nebo --path je povinný.

V případě úspěchu se nezobrazí žádný výstup.