Azure Repos CLI (ancienne)

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 pour les 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.