Início Rápido: Conectar-se ao Banco de Dados do Azure para MySQL – Servidor Flexível usando a CLI do Azure

  • Artigo

APLICA-SE A: Banco de Dados do Azure para MySQL – Servidor flexível

Este início rápido demonstra como se conectar ao servidor flexível do Banco de Dados do Azure para MySQL usando a CLI do Azure com az mysql flexible-server connect e executar uma única consulta ou arquivo SQL com o comando az mysql flexible-server execute. Esse comando permitirá testar a conectividade com o servidor de banco de dados e executar consultas. Também será possível executar várias consultas usando um modo interativo.

Pré-requisitos

  • Uma conta do Azure com uma assinatura ativa.

    Caso você não tenha uma assinatura do Azure, crie uma conta gratuita do Azure antes de começar. Atualmente, com uma conta gratuita do Azure, você pode experimentar o Banco de Dados do Azure para MySQL com Servidor Flexível gratuitamente por 12 meses. Para obter mais informações, veja Experimente o Banco de Dados do Azure para MySQL – Servidor Flexível gratuitamente.

  • Instalar a versão mais recente da CLI do Azure (2.20.0 ou superior)

  • Fazer logon usando a CLI do Azure com o comando az login

  • Ativar a persistência de parâmetro usando o comando az config param-persist on. A persistência de parâmetros ajuda você a usar o contexto local sem precisar repetir vários argumentos, como o grupo de recursos ou a localização.

Criar um servidor flexível do MySQL

A primeira coisa a ser criada é uma instância gerenciada de servidor flexível do Banco de Dados do Azure para MySQL. No Azure Cloud Shell, execute o script a seguir e anote o nome do servidor, o nome de usuário e a senha gerados desse comando.

az mysql flexible-server create --public-access <your-ip-address>

É possível fornecer argumentos adicionais para esse comando a fim de personalizá-lo. Confira todos os argumentos do comando az mysql flexible-server create.

Criar um banco de dados

Execute o seguinte comando para criar um banco de dados, newdatabase se você ainda não tiver criado um.

az mysql flexible-server db create -d newdatabase

Exibir todos os argumentos

É possível exibir todos os argumentos desse comando usando o argumento --help.

az mysql flexible-server connect --help

Testar a conexão do servidor de banco de dados

Execute o script abaixo para testar e validar a conexão com o banco de dados do ambiente de desenvolvimento.

az mysql flexible-server connect -n <servername> -u <username> -p <password> -d <databasename>

Exemplo:

az mysql flexible-server connect -n mysqldemoserver1 -u dbuser -p "dbpassword" -d newdatabase

Será possível conferir a seguinte saída de uma conexão com êxito:

Command group 'mysql flexible-server' is in preview and under development. Reference and support levels: https://aka.ms/CLI_refstatus
Connecting to newdatabase database.
Successfully connected to mysqldemoserver1.

Caso haja falha na conexão, tente usar estas soluções:

  • Verifique se a porta 3306 está aberta no computador cliente.
  • Verifique se o nome de usuário e a senha do administrador do servidor estão corretos
  • Verifique se a regra de firewall foi configurada para o computador cliente
  • Caso tenha configurado o servidor com acesso privado na rede virtual, verifique se o computador cliente está na mesma rede virtual.

Executar várias consultas usando um modo interativo

É possível executar várias consultas usando um modo interativo. Execute o comando a seguir para habilitar o modo interativo

az mysql flexible-server connect -n <server-name> -u <username> -p <password> --interactive

Exemplo:

az mysql flexible-server connect -n mysqldemoserver1 -u dbuser -p "dbpassword" -d newdatabase --interactive

Você pode ver a experiência do shell do MySQL como mostrado abaixo:

Command group 'mysql flexible-server' is in preview and under development. Reference and support levels: https://aka.ms/CLI_refstatus
Password:
mysql 5.7.29-log
mycli 1.22.2
Chat: https://gitter.im/dbcli/mycli
Mail: https://groups.google.com/forum/#!forum/mycli-users
Home: http://mycli.net
Thanks to the contributor - Martijn Engler
newdatabase> CREATE TABLE table1 (id int NOT NULL, val int,txt varchar(200));
Query OK, 0 rows affected
Time: 2.290s
newdatabase1> INSERT INTO table1 values (1,100,'text1');
Query OK, 1 row affected
Time: 0.199s
newdatabase1> SELECT * FROM table1;
+----+-----+-------+
| id | val | txt   |
+----+-----+-------+
| 1  | 100 | text1 |
+----+-----+-------+
1 row in set
Time: 0.149s
newdatabase>exit;
Goodbye!

Executar uma consulta única

Execute o comando a seguir para executar uma consulta única usando o argumento --querytext, -q.

az mysql flexible-server execute -n <server-name> -u <username> -p "<password>" -d <database-name> --querytext "<query text>"

Exemplo:

az mysql flexible-server execute -n mysqldemoserver1 -u dbuser -p "dbpassword" -d newdatabase -q "select * from table1;" --output table

Você pode ver uma saída como mostrado abaixo:

Command group 'mysql flexible-server' is in preview and under development. Reference and support levels: https://aka.ms/CLI_refstatus
Successfully connected to mysqldemoserver1.
Ran Database Query: 'select * from table1;'
Retrieving first 30 rows of query output, if applicable.
Closed the connection to mysqldemoserver1
Txt    Val
-----  -----
test   200
test   200
test   200
test   200
test   200
test   200
test   200

Executar arquivo SQL

É possível executar um arquivo SQL usando o comando com o argumento --file-path, -q.

az mysql flexible-server execute -n <server-name> -u <username> -p "<password>" -d <database-name> --file-path "<file-path>"

Exemplo:

az mysql flexible-server execute -n mysqldemoserver -u dbuser -p "dbpassword" -d flexibleserverdb -f "./test.sql"

Você pode ver uma saída como mostrado abaixo:

Command group 'mysql flexible-server' is in preview and under development. Reference and support levels: https://aka.ms/CLI_refstatus
Running sql file '.\test.sql'...
Successfully executed the file.
Closed the connection to mysqldemoserver.

Próximas etapas