共用方式為

存放庫 CLI (舊版)

重要

此文件已淘汰，且可能未更新。

此資訊適用於舊版 Databricks CLI 0.18 版和更早版本。 Databricks 建議您改用較新的 Databricks CLI 0.205 版或更新版本。 請參閱什麼是 Databricks CLI？。 若要尋找 Databricks CLI 版本，請執行 databricks -v。

若要從 Databricks CLI 0.18 版或更低版本移轉至 Databricks CLI 0.205 版或更新版本，請參閱 Databricks CLI 移轉。

注意

Repos CLI 需要 Databricks CLI 0.15.0 或更新版本。

您可以通過將 Databricks repos CLI 子命令附加到 databricks repos 來執行它們。 這些子命令會呼叫 Repos API。

如需存放庫的詳細資訊，請參閱 Databricks Git 資料夾的 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.

建立存放庫

若要顯示使用方式文件，請執行 databricks repos create --help。

使用方式

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

替換：

  • <url> 使用所需 Git 提供者的 URL 來指向存放庫。

  • <provider> 具有所需的 Git 提供者名稱，例如 gitHub。 可用的提供者包括：

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

    提供者的名稱可以指定為不區分大小寫（例如， gitHub 和 github 都是有效的）。

  • <path> 具有 Azure Databricks 工作區中存放庫的選擇性路徑，例如 /Repos/someone@example.com/my-repo。

範例輸出

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

列出工作區中的所有可用存放庫

若要顯示使用方式文件，請執行 databricks repos list --help。

使用方式

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

替換：

  • <path-prefix> 在 Azure Databricks 工作區中，具有存放庫的選擇性路徑前置詞，例如 /Repos/someone@example.com/my-repo。
  • <next-page-token> 透過先前執行命令產生的選擇性下一頁標記，來獲取下一頁的結果。

範例輸出

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

列出存放庫的相關信息

若要顯示使用方式文件，請執行 databricks repos get --help。

使用方式

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

替換：

  • <repo-id> 具有存放庫的識別碼，例如 1234567890123456。 若要取得標識碼，請 執行 list 命令。 需要有 --repo-id 或 --path。
  • <path> 具有 Azure Databricks 工作區中存放庫的路徑，例如 /Repos/someone@example.com/my-repo。 若要取得路徑，請 執行 get 或 list 命令。 需要有 --repo-id 或 --path。

範例輸出

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

將版本庫更新為遠端分支的最新提交或標籤

若要顯示使用方式文件，請執行 databricks repos update --help。

使用方式

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

或：

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

或：

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

或：

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

要求恰好需要--repo-id或--path的一個，並且恰好需要--branch或--tag的一個。

--repo-id 或 --path 識別應該更新的 Databricks Git 資料夾。 --branch 或 --tag 用於識別要更新到的認可或要簽出的新分支。如果 --branch 或 --tag 參考的是當前已簽出的分支，則 Databricks Git 資料夾將執行 pull 操作，以將該分支更新至最新的認可。 如果 --branch 或 --tag 參考的分支不是目前核取的分支，Databricks Git 資料夾會核取指定的分支。

替換：

  • <repo-id> 具有存放庫的識別碼，例如 1234567890123456。 若要取得標識碼，請 執行 list 命令。
  • <path> 具有 Azure Databricks 工作區中存放庫的路徑，例如 /Repos/someone@example.com/my-repo。 若要取得路徑，請 執行 get 或 list 命令。
  • <branch> 在存放庫中具有要使用的分支名稱，例如 my-branch。
  • <tag> 在存放庫中具有要使用的分支名稱，例如 my-tag。

範例輸出

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

刪除存放庫

若要顯示使用方式文件，請執行 databricks repos delete --help。

使用方式

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

或：

databricks repos delete --path <path>

替換：

  • <repo-id> 具有存放庫的識別碼，例如 1234567890123456。 若要取得標識碼，請 執行 list 命令。 需要有 --repo-id 或 --path。
  • <path> 具有 Azure Databricks 工作區中存放庫的路徑，例如 /Repos/someone@example.com/my-repo。 若要取得路徑，請 執行 get 或 list 命令。 需要有 --repo-id 或 --path。

如果成功，就不會顯示任何輸出。