Aller au contenu principal
Dernière mise à jour le

CLI des politiques de clusters (hérité)

important

Cette documentation a été retirée et pourrait ne pas être mise à jour.

Ces informations s'appliquent aux anciennes versions de la CLI Databricks 0.18 et antérieures. Databricks vous recommande d'utiliser plutôt la version 0.205 ou ultérieure de Databricks CLI. Voir CLI Databricks. Pour trouver votre version de la 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 la migration de Databricks CLI.

Seuls les utilisateurs administrateurs du workspace peuvent créer, modifier et supprimer des stratégies. Les utilisateurs administrateurs du workspace ont également accès à toutes les stratégies.

Pour les exigences et les limitations relatives aux politiques de cluster, consultez Créer et gérer des politiques de compute.

Vous exécutez les sous-commandes CLI des politiques de Cluster Databricks en les ajoutant à databricks cluster-policies. Ces sous-commandes appellent l'API des politiques de clusters.

Bash
databricks cluster-policies --help
Usage: databricks cluster-policies [OPTIONS] COMMAND [ARGS]...

  Utility to interact with Databricks cluster policies.

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 Databricks cluster policy.
  delete  Removes a Databricks cluster policy given its ID.
  edit    Edits a Databricks cluster policy.
  get     Retrieves metadata about a Databricks cluster policy.
  list    Lists Databricks cluster policies.

Créer une politique de cluster​

Pour afficher la documentation d'utilisation, exécutez databricks cluster-policies create --help.

Bash
databricks cluster-policies create --json-file create-cluster-policy.json

create-cluster-policy.json:

JSON
{
  "name": "Example Policy",
  "definition": "{\"spark_version\":{\"type\":\"fixed\",\"value\":\"next-major-version-scala2.12\",\"hidden\":true}}"
}
Console
{
  "policy_id": "1A234567B890123C"
}

Supprimer une règle de cluster​

Pour afficher l'aide, exécutez databricks cluster-policies delete --help.

Bash
databricks cluster-policies delete --policy-id 1A234567B890123C

En cas de succès, cette commande n'affiche rien.

Modifier une règle de cluster​

Pour afficher la documentation d'utilisation, exécutez databricks cluster-policies edit --help.

Bash
databricks cluster-policies edit --json-file edit-cluster-policy.json

edit-cluster-policy.json:

JSON
{
  "policy_id": "1A234567B890123C",
  "name": "Example Policy",
  "definition": "{\"spark_version\":{\"type\":\"fixed\",\"value\":\"next-major-version-scala2.12\",\"hidden\":false}}",
  "created_at_timestamp": 1619477108000
}

En cas de succès, cette commande n'affiche rien.

Lister les informations sur une stratégie de cluster​

Pour afficher la documentation d'utilisation, exécutez databricks cluster-policies get --help.

Bash
databricks cluster-policies get --policy-id A123456BCD789012
Console
{
  "policy_id": "A123456BCD789012",
  "name": "Cluster Policy Demo",
  "definition": "{\n  \"spark_env_vars.PYSPARK_PYTHON\": {\n    \"type\": \"fixed\",\n    \"value\": \"/databricks/python3/bin/python27\"\n  }\n}",
  "created_at_timestamp": 1615504519000
}

Liste des informations sur les politiques de cluster disponibles​

Pour afficher la documentation d'utilisation, exécutez databricks cluster-policies list --help.

Bash
databricks cluster-policies list --output JSON
Console
{
  "policies": [
    {
      "policy_id": "A123456BCD789012",
      "name": "Cluster Policy Demo",
      "definition": "{\n  \"spark_env_vars.PYSPARK_PYTHON\": {\n    \"type\": \"fixed\",\n    \"value\": \"/databricks/python3/bin/python27\"\n  }\n}",
      "created_at_timestamp": 1615504519000
    },
    ...
  ],
  "total_count": 16
}
Sur cette page