Partilhar via

Repos CLI (legado)

  • Artigo

Importante

Esta documentação foi desativada e pode não ser atualizada.

Essas informações se aplicam às versões herdadas da CLI do Databricks 0.18 e inferiores. O Databricks recomenda que você use a CLI mais recente do Databricks versão 0.205 ou superior. Consulte O que é a CLI do Databricks?. Para encontrar sua versão da CLI do Databricks, execute databricks -v.

Para migrar da CLI do Databricks versão 0.18 ou inferior para a CLI do Databricks versão 0.205 ou superior, consulte Migração da CLI do Databricks.

Nota

A CLI do Repos requer a CLI do Databricks 0.15.0 ou superior.

Você executa os subcomandos da CLI do Databricks repos anexando-os ao databricks repos. Esses subcomandos chamam a API Repos.

Para obter mais informações sobre repositórios, consulte Integração do Git para pastas Git do 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.

Criar um repositório

Para exibir a documentação de uso, execute databricks repos create --help.

Utilização

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

Substituir:

  • <url> com o URL do provedor Git necessário para o repositório.

  • <provider> com o nome do provedor Git necessário, por exemplo gitHub. Os fornecedores disponíveis incluem:

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

    O nome do provedor pode ser especificado como insensível a maiúsculas e minúsculas (por exemplo, gitHub e github ambos são válidos).

  • <path> com um caminho opcional para o repositório no espaço de trabalho do Azure Databricks, por exemplo /Repos/someone@example.com/my-repo.

Exemplo de saída

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

Listar todos os repositórios disponíveis no espaço de trabalho

Para exibir a documentação de uso, execute databricks repos list --help.

Utilização

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

Substituir:

  • <path-prefix> com um prefixo de caminho opcional para os repositórios no espaço de trabalho do Azure Databricks, por exemplo /Repos/someone@example.com/my-repo.
  • <next-page-token> com um token de próxima página opcional fornecido executando o comando anteriormente, para obter a próxima página de resultados.

Exemplo de saída

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

Listar informações sobre um repositório

Para exibir a documentação de uso, execute databricks repos get --help.

Utilização

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

Substituir:

  • <repo-id> com o ID do repo, por exemplo 1234567890123456. Para obter a ID, execute o comando list . --repo-id ou --path é obrigatório.
  • <path> com o caminho para o repositório no espaço de trabalho do Azure Databricks, por exemplo /Repos/someone@example.com/my-repo. Para obter o caminho, execute o comando get ou list . --repo-id ou --path é obrigatório.

Exemplo de saída

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

Atualizar um repositório para a confirmação mais recente de uma ramificação remota ou para uma tag

Para exibir a documentação de uso, execute databricks repos update --help.

Utilização

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

Ou:

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

Ou:

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

Ou:

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

Exatamente um de --repo-id ou --path é necessário, e exatamente um de --branch ou --tag é necessário.

--repo-id ou --path identifica a pasta Databricks Git que deve ser atualizada. --branch ou --tag identifica a confirmação para atualizar ou a nova ramificação para fazer check-out. Se --branch ou --tag se referir à ramificação com check-out no momento, as pastas Git do Databricks executarão uma operação pull para atualizar para a confirmação mais recente dessa ramificação. Se --branch ou --tag se referir a uma ramificação sem check-out no momento, as pastas do Databricks Git farão check-out da ramificação especificada.

Substituir:

  • <repo-id> com o ID do repo, por exemplo 1234567890123456. Para obter a ID, execute o comando list .
  • <path> com o caminho para o repositório no espaço de trabalho do Azure Databricks, por exemplo /Repos/someone@example.com/my-repo. Para obter o caminho, execute o comando get ou list .
  • <branch> com o nome da ramificação no repositório a ser usado, por exemplo my-branch.
  • <tag> com o nome da ramificação no repositório a ser usado, por exemplo my-tag.

Exemplo de saída

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

Excluir um repositório

Para exibir a documentação de uso, execute databricks repos delete --help.

Utilização

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

Ou:

databricks repos delete --path <path>

Substituir:

  • <repo-id> com o ID do repo, por exemplo 1234567890123456. Para obter a ID, execute o comando list . --repo-id ou --path é obrigatório.
  • <path> com o caminho para o repositório no espaço de trabalho do Azure Databricks, por exemplo /Repos/someone@example.com/my-repo. Para obter o caminho, execute o comando get ou list . --repo-id ou --path é obrigatório.

Se for bem-sucedida, nenhuma saída será exibida.