Início Rápido: Criar um servidor de Banco de Dados do Azure para MySQL usando a CLI do Azure
APLICA-SE A: Banco de Dados do Azure para MySQL – Servidor Único
Importante
O servidor único do Banco de Dados do Azure para MySQL está no caminho da desativação. É altamente recomendável que você atualize para o servidor flexível do Banco de Dados do Azure para MySQL. Para obter mais informações sobre a migração para o servidor flexível do Banco de Dados do Azure para MySQL, confira O que está acontecendo com o Servidor Único do Banco de Dados do Azure para MySQL?
Dica
Considere a possibilidade de usar o comando mais simples da CLI do Azure az mysql up (atualmente em versão prévia). Experimente o início rápido.
Este início rápido mostra como usar os comandos da CLI do Azure no Azure Cloud Shell para criar um servidor de Banco de Dados do Azure para MySQL em cinco minutos.
Caso você não tenha uma assinatura do Azure, crie uma conta gratuita do Azure antes de começar.
Pré-requisitos
Use o ambiente Bash no Azure Cloud Shell. Para obter mais informações, confira Início Rápido para Bash no Azure Cloud Shell.
Se preferir executar os comandos de referência da CLI localmente, instale a CLI do Azure. Para execuções no Windows ou no macOS, considere executar a CLI do Azure em um contêiner do Docker. Para obter mais informações, confira Como executar a CLI do Azure em um contêiner do Docker.
Se estiver usando uma instalação local, entre com a CLI do Azure usando o comando az login. Para concluir o processo de autenticação, siga as etapas exibidas no terminal. Para ver outras opções de entrada, confira Conectar-se com a CLI do Azure.
Quando solicitado, instale a extensão da CLI do Azure no primeiro uso. Para obter mais informações sobre extensões, confira Usar extensões com a CLI do Azure.
Execute az version para localizar a versão e as bibliotecas dependentes que estão instaladas. Para fazer a atualização para a versão mais recente, execute az upgrade.
Este guia de início rápido exige a versão 2.0 ou posterior da CLI do Azure. Se você está usando o Azure Cloud Shell, a versão mais recente já está instalada.
Selecione a assinatura específica em sua conta usando o comando az account set. Anote o valor de id da saída az login para usar como valor para o argumento subscription no comando. Se tiver várias assinaturas, escolha a que for adequada para cobrança do recurso. Para obter todas as suas assinaturas, use az account list.
az account set --subscription <subscription id>
Criar um Banco de Dados do Azure para o servidor MySQL
Crie um grupo de recursos do Azure usando o comando az group create e crie seu servidor MySQL dentro desse grupo. Você deve fornecer um nome exclusivo. O exemplo a seguir cria um grupo de recursos chamado myresourcegroup
na localização westus
.
az group create --name myresourcegroup --location westus
Crie um servidor de Banco de Dados do Azure para MySQL com o comando az mysql server create. Um servidor pode conter vários bancos de dados.
az mysql server create --resource-group myresourcegroup --name mydemoserver --location westus --admin-user myadmin --admin-password <server_admin_password> --sku-name GP_Gen5_2
Estes são os detalhes dos argumentos acima:
Configuração | Valor de exemplo | Descrição |
---|---|---|
name | mydemoserver | Insira um nome exclusivo que identifique seu servidor do Banco de Dados do Azure para MySQL. O nome do servidor pode conter apenas letras minúsculas, números e o caractere de hífen (-). Ele deve conter de 3 a 63 caracteres. |
resource-group | myresourcegroup | Forneça o nome do grupo de recursos do Azure. |
local | westus | O local do Azure para o servidor. |
admin-user | myadmin | O nome de usuário para o logon de administrador. Não pode ser azure_superuser, admin, administrator, root, guest nem public. |
admin-password | senha de segurança | A senha do usuário administrador. Ele deve conter entre 8 e 128 caracteres. A senha precisa conter caracteres de três das seguintes categorias: Letras maiúsculas, letras minúsculas, números e caracteres não alfanuméricos. |
sku-name | GP_Gen5_2 | Insira o nome do tipo de preço e a configuração de computação. Segue a convenção {tipo de preço} {geração de computação} {vCores} em formato abreviado. Confira os tipos de preço para obter mais informações. |
Importante
- A versão padrão do MySQL no seu servidor é a 5.7. No momento, as versões 5.6 e 8.0 também estão disponíveis.
- Para exibir todos os argumentos do comando az mysql server create, confira este documento de referência.
- O SSL é habilitado por padrão no seu servidor. Para obter mais informações sobre o SSL, confira Configurar a conectividade SSL
Configurar uma regra de firewall no nível de servidor
Por padrão, o novo servidor criado é protegido com regras de firewall e não é acessível publicamente. Você pode configurar a regra de firewall no servidor usando o comando az mysql server firewall-rule create. Isso permitirá que você se conecte ao servidor localmente.
O exemplo a seguir cria uma regra de firewall chamada AllowMyIP
, que permite conexões de um endereço IP específico, 192.168.0.1. Substitua o endereço IP do qual você se conectará. Use um intervalo de endereços IP, se necessário. Se você não sabe como procurar seu endereço IP, acesse https://whatismyipaddress.com/ para obtê-lo.
az mysql server firewall-rule create --resource-group myresourcegroup --server mydemoserver --name AllowMyIP --start-ip-address 192.168.0.1 --end-ip-address 192.168.0.1
Observação
As conexões ao Banco de Dados do Azure para MySQL se comunicam pela porta 3306. Se estiver tentando se conectar em uma rede corporativa, talvez o tráfego de saída pela porta 3306 não seja permitido. Se esse for o caso, você não poderá se conectar ao seu servidor enquanto o departamento de TI não abrir a porta 3306.
Obter informações de conexão
Para se conectar ao servidor, é preciso fornecer credenciais de acesso e informações do host.
az mysql server show --resource-group myresourcegroup --name mydemoserver
O resultado está no formato JSON. Anote o fullyQualifiedDomainName e o administratorLogin.
{
"administratorLogin": "myadmin",
"earliestRestoreDate": null,
"fullyQualifiedDomainName": "mydemoserver.mysql.database.azure.com",
"id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myresourcegroup/providers/Microsoft.DBforMySQL/servers/mydemoserver",
"location": "westus",
"name": "mydemoserver",
"resourceGroup": "myresourcegroup",
"sku": {
"capacity": 2,
"family": "Gen5",
"name": "GP_Gen5_2",
"size": null,
"tier": "GeneralPurpose"
},
"sslEnforcement": "Enabled",
"storageProfile": {
"backupRetentionDays": 7,
"geoRedundantBackup": "Disabled",
"storageMb": 5120
},
"tags": null,
"type": "Microsoft.DBforMySQL/servers",
"userVisibleState": "Ready",
"version": "5.7"
}
Conectar-se ao servidor do Banco de Dados do Azure para MySQL usando o cliente de linha de comando mysql
Você pode se conectar ao seu servidor usando uma ferramenta de cliente conhecida, a ferramenta de linha de comando mysql.exe com o Azure Cloud Shell. Como alternativa, use a linha de comando do mysql em seu ambiente local.
mysql -h mydemoserver.mysql.database.azure.com -u myadmin@mydemoserver -p
Limpar os recursos
Se não precisar desses recursos para outro início rápido/tutorial, você poderá excluí-los ao fazer o seguinte comando:
az group delete --name myresourcegroup
Se você quiser simplesmente excluir o servidor recém-criado, poderá executar o comando az mysql server delete.
az mysql server delete --resource-group myresourcegroup --name mydemoserver