实例池 CLI(旧版)
重要
本文档已过时,将来可能不会更新。
此信息适用于旧版 Databricks CLI 0.18 及更低版本。 Databricks 建议改用较新的 Databricks CLI 0.205 或更高版本。 请参阅什么是 Databricks CLI?。 若要查找你的 Databricks CLI 的版本,请运行 databricks -v
。
要从 Databricks CLI 版本 0.18 或更低版本迁移到 Databricks CLI 版本 0.205 或更高版本,请参阅 Databricks CLI 迁移。
注意
池 CLI 需要 Databricks CLI 0.9.0 或更高版本。
可以通过将子命令追加到 databricks 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
}
如果成功,则不显示任何输出。