Microsoft Azure SDK for Python

这是Microsoft Azure RDBMS管理客户端库。此软件包已在Python 2.7、3.6+上进行测试。要查看Azure库的完整视图，请参阅azure sdk python发布。

免责声明

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

用法

要了解如何使用此包，请参阅快速入门指南

有关文档和参考资料，请参阅 Python SDK 参考资料。该软件包的代码示例可在docs.microsoft.com上的RDBMS 管理部分找到。不同Azure服务的附加代码示例可在代码示例仓库找到。

提供反馈

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

发行历史

10.1.0 (2022-03-07)

特性

• 添加了模型 DataEncryption
• 添加了模型 DataEncryptionType
• 添加了模型 Identity
• 添加了模型 UserAssignedIdentity

10.0.0 (2021-10-08)

重大变更

• 模型 Server不再具有参数 identity

9.1.0 (2021-09-02)

特性

• 升级api-version至2021-05-01

9.1.0b1 (2021-07-19)

特性

• 添加了操作组 BackupsOperations

9.0.0 (2021-07-01)

特性

• 模型 ServerVersionCapability有一个新的参数status
• 模型 Server有一个新的参数network
• 模型 Server有一个新的参数backup
• 模型 Server有一个新的参数storage
• 模型 Server有一个新的参数system_data
• 模型 Server有一个新的参数high_availability
• 模型 Server有一个新的参数minor_version
• 模型 Server有一个新的参数source_server_resource_id
• 模型 Database有一个新的参数system_data
• 模型 StorageProfile有一个新的参数storage_autogrow
• 模型 StorageProfile有一个新的参数geo_redundant_backup
• 模型 VcoreCapability有一个新的参数status
• 模型 Configuration有一个新的参数system_data
• 模型 StorageEditionCapability有一个新的参数status
• 模型 FirewallRule有一个新的参数system_data
• 模型 ServerForUpdate有一个新的参数create_mode
• 模型 ServerForUpdate有一个新的参数backup
• 模型 ServerForUpdate有一个新的参数high_availability
• 模型 ServerForUpdate有一个新的参数storage
• 模型 StorageMBCapability有一个新的参数status
• 添加了操作 GetPrivateDnsZoneSuffixOperations.execute
• 添加了操作 ConfigurationsOperations.begin_put

重大变更

• 操作 ServersOperations.begin_restart有一个新的签名
• 模型 Server不再有参数byok_enforcement
• 模型 Server不再有参数public_network_access
• 模型 Server不再有参数display_name
• 模型 Server不再有参数ha_state
• 模型 Server不再有参数private_dns_zone_arguments
• 模型 Server不再有参数source_server_name
• 模型 Server不再有参数storage_profile
• 模型 Server不再有参数source_resource_group_name
• 模型 Server不再有参数delegated_subnet_arguments
• 模型 Server不再有参数source_subscription_id
• 模型 Server不再有参数ha_enabled
• 模型 Server不再有参数standby_availability_zone
• 模型 ServerForUpdate不再有参数storage_profile
• 模型 ServerForUpdate不再有参数ha_enabled
• 模型 CapabilityProperties有一个新的签名

8.1.0 (2021-06-08)

• 为 mariadb添加了新的模型和操作

8.1.0b4 (2021-04-29)

特性

• 添加了操作 ServerSecurityAlertPoliciesOperations.list_by_server
• 添加了操作 ServerKeysOperations.list

重大变更

• 删除了操作 ServerKeysOperations.list_by_server

8.1.0b3 (2021-04-27)

特性

• 模型 Server有一个新的参数private_dns_zone_arguments
• 添加了操作 ServerKeysOperations.list_by_server
• 添加了操作组 GetPrivateDnsZoneSuffixOperations

重大变更

• 删除了操作 ServerSecurityAlertPoliciesOperations.list_by_server
• 删除了操作 ServerKeysOperations.list

8.1.0b2 (2021-03-19)

特性

• 模型 Server有一个新的参数source_subscription_id
• 模型 Server有一个新的参数source_resource_group_name

8.1.0b1 (2021-03-17)

特性

• 添加了操作 ServerSecurityAlertPoliciesOperations.list_by_server

8.0.0 (2020-12-28)

• GA发布

8.0.0b1 (2020-11-05)

这是一个beta预览版本。

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

一般破坏性变更

• 凭证系统已被完全重制

  • 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 属性不再存在，配置应作为 kwarg 传递。示例：MyClient(credential, subscription_id, enable_logging=True)。有关支持选项的完整集合，请参阅azure-core 初始化文档中接受的参数

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

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

• 异常树已被简化，大多数异常现在是 azure.core.exceptions.HttpResponseError（已删除 CloudError）

• 大多数操作 kwarg 都已更改。其中一些最引人注目的是

  • raw 已被删除。等效功能可以通过使用 cls（将提供对内部 HTTP 响应的访问权限，供高级用户使用）找到
  • 有关支持选项的完整集合，请参阅azure-core 请求文档中接受的参数

一般新功能

• 支持使用 typing 进行类型注解。SDKs 已准备就绪供 mypy 使用。
• 该客户端现在提供稳定和官方的异步支持。检查您包的 aio 命名空间以查找异步客户端。
• 该客户端现在原生支持像 OpenCensus 或 OpenTelemetry 这样的跟踪库。查看这个跟踪快速入门以了解概述。

3.1.0rc1 (2020-09-25)

特性

• 模型操作有一个新的参数 is_data_action
• 模型操作列表结果有一个新的参数 next_link

3.0.0rc1 (2020-09-15)

特性

• 模型名称可用性有一个新的参数名称
• 模型名称可用性有一个新的参数类型
• 添加了操作 ServersOperations.start
• 添加了操作 ServersOperations.stop
• 添加了操作 ConfigurationsOperations.update
• 添加了操作组 VirtualNetworkSubnetUsageOperations
• 添加了操作组 LocationBasedCapabilitiesOperations
• 添加了操作组 CheckVirtualNetworkSubnetUsageOperations

重大变更

• 模型名称可用性不再有参数 reason
• 模型存储配置文件不再有参数 geo_redundant_backup
• 模型存储配置文件不再有参数 storage_autogrow
• 模型服务器有一个新的签名
• 模型 Sku 有一个新的签名
• 删除了操作 ConfigurationsOperations.create_or_update

2.2.0 (2020-03-25)

特性

• 模型服务器更新参数有一个新的参数 public_network_access
• 模型服务器创建参数有一个新的参数 public_network_access
• 模型服务器有一个新的参数 public_network_access
• 模型服务器有一个新的参数 private_endpoint_connections
• 模型服务器恢复参数有一个新的参数 public_network_access
• 模型服务器副本参数有一个新的参数 public_network_access
• 模型服务器默认创建参数有一个新的参数 public_network_access
• 模型服务器地理恢复参数有一个新的参数 public_network_access

2.1.0 (2020-03-23)

特性

• 模型服务器副本参数有一个新的参数 infrastructure_encryption
• 模型服务器副本参数有一个新的参数 minimal_tls_version
• 模型服务器副本参数有一个新的参数 public_network_access
• 模型服务器创建有一个新的参数 identity
• 模型服务器更新参数有一个新的参数 minimal_tls_version
• 模型服务器更新参数有一个新的参数 identity
• 模型服务器更新参数有一个新的参数 public_network_access
• 模型服务器有一个新的参数 byok_enforcement
• 模型服务器有一个新的参数 minimal_tls_version
• 模型服务器有一个新的参数 public_network_access
• 模型服务器新增参数 infrastructure_encryption
• 模型服务器新增参数 identity
• 模型服务器有一个新的参数 private_endpoint_connections
• Model ServerPropertiesForDefaultCreate 新增参数 infrastructure_encryption
• Model ServerPropertiesForDefaultCreate 新增参数 minimal_tls_version
• 模型服务器默认创建参数有一个新的参数 public_network_access
• Model ServerPropertiesForGeoRestore 新增参数 infrastructure_encryption
• Model ServerPropertiesForGeoRestore 新增参数 minimal_tls_version
• 模型服务器地理恢复参数有一个新的参数 public_network_access
• Model ServerPropertiesForCreate 新增参数 infrastructure_encryption
• Model ServerPropertiesForCreate 新增参数 minimal_tls_version
• 模型服务器创建参数有一个新的参数 public_network_access
• Model ServerPropertiesForRestore 新增参数 infrastructure_encryption
• Model ServerPropertiesForRestore 新增参数 minimal_tls_version
• 模型服务器恢复参数有一个新的参数 public_network_access
• 添加操作组 ServerKeysOperations
• 添加操作组 ServerAdministratorsOperations

2.0.0 (2020-02-21)

特性

• 添加操作组 PrivateLinkResourcesOperations
• 添加操作组 PrivateEndpointConnectionsOperations
• 添加操作组 AdvisorsOperations
• 添加操作组 MySQLManagementClientOperationsMixin
• 添加操作组 QueryTextsOperations
• 添加操作组 RecommendedActionsOperations
• 添加操作组 MariaDBManagementClientOperationsMixin
• 添加操作组 LocationBasedRecommendedActionSessionsOperationStatusOperations
• 添加操作组 LocationBasedRecommendedActionSessionsResultOperations
• 添加操作组 WaitStatisticsOperations
• 添加操作组 TopQueryStatisticsOperations

一般破坏性变更

本版本使用下一代代码生成器，如果某些导入可能导致破坏性更改。总之，一些模块不正确地可见/可导入，并已重命名。这修复了由于使用不应最初使用的类而引起的一些问题。

• MariaDBManagementClient 不能从 azure.mgmt.rdbms.mariadb.maria_db_management_client 导入（从 azure.mgmt.rdbms.mariadb 的导入仍然像以前一样工作）
• KustoManagementClientConfiguration 的导入已从 azure.mgmt.rdbms.mariadb.maria_db_management_client 移动到 azure.mgmt.rdbms.mariadb
• 从 "models" 子模块的模型 MyClass 不能使用 azure.mgmt.rdbms.mariadb.models.my_class 再次导入（从 azure.mgmt.rdbms.mariadb.models 的导入仍然像以前一样工作）
• 从 operations 子模块的操作类 MyClassOperations 不能使用 azure.mgmt.rdbms.mariadb.operations.my_class_operations 再次导入（从 azure.mgmt.rdbms.mariadb.operations 的导入仍然像以前一样工作）
• MySQLManagementClient 不能从 azure.mgmt.rdbms.mysql.my_sql_management_client 再次导入（从 azure.mgmt.rdbms.mysql 的导入仍然像以前一样工作）
• MySQLManagementClientConfiguration 的导入已从 azure.mgmt.rdbms.mysql.my_sql_management_client 移动到 azure.mgmt.rdbms.mysql
• 从 "models" 子模块的模型 MyClass 不能使用 azure.mgmt.rdbms.mysql.models.my_class 再次导入（从 azure.mgmt.rdbms.mysql.models 的导入仍然像以前一样工作）
• 从 operations 子模块的操作类 MyClassOperations 不能使用 azure.mgmt.rdbms.mysql.operations.my_class_operations 再次导入（从 azure.mgmt.rdbms.mysql.operations 的导入仍然像以前一样工作）
• PostgreSQLManagementClient 不能从 azure.mgmt.rdbms.postgresql.postgre_sql_management_client 再次导入（从 azure.mgmt.rdbms.postgresql 的导入仍然像以前一样工作）
• PostgreSQLManagementClientConfiguration 的导入已从 azure.mgmt.rdbms.postgresql.my_sql_management_client 移动到 azure.mgmt.rdbms.postgresql
• 从 "models" 子模块的模型 MyClass 不能使用 azure.mgmt.rdbms.postgresql.models.my_class 再次导入（从 azure.mgmt.rdbms.postgresql.models 的导入仍然像以前一样工作）
• 从 operations 子模块的操作类 MyClassOperations 不能使用 azure.mgmt.rdbms.postgresql.operations.my_class_operations 再次导入（从 azure.mgmt.rdbms.postgresql.operations 的导入仍然像以前一样工作）

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

1.9.0 (2019-06-04)

特性

• 在所有数据库中添加 storage_autogrow
• 支持 PG11

1.8.0 (2019-04-08)

特性

• Model ServerUpdateParameters 新增参数 replication_role

1.7.1 (2019-03-18)

功能（仅限 PostgreSQL）

• 模型服务器新增参数 replica_capacity
• 模型服务器新增参数 replication_role
• 模型服务器新增参数 master_server_id
• 添加操作组 ReplicasOperations

1.7.0 (2019-03-01)

功能（仅限 MariaDB）

• Model ServerUpdateParameters 新增参数 replication_role
• 模型服务器新增参数 master_server_id
• 模型服务器新增参数 replica_capacity
• 模型服务器新增参数 replication_role
• 添加操作 ServersOperations.restart
• 添加操作组 ReplicasOperations

1.6.0 (2019-02-26)

特性

• 添加操作 ServersOperations.restart

1.5.0 (2018-10-30)

特性

• 为 MariaDB 添加操作组 VirtualNetworkRulesOperations

1.4.1 (2018-10-16)

修复错误

• 修复 1.4.0 中的 sdist 故障。没有代码更改。

1.4.0 (2018-10-11)

特性

• 模型服务器新增参数 replication_role
• 模型服务器新增参数 master_server_id
• 模型服务器新增参数 replica_capacity
• Model ServerUpdateParameters 新增参数 replication_role
• 添加操作组 ReplicasOperations

注意

• 在 Python 3（基于 PEP420 的命名空间包）上不再安装 azure-mgmt-nspkg

1.3.0 (2018-09-13)

特性

• 为 MySQL 添加操作组 ServerSecurityAlertPoliciesOperations
• 添加对 PostgreSQL 10.x 的支持
• 添加对 MariaDB 的支持（公开预览）

1.2.0 (2018-05-30)

特性

• 添加操作组 VirtualNetworkRulesOperations
• 添加操作组 ServerSecurityAlertPoliciesOperations（仅 PostgreSQL）
• 客户端类可以用作上下文管理器，以保持底层 HTTP 会话打开以提高性能

1.1.1 (2018-04-17)

修复错误

• 修复 Python 3 中的一些无效模型
• sdist 与 wheel 0.31.0 的兼容性

1.1.0 (2018-03-29)

特性

• 为 MySQL 和 PostgreSQL 添加地理恢复功能

1.0.0 (2018-03-19)

一般性重大更改

此版本使用下一代代码生成器，可能会引入重大更改。

• 模型签名现在仅使用关键字参数语法。所有位置参数都必须重写为关键字参数。为了在大多数情况下保持自动完成，现在为 Python 2 和 Python 3 生成模型。Python 3 使用 "*" 语法来指定关键字参数。
• 枚举类型现在使用 "str" 混合（类 AzureEnum(str, Enum)）以改进遇到未识别的枚举值时的行为。虽然这不是一个重大更改，但区别很重要，此处有文档说明：https://docs.pythonlang.cn/3/library/enum.html#others 快速浏览
  • 不应使用 "is"。
  • "format" 将返回字符串值，其中 "%s" 字符串格式化将返回 NameOfEnum.stringvalue。应首选格式化语法。
• 新的长时间运行操作
  • 返回类型从 msrestazure.azure_operation.AzureOperationPoller 更改为 msrest.polling.LROPoller。外部 API 保持不变。
  • 返回类型现在是 始终 一个 msrest.polling.LROPoller，无论使用的是哪些可选参数。
  • 使用 raw=True 的行为已更改。现在不再返回初始调用结果作为 ClientRawResponse，而不进行轮询，现在它返回一个 LROPoller。轮询后，最终资源将作为 ClientRawResponse 返回。
  • 新的 polling 参数。默认行为是 Polling=True，这将使用 ARM 算法轮询。当 Polling=False 时，将返回初始调用的响应，而不进行轮询。
  • polling 参数接受 msrest.polling.PollingMethod 子类的实例。
  • add_done_callback 不会在轮询完成后引发异常，而是立即执行回调。

RDBMS 重大更改

• 一些属性已从对象 "PerformanceTierProperties" 移动到 "PerformanceTierServiceLevelObjectives"（向下移动一个级别）。

API 版本现在是 2017-12-01

0.3.1 (2018-02-28)

• 删除尚未提供的 GeoRestore 选项。

0.3.0 (2018-02-26)

• 发布新的定价模型

0.2.0rc1（2017-10-16）

• Postgres 和 MySQL 的 VNET 规则 API 规范

0.1.0 (2017-05-08)

• 初始发布