Microsoft Azure SDK for Python

这是Microsoft Azure Kusto管理客户端库。此包已与Python 3.7+进行测试。有关Azure库的完整视图，请参阅azure sdk python发行版。

免责声明

自2022年1月1日起，Azure SDK Python包对Python 2.7的支持已结束。有关更多信息及疑问，请参阅 https://github.com/Azure/azure-sdk-for-python/issues/20691

入门

先决条件

• 使用此包需要Python 3.7及以上版本。
• Azure订阅

安装包

pip install azure-mgmt-kusto
pip install azure-identity

身份验证

默认情况下，Azure Active Directory令牌身份验证依赖于正确配置以下环境变量。

• AZURE_CLIENT_ID 用于Azure客户端ID。
• AZURE_TENANT_ID 用于Azure租户ID。
• AZURE_CLIENT_SECRET 用于Azure客户端密钥。

此外，可以通过环境变量AZURE_SUBSCRIPTION_ID配置Azure订阅ID。

以上配置后，客户端可以通过以下代码进行身份验证

from azure.identity import DefaultAzureCredential
from azure.mgmt.kusto import KustoManagementClient
import os

sub_id = os.getenv("AZURE_SUBSCRIPTION_ID")
client = KustoManagementClient(credential=DefaultAzureCredential(), subscription_id=sub_id)

示例

此包的代码示例可以在以下位置找到

• 在docs.microsoft.com上搜索Kusto Management
• Azure Python Mgmt SDK 示例仓库

故障排除

下一步

提供反馈

如果您遇到任何错误或有任何建议，请在项目的问题部分提交问题。

版本历史

3.3.0 (2023-10-23)

新增功能

• 添加了操作组SandboxCustomImagesOperations
• 模型ClusterUpdate有一个新参数zones
• 模型EndpointDetail有一个新参数ip_address
• 模型LanguageExtension有一个新参数language_extension_custom_image_name
• 模型VirtualNetworkConfiguration有一个新参数state

3.2.0 (2023-07-21)

新增功能

• 添加了操作ClustersOperations.begin_migrate
• 添加了操作组DatabaseOperations
• 模型Cluster有一个新参数migration_cluster
• 模型ClusterUpdate有一个新参数migration_cluster
• 模型DatabaseListResult有一个新参数next_link
• 模型ReadOnlyFollowingDatabase有一个新参数suspension_details
• 模型ReadWriteDatabase有一个新参数key_vault_properties
• 模型ReadWriteDatabase有一个新参数suspension_details
• 操作DatabasesOperations.list_by_cluster有一个新的可选参数skiptoken
• 操作DatabasesOperations.list_by_cluster有一个新的可选参数top

3.1.0 (2023-02-15)

新增功能

• 添加了操作组SkusOperations
• 模型LanguageExtension有一个新参数language_extension_image_name
• 模型SkuLocationInfoItem有一个新参数zone_details
• 模型TableLevelSharingProperties有一个新参数functions_to_exclude
• 模型TableLevelSharingProperties有一个新参数functions_to_include

3.1.0b1 (2022-12-27)

新增功能

• 添加了操作组SkusOperations
• 模型LanguageExtension有一个新参数language_extension_image_name
• 模型SkuLocationInfoItem有一个新参数zone_details

3.0.0 (2022-09-15)

新增功能

• 模型AttachedDatabaseConfiguration有一个新参数database_name_override
• 模型AttachedDatabaseConfiguration有一个新参数database_name_prefix
• 模型EventHubDataConnection有一个新参数retrieval_start_date
• 模型FollowerDatabaseDefinition有一个新参数database_share_origin
• 模型FollowerDatabaseDefinition有一个新参数table_level_sharing_properties
• 模型IotHubDataConnection有一个新参数retrieval_start_date
• 模型ReadOnlyFollowingDatabase有一个新参数database_share_origin
• 模型ReadOnlyFollowingDatabase有一个新参数original_database_name
• 模型ReadOnlyFollowingDatabase有一个新参数table_level_sharing_properties

重大变更

• 操作DatabasesOperations.begin_create_or_update有一个新参数caller_role
• 操作DatabasesOperations.begin_update有一个新参数caller_role

2.2.0 (2022-02-22)

功能

• 添加了操作组OperationsResultsLocationOperations
• 模型Cluster有一个新参数private_endpoint_connections
• 模型Cluster有一个新参数public_ip_type
• 模型Cluster有一个新参数virtual_cluster_graduation_properties
• 模型ClusterPrincipalAssignment有一个新参数aad_object_id
• 模型ClusterUpdate有一个新参数private_endpoint_connections
• 模型ClusterUpdate有一个新参数public_ip_type
• 模型ClusterUpdate有一个新参数virtual_cluster_graduation_properties
• 模型DatabasePrincipalAssignment有一个新参数aad_object_id
• 模型EventGridDataConnection有一个新参数database_routing
• 模型 EventGridDataConnection 新增参数 event_grid_resource_id
• 模型 EventGridDataConnection 新增参数 managed_identity_object_id
• 模型 EventGridDataConnection 新增参数 managed_identity_resource_id
• 模型 EventHubDataConnection 新增参数 database_routing
• 模型 EventHubDataConnection 新增参数 managed_identity_object_id
• 模型 IotHubDataConnection 新增参数 database_routing
• 模型 OperationResult 新增参数 provisioning_state
• 模型 Script 新增参数 script_content

2.1.0 (2021-09-22)

功能

• 模型 Cluster 新增参数 accepted_audiences
• 模型 Cluster 新增参数 allowed_fqdn_list
• 模型 Cluster 新增参数 enable_auto_stop
• 模型 Cluster 新增参数 allowed_ip_range_list
• 模型 Cluster 新增参数 system_data
• 模型 Cluster 新增参数 restrict_outbound_network_access
• 模型 Cluster 新增参数 public_network_access
• 模型 ClusterUpdate 新增参数 accepted_audiences
• 模型 ClusterUpdate 新增参数 allowed_fqdn_list
• 模型 ClusterUpdate 新增参数 enable_auto_stop
• 模型 ClusterUpdate 新增参数 allowed_ip_range_list
• 模型 ClusterUpdate 新增参数 restrict_outbound_network_access
• 模型 ClusterUpdate 新增参数 public_network_access
• 新增操作 AttachedDatabaseConfigurationsOperations.check_name_availability
• 新增操作 ClustersOperations.list_outbound_network_dependencies_endpoints
• 新增操作组 PrivateEndpointConnectionsOperations
• 新增操作组 ManagedPrivateEndpointsOperations
• 新增操作组 PrivateLinkResourcesOperations

2.0.0 (2021-04-26)

功能

• 模型 EventHubDataConnection 新增参数 managed_identity_resource_id
• 模型 Cluster 新增参数 etag
• 模型 AttachedDatabaseConfiguration 新增参数 table_level_sharing_properties
• 新增操作组 ScriptsOperations
• 新增操作组 OperationsResultsOperations

重大变更

• 操作 ClustersOperations.begin_update 新增签名
• 操作 ClustersOperations.begin_create_or_update 新增签名

1.0.0 (2021-02-04)

• GA 发布

1.0.0b1 (2020-11-30)

这是测试预览版本。

此版本使用下一代代码生成器，引入了重要的重大变更，但也引入了重要的新功能（如统一身份验证和异步编程）。

一般性重大变更

• 凭证系统已完全重写

  • azure.common.credentials 或 msrestazure.azure_active_directory 实例不再受支持，请使用 azure-identity 类：[https://pypi.ac.cn/project/azure-identity/](https://pypi.ac.cn/project/azure-identity/)
  • credentials 参数已重命名为 credential

• 客户端上的 config 属性不再存在，配置应作为关键字参数传递。例如：`MyClient(credential, subscription_id, enable_logging=True)`。有关支持选项的完整列表，请参阅[https://github.com/Azure/azure-sdk-for-python/blob/main/sdk/core/azure-core/CLIENT_LIBRARY_DEVELOPER.md#available-policies](https://github.com/Azure/azure-sdk-for-python/blob/main/sdk/core/azure-core/CLIENT_LIBRARY_DEVELOPER.md#available-policies)

• 不能再导入 version 模块，请使用 __version__ 代替

• 以前返回 msrest.polling.LROPoller 的操作现在返回 azure.core.polling.LROPoller 并以 begin_ 前缀。

• 异常树已简化，并且大多数异常现在为 azure.core.exceptions.HttpResponseError（《CloudError》已被删除）。

• 大多数操作关键字参数已更改。其中一些最显著的更改包括

  • raw 已删除。等效功能可以通过使用 cls 找到，它是一个回调，将提供对内部 HTTP 响应的访问，供高级用户使用
  • 有关支持选项的完整列表，请参阅[https://github.com/Azure/azure-sdk-for-python/blob/main/sdk/core/azure-core/CLIENT_LIBRARY_DEVELOPER.md#available-policies](https://github.com/Azure/azure-sdk-for-python/blob/main/sdk/core/azure-core/CLIENT_LIBRARY_DEVELOPER.md#available-policies)

一般性新功能

• 支持使用 typing 类型注解。SDKs 已准备好使用 mypy。
• 此客户端现在已稳定支持异步操作。请检查您的包中的 aio 命名空间以找到异步客户端。
• 此客户端现在原生支持 OpenCensus 或 OpenTelemetry 等跟踪库。查看此 跟踪快速入门 获取概述。

0.7.0 (2020-03-20)

功能

• 模型 ClusterUpdate 有一个新参数 enable_purge
• 模型 ClusterUpdate 有一个新参数 language_extensions
• 模型 Cluster 有一个新参数 enable_purge
• 模型 Cluster 有一个新参数 language_extensions
• 添加了操作 ClustersOperations.add_language_extensions
• 添加了操作 ClustersOperations.remove_language_extensions
• 添加了操作 ClustersOperations.list_language_extensions

0.6.0 (2020-01-31)

功能

• 模型 Cluster 有一个新参数 state_reason
• 模型 ReadWriteDatabase 有一个新参数 is_followed
• 模型 EventHubDataConnection 有一个新参数 compression
• 模型 ClusterUpdate 有一个新参数 state_reason
• 添加了操作 ClustersOperations.diagnose_virtual_network
• 添加了操作组 DatabasePrincipalAssignmentsOperations
• 添加了操作组 ClusterPrincipalAssignmentsOperations

0.5.0 (2019-11-11)

功能

• 模型 ClusterUpdate 有一个新参数 key_vault_properties
• 模型 ClusterUpdate 有一个新参数 identity
• 模型 Cluster 有一个新参数 key_vault_properties
• 模型 Cluster 有一个新参数 identity
• 添加了操作 ClustersOperations.detach_follower_databases
• 添加了操作 ClustersOperations.list_follower_databases
• 添加了操作组 AttachedDatabaseConfigurationsOperations

重大变更

• 操作 DatabasesOperations.check_name_availability 有一个新的签名
• 模型 Database 不再具有参数 soft_delete_period
• 模型 Database 不再具有参数 hot_cache_period
• 模型 Database 不再具有参数 statistics
• 模型 Database 不再具有参数 provisioning_state
• 模型 Database 有一个新必需参数 kind

0.4.0 (2019-08-27)

功能

• 模型 Cluster 有一个新参数 enable_disk_encryption
• 模型 Cluster 有一个新参数 zones
• 模型 Cluster 有一个新参数 optimized_autoscale
• 模型 Cluster 有一个新参数 virtual_network_configuration
• 模型 Cluster 有一个新参数 enable_streaming_ingest
• 模型 EventHubDataConnection 有一个新参数 event_system_properties
• 模型 CheckNameResult 有一个新参数 reason
• 模型 DatabasePrincipal 有一个新参数 tenant_name
• 模型 ClusterUpdate 有一个新参数 enable_disk_encryption
• 模型 ClusterUpdate 有一个新参数 optimized_autoscale
• 模型 ClusterUpdate 有一个新参数 enable_streaming_ingest
• 模型 ClusterUpdate 有一个新参数 virtual_network_configuration
• 添加了操作 DataConnectionsOperations.check_name_availability

一般性重大变更

本版本使用下一代代码生成器，可能会引入一些破坏性更改，如果从某些导入。总之，一些模块被错误地设置为可见/可导入，并已被重命名。这修复了由于使用本来不应使用的类而导致的一些问题。

• 无法从 azure.mgmt.kusto.kusto_management_client 导入 KustoManagementClient（从 azure.mgmt.kusto 导入的效果与以前相同）
• KustoManagementClientConfiguration 的导入已从 azure.mgmt.kusto.kusto_management_client 移动到 azure.mgmt.kusto
• “models” 子模块中的模型 MyClass 无法使用 azure.mgmt.kusto.models.my_class 导入（从 azure.mgmt.kusto.models 导入的效果与以前相同）
• 来自 operations 子模块的操作类 MyClassOperations 无法使用 azure.mgmt.kusto.operations.my_class_operations 导入（从 azure.mgmt.kusto.operations 导入的效果与以前相同）

最后但同样重要的是，HTTP 连接池现在默认启用。您应始终将客户端用作上下文管理器，或调用 close()，或每个进程使用不超过一个客户端。

0.3.0 (2019-02-06)

功能

• 模型 DatabaseUpdate 有一个新参数 hot_cache_period
• 模型 DatabaseUpdate 有一个新参数 soft_delete_period
• 模型数据库新增参数 hot_cache_period
• 模型数据库新增参数 soft_delete_period
• 添加操作组 DataConnectionsOperations

重大变更

• 模型数据库更新不再有参数 hot_cache_period_in_days
• 模型数据库更新不再有参数 etag
• 模型数据库更新不再有参数 soft_delete_period_in_days
• 模型数据库不再有参数 tags
• 模型数据库不再有参数 etag
• 模型数据库不再有参数 hot_cache_period_in_days
• 模型数据库不再有参数 soft_delete_period_in_days
• 模型集群不再有参数 etag
• 模型集群更新不再有参数 etag
• 移除操作组 EventHubConnectionsOperations

0.2.0 (2018-11-27)

功能

• 模型集群新增参数 uri
• 模型集群新增参数 state
• 模型集群新增参数 data_ingestion_uri
• 模型集群新增参数 trusted_external_tenants
• 模型数据库更新新增参数 etag
• 模型数据库更新新增参数 statistics
• 模型数据库更新新增参数 hot_cache_period_in_days
• 模型数据库新增参数 statistics
• 模型数据库新增参数 hot_cache_period_in_days
• 模型集群更新新增参数 uri
• 模型集群更新新增参数 etag
• 模型集群更新新增参数 state
• 模型集群更新新增参数 sku
• 模型集群更新新增参数 tags
• 模型集群更新新增参数 data_ingestion_uri
• 模型集群更新新增参数 trusted_external_tenants
• 添加操作 DatabasesOperations.list_principals
• 添加操作 DatabasesOperations.check_name_availability
• 添加操作 DatabasesOperations.add_principals
• 添加操作 DatabasesOperations.remove_principals
• 添加操作 ClustersOperations.list_skus
• 添加操作 ClustersOperations.list_skus_by_resource
• 添加操作 ClustersOperations.start
• 添加操作 ClustersOperations.check_name_availability
• 添加操作 ClustersOperations.stop
• 添加操作组 EventHubConnectionsOperations

重大变更

• 操作 DatabasesOperations.update 新增签名
• 操作 ClustersOperations.update 新增签名
• 操作 DatabasesOperations.update 新增签名
• 操作 ClustersOperations.create_or_update 新增签名
• 模型集群新增必选参数 sku

0.1.0 (2018-08-09)

• 初始发布