インスタンス プール CLI (レガシ)
重要
このドキュメントは廃止され、更新されない可能性があります。
この情報は、レガシ Databricks CLI バージョン 0.18 以前に適用されます。 Databricks では、代わりにバージョン 0.205 以降の新しい Databricks CLI を使うことをお勧めします。 「Databricks CLI について」を参照してください。 お使いの Databricks CLI のバージョンを確認するには、databricks -v
を実行してください。
Databricks CLI バージョン 0.18 以前から Databricks CLI バージョン 0.205 以降に移行する場合は、「Databricks CLI の移行」を参照してください。
Note
プール CLI には、Databricks CLI 0.9.0 以上が必要です。
サブコマンドは、databricks instance-pools
に追加することで実行します。 これらのサブコマンドは、Instance Pools API を呼び出します。
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.
インスタンス プールを作成する
使用に関するドキュメントを表示するには、databricks instance-pools create --help
を実行します。
databricks instance-pools create --json-file create-instance-pool.json
create-instance-pool.json
:
{
"instance_pool_name": "my-pool",
"node_type_id": "Standard_D3_v2",
"min_idle_instances": 10
}
{
"instance_pool_id": "1234-567890-binds123-pool-abcDe4fG"
}
インスタンス プールを削除する
使用に関するドキュメントを表示するには、databricks instance-pools delete --help
を実行します。
databricks instance-pools delete --instance-pool-id 1234-567890-binds123-pool-abcDe4fG
成功した場合、出力は表示されません。
インスタンス プールに関する情報を取得する
使用に関するドキュメントを表示するには、databricks instance-pools get --help
を実行します。
databricks instance-pools get --instance-pool-id 1234-567890-binds123-pool-abcDe4fG
{
"instance_pool_name": "My Pool",
"min_idle_instances": 2,
"node_type_id": "Standard_F16s",
"idle_instance_autotermination_minutes": 4320,
"enable_elastic_disk": true,
"preloaded_spark_versions": [
"5.5.x-scala2.11"
],
"azure_attributes": {
"availability": "ON_DEMAND_AZURE"
},
"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": 2,
"pending_used_count": 0,
"pending_idle_count": 0
},
"status": {}
}
使用可能なインスタンス プールに関する情報を一覧表示する
使用に関するドキュメントを表示するには、databricks instance-pools list --help
を実行します。
databricks instance-pools list --output JSON
{
"instance_pools": [
{
"instance_pool_name": "My Pool",
"min_idle_instances": 2,
"node_type_id": "Standard_F16s",
"idle_instance_autotermination_minutes": 4320,
"enable_elastic_disk": true,
"preloaded_spark_versions": [
"5.5.x-scala2.11"
],
"azure_attributes": {
"availability": "ON_DEMAND_AZURE"
},
"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": 2,
"pending_used_count": 0,
"pending_idle_count": 0
},
"status": {}
},
...
]
}
インスタンス プールの設定を変更する
使用に関するドキュメントを表示するには、databricks instance-pools edit --help
を実行します。
databricks instance-pools edit --json-file edit-instance-pool.json
edit-instance-pool.json
:
{
"instance_pool_name": "My Pool",
"instance_pool_id": "1234-567890-binds123-pool-abcDe4fG",
"min_idle_instances": 15
}
成功した場合、出力は表示されません。