Azure Repos CLI (ancienne)

  • Article

Important

Cette documentation a été mise hors service et peut ne pas être mise à jour.

Ces informations s’appliquent aux anciennes versions Databricks CLI 0,18 et inférieures. Databricks vous recommande d’utiliser à la place la nouvelle version 0.205 ou supérieure de l’interface CLI Databricks. Consultez Qu’est-ce que l’interface CLI Databricks ?. Pour trouver votre version de l’interface CLI Databricks, exécutez databricks -v.

Pour migrer de Databricks CLI version 0,18 ou inférieure vers Databricks CLI version 0,205 ou supérieure, consultez Migration Databricks CLI.

Remarque

L’interface CLI de référentiel requiert l’interface CLI Databricks 0.15.0 ou une version ultérieure.

Vous exécutez les sous-commandes de l’interface CLI du référentiel Databricks en les ajoutant à databricks repos. Ces sous-commandes appellent l’API Repos.

Pour plus d’informations sur les référentiels, consultez Intégration de Git aux dossiers Git 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.

Créer un référentiel

Pour afficher la documentation d’utilisation, exécutez databricks repos create --help.

Usage

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

Remplacez :

  • <url> par l’URL du fournisseur Git requise vers le référentiel.

  • <provider> par le nom du fournisseur Git, par exemple gitHub. Les fournisseurs disponibles sont les suivants :

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

    Le nom du fournisseur peut indiquer ne pas respecter la casse (par exemple, gitHub et github sont tous les deux valides).

  • <path> avec un chemin d’accès facultatif au référentiel dans l’espace de travail Azure Databricks, par exemple /Repos/someone@example.com/my-repo.

Exemple de sortie

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

Répertorier tous les référentiels disponibles dans l’espace de travail

Pour afficher la documentation d’utilisation, exécutez databricks repos list --help.

Usage

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

Remplacez :

  • <path-prefix> avec un préfixe de chemin d’accès facultatif aux référentiels dans l’espace de travail Azure Databricks, par exemple /Repos/someone@example.com/my-repo.
  • <next-page-token> avec un jeton de page suivante facultatif fourni par l’exécution de la commande précédemment, pour obtenir la page de résultats suivante.

Exemple de sortie

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

Répertorier des informations sur le référentiel

Pour afficher la documentation d’utilisation, exécutez databricks repos get --help.

Usage

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

Remplacez :

  • <repo-id> par l’ID du référentiel, par exemple 1234567890123456. Pour récupérer l’ID, exécutez la commande list. --repo-id ou --path est obligatoire.
  • <path> par un chemin d’accès au référentiel dans l’espace de travail Azure Databricks, par exemple /Repos/someone@example.com/my-repo. Pour récupérer le chemin d’accès, exécutez la commande get ou list. --repo-id ou --path est obligatoire.

Exemple de sortie

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

Mettre à jour un référentiel vers la validation la plus récente d’une branche distante ou d’une balise

Pour afficher la documentation d’utilisation, exécutez databricks repos update --help.

Usage

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>

Exactement l’un des --repo-id ou --path est requis, et exactement l’un des --branch ou --tag est requis.

--repo-id ou --path identifie le dossier Git Databricks à mettre à jour. --branch ou --tag identifie la validation vers laquelle mettre à jour ou la nouvelle branche à extraire. Si --branch ou --tag fait référence à la branche actuellement extraite, les dossiers Git Databricks effectuent une opération d’extraction pour mettre à jour vers la dernière validation de cette branche. Si --branch ou --tag fait référence à une branche qui n’est pas encore extraite, les dossiers Git Databricks extraient la branche spécifiée.

Remplacez :

  • <repo-id> par l’ID du référentiel, par exemple 1234567890123456. Pour récupérer l’ID, exécutez la commande list.
  • <path> par un chemin d’accès au référentiel dans l’espace de travail Azure Databricks, par exemple /Repos/someone@example.com/my-repo. Pour récupérer le chemin d’accès, exécutez la commande get ou list.
  • <branch> par le nom de la branche à utiliser dans le référentiel, par exemple my-branch.
  • <tag> par le nom de la branche à utiliser dans le référentiel, par exemple my-tag.

Exemple de sortie

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

Supprimer un référentiel

Pour afficher la documentation d’utilisation, exécutez databricks repos delete --help.

Usage

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

Ou :

databricks repos delete --path <path>

Remplacez :

  • <repo-id> par l’ID du référentiel, par exemple 1234567890123456. Pour récupérer l’ID, exécutez la commande list. --repo-id ou --path est obligatoire.
  • <path> par un chemin d’accès au référentiel dans l’espace de travail Azure Databricks, par exemple /Repos/someone@example.com/my-repo. Pour récupérer le chemin d’accès, exécutez la commande get ou list. --repo-id ou --path est obligatoire.

En cas de réussite, aucune sortie ne s’affiche.