CLI de repositorios (heredada)

  • Artículo

Importante

Esta documentación se ha retirado y es posible que no se actualice.

Esta información se aplica a las versiones heredadas de la CLI de Databricks 0.18 y versiones posteriores. En su lugar, Databricks recomienda usar la versión más reciente 0.205 o posterior de la CLI de Databricks. Consulte ¿Qué es la CLI de Databricks?. Para encontrar su versión de la CLI de Databricks, ejecute databricks -v.

Para migrar de la versión 0.18 o inferior a la versión 0.205 o superior de la CLI de Databricks, vea Migración de la CLI de Databricks.

Nota:

La CLI de Repos requiere la CLI de Databricks 0.15.0 o posterior.

Para ejecutar subcomandos de la CLI de Repos de Databricks, anéxelos a databricks repos. Estos subcomandos llaman a la API de repositorios.

Para más información sobre los repositorios, vea integración de Git con carpetas de Git de 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.

Creación de un repositorio

Para mostrar la documentación de uso, ejecute databricks repos create --help.

Uso

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

Sustituya:

  • <url> por la dirección URL al repositorio del proveedor de Git necesaria.

  • <provider> por el nombre del proveedor de Git necesario, por ejemplo gitHub. Entre los proveedores disponibles se incluyen:

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

    El nombre del proveedor se puede especificar sin distinción de mayúsculas de minúsculas (por ejemplo, tanto gitHub como github son válidos).

  • <path> con una ruta de acceso opcional al repositorio en el área de trabajo de Azure Databricks, por ejemplo /Repos/someone@example.com/my-repo.

Salida de ejemplo

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

Enumeración de todos los repositorios disponibles en el área de trabajo

Para mostrar la documentación de uso, ejecute databricks repos list --help.

Uso

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

Sustituya:

  • <path-prefix> por un prefijo de ruta de acceso opcional a los repositorios en el área de trabajo de Azure Databricks, por ejemplo /Repos/someone@example.com/my-repo.
  • <next-page-token> por un token de página siguiente opcional proporcionado al ejecutar el comando anteriormente, para obtener la siguiente página de resultados.

Salida de ejemplo

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

Enumerar la información de un repositorio

Para mostrar la documentación de uso, ejecute databricks repos get --help.

Uso

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

Sustituya:

  • <repo-id> por el identificador del repositorio, por ejemplo 1234567890123456. Para obtener el identificador, ejecute el comando list. --repo-id o --path es obligatorio.
  • <path> por la ruta de acceso al repositorio en el área de trabajo de Azure Databricks, por ejemplo /Repos/someone@example.com/my-repo. Para obtener la ruta de acceso, ejecute el comando get o list. --repo-id o --path es obligatorio.

Salida de ejemplo

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

Actualización de un repositorio a la confirmación más reciente de una rama remota o a una etiqueta

Para mostrar la documentación de uso, ejecute databricks repos update --help.

Uso

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

O:

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

O:

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

O:

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

Se requiere exactamente --repo-id o --path, y se requiere exactamente --branch o --tag.

--repo-id o --path identifica la carpeta Git de Databricks que se debe actualizar. --branch o --tag identifica la confirmación para actualizar a o la nueva rama para desproteger. Si --branch o --tag hace referencia a la rama que está desprotegida actualmente, las carpetas de Git de Databricks realizan una operación de extracción para actualizar a la confirmación más reciente de esa rama. Si --branch o --tag hace referencia a una rama que no está desprotegida actualmente, las carpetas de Git de Databricks desprotegió la rama especificada.

Sustituya:

  • <repo-id> por el identificador del repositorio, por ejemplo 1234567890123456. Para obtener el identificador, ejecute el comando list.
  • <path> por la ruta de acceso al repositorio en el área de trabajo de Azure Databricks, por ejemplo /Repos/someone@example.com/my-repo. Para obtener la ruta de acceso, ejecute el comando get o list.
  • <branch> por el nombre de la rama en el repositorio que se va a usar, por ejemplo my-branch.
  • <tag> por el nombre de la rama en el repositorio que se va a usar, por ejemplo my-tag.

Salida de ejemplo

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

Eliminación de un repositorio

Para mostrar la documentación de uso, ejecute databricks repos delete --help.

Uso

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

O:

databricks repos delete --path <path>

Sustituya:

  • <repo-id> por el identificador del repositorio, por ejemplo 1234567890123456. Para obtener el identificador, ejecute el comando list. --repo-id o --path es obligatorio.
  • <path> por la ruta de acceso al repositorio en el área de trabajo de Azure Databricks, por ejemplo /Repos/someone@example.com/my-repo. Para obtener la ruta de acceso, ejecute el comando get o list. --repo-id o --path es obligatorio.

Si se ejecuta correctamente, no se muestra ninguna salida.