CLI de Pools d'instances (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.

remarque

La CLI des pools nécessite Databricks CLI 0.9.0 ou une version ultérieure.

Vous exécutez les sous-commandes en les ajoutant à databricks instance-pools. Ces sous-commandes appellent l’ API Instance Pools.

Bash

databricks instance-pools -h

Usage: databricks instance-pools [OPTIONS] COMMAND [ARGS]...

  Utility to interact with Databricks instance pools.

Options:
  -v, --version  [VERSION]
  -h, --help     Show this message and exit.

Commands:
  create           Creates a Databricks instance pool.
    Options:
      --json-file PATH         File containing JSON request to POST to /api/2.0/cluster-pools/create.
      --json JSON              JSON string to POST to /api/2.0/cluster-pools/create.
  delete           Deletes a Databricks instance pool.
    Options:
  get              Retrieves metadata about an instance pool.
    Options:
      --instance-pool-id INSTANCE_POOL_ID Can be found in the URL at https://<databricks-instance>/?o=<16-digit-number>#/setting/clusters/instance-pools/view/$INSTANCE_POOL_ID.
  list             Lists active instance pools with the stats of the pools.
    Options:
      --output FORMAT          JSON or TABLE. Set to TABLE by default.
  edit            Edits a Databricks instance pool
    Options:
      --json-file PATH         File containing JSON request to POST to /api/2.0/cluster-pools/create.
      --json JSON              JSON string to POST to /api/2.0/cluster-pools/create.

Créer un pool d’instances

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

Bash

databricks instance-pools create --json-file create-instance-pool.json

create-instance-pool.json:

JSON

{
  "instance_pool_name": "my-pool",
  "node_type_id": "i3.xlarge",
  "min_idle_instances": 10,
  "aws_attributes": {
    "availability": "SPOT"
  }
}

Console

{
  "instance_pool_id": "1234-567890-binds123-pool-abcDe4fG"
}

Supprimer un pool d'instances

Pour afficher la documentation d'utilisation, exécutez databricks instance-pools delete --help.

Bash

databricks instance-pools delete --instance-pool-id 1234-567890-binds123-pool-abcDe4fG

En cas de succès, aucune sortie n'est affichée.

Obtenir des informations sur un Pool d'instances

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

Bash

databricks instance-pools get --instance-pool-id 1234-567890-binds123-pool-abcDe4fG

Console

{
  "instance_pool_name": "My Pool",
  "min_idle_instances": 0,
  "max_capacity": 10,
  "aws_attributes": {
    "availability": "SPOT",
    "zone_id": "us-west-2c",
    "spot_bid_price_percent": 100
  },
  "node_type_id": "i3.xlarge",
  "idle_instance_autotermination_minutes": 0,
  "enable_elastic_disk": false,
  "instance_pool_id": "1234-567890-binds123-pool-abcDe4fG",
  "default_tags": {
    "Vendor": "Databricks",
    "DatabricksInstancePoolCreatorId": "123456789012345",
    "DatabricksInstancePoolId": "1234-567890-binds123-pool-abcDe4fG",
    "DatabricksInstanceGroupId": "-2345678901234567890"
  },
  "state": "ACTIVE",
  "stats": {
    "used_count": 0,
    "idle_count": 0,
    "pending_used_count": 0,
    "pending_idle_count": 0
  },
  "status": {}
}

Répertorier les informations sur les pools d'instances disponibles

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

Bash

databricks instance-pools list --output JSON

Console

{
  "instance_pools": [
    {
      "instance_pool_name": "My Pool",
      "min_idle_instances": 0,
      "max_capacity": 10,
      "aws_attributes": {
        "availability": "SPOT",
        "zone_id": "us-west-2c",
        "spot_bid_price_percent": 100
      },
      "node_type_id": "i3.xlarge",
      "idle_instance_autotermination_minutes": 0,
      "enable_elastic_disk": false,
      "instance_pool_id": "1234-567890-binds123-pool-abcDe4fG",
      "default_tags": {
        "Vendor": "Databricks",
        "DatabricksInstancePoolCreatorId": "123456789012345",
        "DatabricksInstancePoolId": "1234-567890-binds123-pool-abcDe4fG",
        "DatabricksInstanceGroupId": "-2345678901234567890"
      },
      "state": "ACTIVE",
      "stats": {
        "used_count": 0,
        "idle_count": 0,
        "pending_used_count": 0,
        "pending_idle_count": 0
      },
      "status": {}
    },
    ...
  ]
}

Modifiez les paramètres d'un Pool d'instances

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

Bash

databricks instance-pools edit --json-file edit-instance-pool.json

edit-instance-pool.json:

Console

{
  "instance_pool_name": "My Pool",
  "instance_pool_id": "1234-567890-binds123-pool-abcDe4fG",
  "min_idle_instances": 15
}

En cas de succès, aucune sortie n'est affichée.