使用PowerShell管理MySQL Database on Azure

Article
04/02/2020

本文主要介绍如何通过PowerShell实现更多MySQL Database on Azure的创建、查看、删除、更改等操作。建议您先阅读利用Azure 资源管理器与 PowerShell 来部署使用MySQL Database on Azure,该文介绍了如何下载使用Azure PowerShell, 如何利用PowerShell来快速创建MySQL Database on Azure数据服务。

在开始之前，请确保已将 Azure PowerShell 准备就绪。

注意：本文主要针对Azure PowerShell 0.9*版本，如果您使用1.0.0+版本，请参考Azure PowerShell 1.0.0以上版本在中国Azure使用的注意事项。将下述命令当中AzureResource改为AzureRmResource运行。

1. 了解 Azure 资源模板和资源组

大多数部署和运行在 Azure 中的应用程序是通过不同云资源类型的组合构建的。Azure资源管理器模板使你能够集中部署和管理这些不同的资源，只需对资源和关联的配置及部署参数进行 JSON 描述即可。

1.1 了解MySQL Database on Azure的资源类型参数信息

目前，MySQL Database on Azure的Json File中定义了六种资源类型： Servers, Databases, Users, Privileges, FirewallRules, Backups。用户可以通过"Get","New","Set","Remove"指令分别对上述六种资源类型进行查看、创建、修改、删除的操作。您可以通过下载Json模板文件来了解更多MySQL Database on Azure 服务的API参数定义。

2. 创建操作

通过New指令可以创建MySQL服务器、数据库、用户、用户权限、备份、防火墙规则等。

2.1 创建服务器

编辑运行以下命令，定义您的服务器名称、位置、版本等信息来完成服务器创建。

New-AzureRmResource -ResourceType "Microsoft.MySql/servers" -ResourceName testPSH -ApiVersion 2015-09-01 -ResourceGroupName resourcegroupChinaEast -Location chinaeast -SkuObject @{name='MS4'} -PropertyObject @{version = '5.5'}

2.2 创建服务器防火墙原则

编辑运行以下命令，定义您的防火墙原则名称、IP允许列表范围（起始IP地址，终止IP地址）等信息来完成防火墙原则的创建。

New-AzureRmResource -ResourceType "Microsoft.MySql/servers/firewallRules" -ResourceName testPSH/rule1 -ApiVersion 2015-09-01 -PropertyObject @{startIpAddress="0.0.0.0"; endIpAddress="255.255.255.255"} -ResourceGroupName resourcegroupChinaEast

2.3 创建数据库

编辑运行以下命令，定义您的数据库名称、字符集等信息完成数据库创建。

New-AzureRmResource -ResourceType "Microsoft.MySql/servers/databases" -ResourceName testPSH/demodb -ApiVersion 2015-09-01 -ResourceGroupName resourcegroupChinaEast -PropertyObject @{collation='utf8_general_ci'; charset='utf8'}

2.4 创建用户

编辑运行以下命令，定义您的用户名、密码等信息完成数据库创建。

New-AzureRmResource -ResourceType "Microsoft.MySql/servers/users" -ResourceName testPSH/admin -ApiVersion 2015-09-01 -ResourceGroupName resourcegroupChinaEast -PropertyObject @{password='abc123'}

2.5 添加用户权限

编辑运行以下命令，设置数据库读写权限给用户。权限分为"Read"以及"ReadWrite"。

New-AzureRmResource -ResourceType "Microsoft.MySql/servers/databases/privileges" -ResourceName testPSH/demodb/admin -ApiVersion 2015-09-01 -ResourceGroupName resourcegroupChinaEast -PropertyObject @{level='ReadWrite'}

2.6 创建按需备份文件

编辑运行以下命令，制定备份文件名称，创建按需备份文件。

New-AzureRmResource -ResourceType "Microsoft.MySql/servers/backups" -ResourceName testPSH/back1 -ApiVersion 2015-09-01 -ResourceGroupName resourcegroupChinaEast -PropertyObject @{}

2.7 服务器备份恢复（基于快照的恢复）

编辑运行以下命令，通过制定快照来恢复服务器。其中，server和region的信息必填，backup不指定的情况下，默认通过最新的快照拷贝进行恢复。

New-AzureRmResource -ResourceType "Microsoft.MySql/servers" -ResourceName testrestore -ApiVersion 2015-09-01 -ResourceGroupName resourcegroupChinaEast -Location ChinaEast -Properties @{creationSource=@{server='testPSH';region='chinaEast' ; backup = 'testpsh1b0a9038-6953-42ad-ac8e-42f73180825b'};version = '5.5'}

3. 查看操作

通过Get指令可以查看当前MySQL服务器、数据库、用户、用户权限、备份、防火墙规则等列表,也可以查看详细参数配置。

3.1 查看服务器列表

备注

** 注意:“在Azure管理门户上创建的实例，按照实例所处的区域分别在默认资源组：Default-MySql-ChinaEast以及Default-MySql-ChinaNorth**

编辑运行以下命令，查看当前所有服务器列表

Get-AzureRmResource -ResourceType "Microsoft.MySql/servers"  -ApiVersion 2015-01-01 -ResourceGroupName resourcegroupchinaeast

备注

** 注意:与其他指令不同，查看服务器中的“-ApiVersion 2015-01-01”，指向ARM的API，其他指令中，均为“-ApiVersion 2015-09-01”，指向MySQL的API。**

3.2 查看数据库列表及参数

编辑运行以下命令，查看当前资源组内某个服务器的所有数据库列表：

 Get-AzureRmResource -ResourceType "Microsoft.MySql/servers/databases" -Name testPSH -ApiVersion 2015-09-01 -ResourceGroupName resourcegroupChinaEast

3.3 查看用户列表及参数

编辑运行以下命令，查看当前资源组内某个服务器的所有用户列表：

 Get-AzureRmResource -ResourceType "Microsoft.MySql/servers/users" -Name testPSH -ApiVersion 2015-09-01 -ResourceGroupName resourcegroupChinaEast

3.4 查看用户权限列表及参数

编辑运行以下命令，查看当前资源组内某个数据库的用户权限：

 Get-AzureRmResource -ResourceType "Microsoft.MySql/servers/databases/privileges" -Name testPSH/demodb -ApiVersion 2015-09-01 -ResourceGroupName resourcegroupChinaEast

3.5 查看备份列表及参数

编辑运行以下命令，查看当前资源组内某个服务器的所有备份文件：

 Get-AzureRmResource -ResourceType "Microsoft.MySql/servers/backups" -Name testPSH -ApiVersion 2015-09-01 -ResourceGroupName resourcegroupChinaEast

3.6 查看防火墙规则列表及参数

编辑运行以下命令，查看当前资源组内某个服务器的所有防火墙规则：

 Get-AzureRmResource -ResourceType "Microsoft.MySql/servers/firewallRules" -Name testPSH -ApiVersion 2015-09-01 -ResourceGroupName resourcegroupChinaEast

3.7 查看慢查询日志

编辑运行以下命令，查看当前资源组内某个服务器的所有慢查询日志：

Get-AzureRmResource -ResourceType "Microsoft.MySql/servers/slowlogs" -Name testPSH -ApiVersion 2015-09-01 -ResourceGroupName resourcegroupChinaEast

4. 修改操作

通过Set指令可以完成账户密码修改，权限修改，某些服务器参数修改等配置工作。

4.1 修改账户密码

编辑运行以下命令，修改某个账户密码。

Set-AzureRmResource -ResourceType "Microsoft.MySql/servers/users" -ResourceName testPSH/admin -ApiVersion 2015-09-01 -ResourceGroupName resourcegroupChinaEast -PropertyObject @{password='abc1234'} -UsePatchSemantics

4.2 修改某个用户的读写权限

编辑运行以下命令，修改某个用户的读写权限。

Set-AzureRmResource -ResourceType "Microsoft.MySql/servers/databases/privileges" 		
-ResourceName testPSH/demodb/admin -ApiVersion 2015-09-01 -ResourceGroupName resourcegroupChinaEast -PropertyObject @{level='Read'} -UsePatchSemantics

4.3 允许所有Azure服务访问

编辑运行以下命令，允许所有Azure服务访问指定服务器。

Set-AzureRmResource -ResourceType "Microsoft.MySql/servers" -ResourceName testPSH -ApiVersion 2015-09-01 -ResourceGroupName resourcegroupChinaEast -PropertyObject @{allowAzureServices='true'} -UsePatchSemantics

4.4 修改默认每日备份时间

编辑运行以下命令，修改指定服务器的默认日备起始时间(此处为北京时间UTC+8)，0-24可选。

Set-AzureRmResource -ResourceType "Microsoft.MySql/servers" -ResourceName testPSH -ApiVersion 2015-09-01 -ResourceGroupName resourcegroupChinaEast -PropertyObject @{dailyBackupTimeInHour='5'} -UsePatchSemantics

4.5 开启慢查询日志

编辑运行以下命令，开启慢查询日志。

Set-AzureRmResource -ResourceType "Microsoft.MySql/servers" -ResourceName testPSH -ApiVersion 2015-09-01 -ResourceGroupName resourcegroupChinaEast -PropertyObject @{options=@{slow_query_log='ON'}} -UsePatchSemantics

4.6 修改防火墙原则

编辑运行以下命令，更改已有的防火墙原则。

Set-AzureRmResource -ResourceType "Microsoft.MySql/servers/firewallRules" -ResourceName testPSH/rule1 -ApiVersion 2015-09-01 -PropertyObject @{startIpAddress="1.1.1.1"} -ResourceGroupName resourcegroupChinaEast -UsePatchSemantics

4.7 修改部分MySQL服务器设置

以wait_timeout参数为例，其他参数详见Json文件，编辑运行以下命令，更改wait_timeout默认值。

Set-AzureRmResource -ResourceType "Microsoft.MySql/servers" -ResourceName testPSH -ApiVersion 2015-09-01 -ResourceGroupName resourcegroupChinaEast -PropertyObject @{options=@{wait_timeout=70}} -UsePatchSemantics

对其他参数的修改，可以参考下面Json文件的定义，参数的有效值范围可参考定制MySQL Database on Azure服务器参数：

	"options": {
          "type": "object",
          "properties": {
            "div_precision_increment": {
              "type": "integer"
            },
            "event_scheduler": {
              "type": "string"
            },
            "group_concat_max_len": {
              "type": "integer"
            },
            "innodb_adaptive_hash_index": {
              "type": "string"
            },
            "innodb_lock_wait_timeout": {
              "type": "integer"
            },
            "interactive_timeout": {
              "type": "integer"
            },
            "log_bin_trust_function_creators": {
              "type": "string"
            },
            "log_queries_not_using_indexes": {
              "type": "string"
            },
            "long_query_time": {
              "type": "number"
            },
            "max_allowed_packet": {
              "type": "integer"
            },
            "server-id": {
              "type": "integer"
            },
            "slow_query_log": {
              "type": "string"
            },
            "sql_mode": {
              "type": "string"
            },
            "wait_timeout": {
              "type": "integer"
            }
          }
        }

4.8 修改MySQL服务器性能版本

Set-AzureRmResource -ResourceType "Microsoft.MySql/servers" -ResourceName testPSH -ApiVersion 2015-09-01 -ResourceGroupName resourcegroupChinaEast -SkuObject @{name="MS4"} -UsePatchSemantics

5. 删除操作

通过Remove指令可以删除MySQL服务器、数据库、用户、备份、防火墙规则等。

5.1 删除服务器

编辑运行以下命令，删除指定服务器。

Remove-AzureRmResource -ResourceType "Microsoft.MySql/servers" -ResourceName testPSH -ApiVersion 2015-09-01 -ResourceGroupName resourcegroupChinaEast

5.2 删除服务器防火墙原则

编辑运行以下命令，删除指定防火墙。

Remove-AzureRmResource -ResourceType "Microsoft.MySql/servers/firewallRules" -ResourceName testPSH/rule1 -ApiVersion 2015-09-01 -ResourceGroupName resourcegroupChinaEast

5.3 删除数据库

编辑运行以下命令，删除指定数据库。

Remove-AzureRmResource -ResourceType "Microsoft.MySql/servers/databases" -ResourceName testPSH/demodb -ApiVersion 2015-09-01 -ResourceGroupName resourcegroupChinaEast

5.4 删除用户

编辑运行以下命令，删除指定用户。

Remove-AzureRmResource -ResourceType "Microsoft.MySql/servers/users" -ResourceName testPSH/admin -ApiVersion 2015-09-01 -ResourceGroupName resourcegroupChinaEast

5.5 删除备份文件

编辑运行以下命令，删除指定备份文件。

Remove-AzureRmResource -ResourceType "Microsoft.MySql/servers/backups" -ResourceName testPSH/back1 -ApiVersion 2015-09-01 -ResourceGroupName resourcegroupChinaEast

6 其它操作

6.1 Restart a server

编辑运行以下命令，重启当前资源组中的服务器。

Set-AzureRmResource -ResourceType "Microsoft.MySql/servers" -ResourceName testPSH -ApiVersion 2015-09-01 -ResourceGroupName resourcegroupChinaEast -PropertyObject @{setRestart='true'} -UsePatchSemantics

6.2 Download slowlogs

编辑运行以下命令，下载当前资源组中特定服务器的指定慢查询日志。

Set-AzureRmResource -ResourceType "Microsoft.MySql/servers/slowlogs" -ResourceName testPSH/testslowlogname -ApiVersion 2015-09-01 -ResourceGroupName resourcegroupChinaEast -PropertyObject @{copyDestinationContainerUri=”your container uri";CopyDestinationSasToken="your container sasToken"} -UsePatchSemantics

以下为带参数下载慢查询日志的代码示例。

$container = New-AzureStorageContainer -Context $account.Context -Name newcontainer
$sasToken = New-AzureStorageContainerSASToken -Name $container.Name -Permission rcw -StartTime (Get-Date).AddDays(-1) -Protocol HttpsOnly -ExpiryTime (Get-Date).AddDays(1) -Context $account.Context
Set-AzureRmResource -ResourceType "Microsoft.MySql/servers/slowlogs" -ResourceName testPSH/testslowlogname -ApiVersion 2015-09-01 -ResourceGroupName resourcegroupChinaEast -PropertyObject @{copyDestinationContainerUri=”$($container.CloudBlobContainer.Uri.AbsoluteUri)";CopyDestinationSasToken="$sasToken"} -UsePatchSemantics

随着MySQL Database on Azure提供的功能增多，我们也会陆续更新相应的PowerShell指南。

使用PowerShell管理MySQL Database on Azure

目录

1. 了解 Azure 资源模板和资源组

1.1 了解MySQL Database on Azure的资源类型参数信息

2. 创建操作

2.1 创建服务器

2.2 创建服务器防火墙原则

2.3 创建数据库

2.4 创建用户

2.5 添加用户权限

2.6 创建按需备份文件

2.7 服务器备份恢复（基于快照的恢复）

3. 查看操作

3.1 查看服务器列表

3.2 查看数据库列表及参数

3.3 查看用户列表及参数

3.4 查看用户权限列表及参数

3.5 查看备份列表及参数

3.6 查看防火墙规则列表及参数

3.7 查看慢查询日志

4. 修改操作

4.1 修改账户密码

4.2 修改某个用户的读写权限

4.3 允许所有Azure服务访问

4.4 修改默认每日备份时间

4.5 开启慢查询日志

4.6 修改防火墙原则

4.7 修改部分MySQL服务器设置

4.8 修改MySQL服务器性能版本

5. 删除操作

5.1 删除服务器

5.2 删除服务器防火墙原则

5.3 删除数据库

5.4 删除用户

5.5 删除备份文件

6 其它操作

6.1 Restart a server

6.2 Download slowlogs

Additional resources

Additional resources

使用PowerShell管理MySQL Database on Azure

目录

1. 了解 Azure 资源模板和资源组

1.1 了解MySQL Database on Azure的资源类型参数信息

2. 创建操作

2.1 创建服务器

2.2 创建服务器防火墙原则

2.3 创建数据库

2.4 创建用户

2.5 添加用户权限

2.6 创建按需备份文件

2.7 服务器备份恢复 （基于快照的恢复）

3. 查看操作

3.1 查看服务器列表

3.2 查看数据库列表及参数

3.3 查看用户列表及参数

3.4 查看用户权限列表及参数

3.5 查看备份列表及参数

3.6 查看防火墙规则列表及参数

3.7 查看慢查询日志

4. 修改操作

4.1 修改账户密码

4.2 修改某个用户的读写权限

4.3 允许所有Azure服务访问

4.4 修改默认每日备份时间

4.5 开启慢查询日志

4.6 修改防火墙原则

4.7 修改部分MySQL服务器设置

4.8 修改MySQL服务器性能版本

5. 删除操作

5.1 删除服务器

5.2 删除服务器防火墙原则

5.3 删除数据库

5.4 删除用户

5.5 删除备份文件

6 其它操作

6.1 Restart a server

6.2 Download slowlogs

Additional resources

Additional resources

2.7 服务器备份恢复（基于快照的恢复）