存放庫 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 資料夾會執行提取作業，以更新至該分支的最新認可。 如果 --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。

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