Поделиться через

Repos CLI (устаревшая версия)

  • Статья

Внимание

Поддержка этой документации прекращена, она может больше не обновляться.

Эта информация относится к устаревшим интерфейсам командной строки Databricks версии 0.18 и ниже. Databricks рекомендует использовать более новую версию Интерфейса командной строки Databricks версии 0.205 или более поздней. См. сведения о интерфейсе командной строки Databricks?. Чтобы найти версию интерфейса командной строки Databricks, выполните команду databricks -v.

Сведения о миграции из Databricks CLI версии 0.18 или ниже в Databricks CLI версии 0.205 или более поздней, см. в статье Databricks CLI.

Примечание.

Для работы с CLI Repos требуется Databricks CLI 0.15.0 или более поздней версии.

Чтобы запустить подкоманды CLI Repos Databricks, добавьте их в databricks repos. Эти вложенные команды вызывают API Repos.

Дополнительные сведения об репозиториях см. в разделе интеграции Git с папками 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.

Создание репозитория

Чтобы просмотреть документацию по использованию, выполните команду databricks repos create --help.

Использование

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

Замена:

  • <url> с требуемым URL-адресом поставщика Git в репозитории.

  • <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.

В случае успеха отчет о выполнении команды не отображается.